Payment response

This field is returned for buy now, pay later payment methods in the result URL.

Returns the outcome of the payment. It can take one of the following values:

• AUTHORISED: The payment authorisation was successfully completed.
• REFUSED: The payment was refused. Payment authorisation was unsuccessful.
• CANCELLED: The payment was cancelled by the shopper before completion, or the shopper returned to the merchant's site before completing the transaction.
• PENDING: It is not possible to obtain the final status of the payment.
  This can happen if the systems providing final status information for the payment are unavailable, or if the shopper needs to take further action to complete the payment.
• ERROR: An error occurred during the payment processing.

merchantReturnData

If you define this field in the payment session setup, the value is returned as is. This information is useful to build a custom result page, and it integrates seamlessly with the shopper's session on your server.

When the payment status is defined, we send you a server-to-server notification. This notification is the recommended way to update the payment status in your back office. The notification system is more reliable in its delivery because the resultURL parameter relies on the shopper's browser/computer/Internet connection, any of which could fail at any time.

We recommend setting a fixed resultURL in the skin configuration. However, sometimes it may be preferable to set the result URL on a per-payment basis: to override the resultURL value specified in the skin configuration, you need to set the result URL for the payment session with the resURL parameter.

merchantSig

The signature in Base64 encoded format. It is generated by concatenating the values of payment session fields, and by computing the HMAC using the shared secret, as configured in the skin.
For more information, refer to HMAC signature calculation.

The payment method used in the transaction.

When authResult equals CANCELLED, the payment method may not be known – in this case, it is not included.

When authResult equals PENDING, ERROR or CANCELLED, the pspReference may not yet be known; therefore, it may be empty or not included.

If a shopper cancels a payment, this field returns a random number.

If the transaction results in an error, this field returns either of the possible following values:

• authentication_error
• format_error
• invalid_field
• invalid_request
• invalid_amount
• system_failure
• unknown_account
• unknown_error
• unknown_id

The shopperLocale value provided in the payment request.