Processing the response data
- Identify the order by retrieving the value of the vads_order_id field if you have transmitted it in the payment form. Make sure that the order status has not been updated yet.
- Retrieve the payment result transmitted in the vads_trans_status field. Its value allows you to define the order status.
VALUE DESCRIPTION AUTHORISED Validated
The transaction has been accepted and will be automatically captured at the bank on the expected date.
AUTHORISED_TO_VALIDATE Manual review The transaction, created with manual validation, is authorized. The Merchant must manually validate the transaction in order for it to be captured.
The transaction can be validated as long as the expiration date of the authorization request has not passed. If the authorization validity period has passed, the payment status changes to EXPIRED. The Expired status is final.
CANCELLED Canceled
The payment has been canceled by the merchant.
EXPIRED Expired The expiry date of the authorization request has passed and the Merchant has not validated the transaction. The account of the cardholder will therefore not be debited.
REFUSED Refused
The transaction is refused.
See the following chapter to obtain more information on the rejected payment.
- Retrieve the unique reference of the transaction transmitted in the vads_trans_uuid field.
- Retrieve the transaction reference transmitted in the vads_ext_trans_id field.
- Retrieve the value of the vads_trans_date field to identify the payment date.
- Retrieve the used amount and currency. To do this, retrieve the values of the following fields:
Field name Description vads_amount Payment amount in the smallest currency unit. vads_currency Code of the currency used for the payment. - Retrieve the payment method used in the wallet by analyzing the vads_card_brand field.
- You can record the used payment wallet type by retrieving the value of the vads_wallet field.
Value Wallet type APPLE_PAY Apple Pay - Retrieve all the order, buyer and shipping details. These details will be provided in the response only of they have been transmitted in the payment form.Their values are identical to the ones submitted in the form.
- Retrieve Apple Pay authentication details:
Field name Description vads_threeds_cavv Unique identifier generated by the authentication server and proving that the transaction has been authenticated. E.g.: E6KUE9AF08ngABUBNAADcwAAAAA=
vads_threeds_cavvAlgorithm Cardholder authentication method.
Possible values:00: No authentication
01: Replayable password (date of birth, password, zip code, ...)
02: Phone OTP (SMS, SVI, Token, ...)
03: OTP on secure element Software (SEA, ...)
04: OTP on secure element Hardware (CAP, SIM, ...)
vads_threeds_exit_status Reason for authentication request. Possible values:- 01: No additional authentication required (1st use)
- 02: The risk management engine requires additional authentication (1st use)
- 03: The risk management engine is unavailable (1st use)
- 11: No additional authentication required
- 12: The risk management engine requires additional authentication
- 13: The risk management engine is unavailable
vads_threeds_xid Transaction ID generated by the authentication server. E.g.: MDM4MzIgICAgICAgICAgICAgICA=
- The status of the payment guarantee is transmitted in the field vads_warranty_result.
- Proceed to order update.