====== Secure-eBook SDK : confirm ======

The **confirm** command confirms that you wish to proceed with the transaction.

This command allows you to confirm your identity to the Secure-eBook server by performing an alteration on the token you have been given through the **[[token]]** response of your previous **[[request]]** command.

If this command is successful, the transaction will be peformed, activation keys will be generated and tokens will be debited from your Secure-eBook account's token pool.

A **[[success]]** or **[[error]]** message will be returned.

===== Token transformation =====

You will need to append your **Secure-eBook SDK key** to the token returned through the **[[token]]** response of your previous **[[request]]** command.
You will then need to perform a MD5 hash on this string.
Return this whole string, **all in lowercase** through the **confirm** message.

In order for the transaction to be accepted, the following rules must be observed:
  * The confirm message must be received by the Secure-eBook server no more than 5 minutes after the **[[token]]** response has been sent.
  * The IP of the computer sending the **confirm** message must be the same IP from which was sent the **[[request]]** command.
  * The code sent by the **confirm** command must be a lowercase md5 hash of the concatenation of the //token// and your **Secure-eBook SDK key**

If any of these conditions are not met, the transaction will **not** take place, activation keys will **not** be generated and activations will **not** be taken from your Secure-eBook account's activation pool.

===== <confirm> =====

This is the root element of this XML message. 

Parameters:
^Name^Type^Description^
|code|text|Lowercase md5 hash of the //token// and your //Secure-eBook SDK key//|

===== Message Template =====

<code xml>
<?xml version="1.0"?>
<confirm code="[text]"/>
</code>