Secure-eBook

Secure-eBook Documentation

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:

NameTypeDescription
codetextLowercase md5 hash of the token and your Secure-eBook SDK key

Message Template

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