6.3. Handling of payment information

After the customer has paid for the order, they will be redirected to the address defined in the field RETURN_ADDRESS. If the payment was cancelled or unsuccessful, the customer will be directed to the address defined in the field CANCEL_ADDRESS.

The field NOTIFY_ADDRESS can also be used. This address is called automatically when Paytrail confirms the payment. Typically the notify address is called right before redirecting to the return address. However, it is possible that customer will not come back to Paytrail's service after the payment. In these cases the payment will be confirmed with a delay of one bank day when the notify address will be called by Paytrail. The call for notify address contains the same GET parameters that are used when redirecting to return address.

GET parameters used when redirecting to return and cancel addresses and when calling notify addresses are described below. The payment’s validity has to be checked using the GET parameters.

Table 6.5. Product rows

FieldInformationNameDescription
1.Order numberORDER_NUMBER This is the same order number that was sent to Paytrail by the sales channel. The order number will be used to individualize each payment.
2.TimestampTIMESTAMPTimestamp created by Paytrail. This is used for calculating the checksum. Timestamps are in UNIX format.
3.Payment signaturePAIDSignature created by Paytrail. This is returned only with a successful payment.
4.AuthenticationRETURN_AUTHCODE The checksum calculated by Paytrail. The sales channel can compare this against the checksum they have calculated. If the checksums match, payment information has been transferred correctly. The checksums may match even if the payment is cancelled or unsuccessful.

6.3.1. Calculating checksum

The checksum is calculated as follows:

1. Create a string by combining the field's order number, timestamp, payment signature and merchant certificate in this order. Insert a pipe character “|” between the fields. In case of an unsuccessful payment, the field payment signature will not be returned and it is not to be included in the string.

2. Calculate the checksum using an MD5 hash function on the created string.

3. The checksum is a 32-bit hexadecimal string. Replace lower case letters with uppercase letters.

6.3.2. Example of calculating the checksum

The checksum is calculated as described below.

Order number: 123456
Payment sign: F4SDGF23FS
Timestamp: 1176557554
Channel certificate: 12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678
Created string: 123456|1176557554|F4SDGF23FS|12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678

Calculated checksum in upper case: 7C597D787D71EFBBEC68275B5B9D13EF

If calculated checksum matches the value of RETURN_AUTHCODE, payment acknowledgment has arrived successfully.