LCN read receipt response for 2Checkout
To validate the success of the notification process insert an inline response in the script output of your LCN listener. Once 2Checkout validates the response it considers the LCN successful. Otherwise, 2Checkout continues to send notifications per the failure recovery process until you provide a valid response.
Read receipt response for 2Checkout
To validate the fact that you received a LCN notification, return an inline response anywhere in the document (in the script output), in the following format:
<EPAYMENT>DATE|HASH</EPAYMENT>
The parameters are as follows:
Parameters | |
---|---|
DATE |
Date in the YmdGis format. (20081117145935) |
HASH |
HMAC_MD5 signature calculated using the secret key for your account and the values received for : • LICENSE_CODE
Create the hash using only these three parameters, and not all the parameters you receive as part of the LCN message. |
HMAC_MD5 signature
Access http://www.ietf.org/ rfc/rfc2104.txt for a description of the HMAC_MD5 algorithm.
Field name |
Field length |
Field value |
---|---|---|
FIRSTNAME |
4 |
John |
LASTNAME |
5 |
Smith |
COMPANY |
0 |
|
|
19 |
|
PHONE |
12 |
951-121-2121 |
FAX |
0 |
|
COUNTRY |
24 |
United States of America |
STATE |
8 |
New York |
CITY |
8 |
New York |
ADDRESS |
15 |
101 Main Street |
LICENSE_CODE |
10 |
3C343D0FAF |
EXPIRATION_DATE |
10 |
2005-03-03 |
STATUS |
8 |
DISABLED |
Considering a LCN containing all the information above, you only need the LICENSE_CODE, EXPIRATION_DATE and DATE (this is the date when your script receives the LCN message) to create the response. Calculate the signature for the above data received in LCN and create inline response:
DATE |
20081117145935. This is the date when your script receives the LCN message. |
HMAC_MD5 source string |
103C343D0FAF102005-03-031420081117145935 |
Secret key |
AABBCCDDEEFF |
HMAC_MD5 signature |
cb34fe2991668eb82364edf62f845a34 |
Inline response |
<EPAYMENT>20081117145935|cb34fe2991668eb82364edf62f845a34</EPAYMENT> |
Requirements
- Do not include HASH in the string needed for calculating the HMAC_MD5 signature.
- Use the variables in the same order as described above when putting together the string used for the HASH signature.
- To create the HMAC_MD5 source string, prefix each value with its own length in bytes (for UTF-8 characters the length in bytes might be longer that the string length).
- HASH fields values are case insensitive.
- Output the inline response anywhere in the page receiving the notification.