Processing the response data
Here is an example of analysis to guide you through processing the response data.
- Identify the mode (TEST or PRODUCTION) in which the transaction was created by analyzing the value of the vads_ctx_mode field.
- Identify the order by retrieving the value ofvads_order_idif you have included it in the payment form. Make sure that the order status has not been updated yet.
- Analyze the operation type transmitted in the fieldvads_operation_type.
Value Description DEBIT Debit transaction. CREDIT Refund. VERIFICATION Payment method verification. - Retrieve the payment result transmitted in the fieldvads_trans_status. Its value allows you to define the order status.
Value Description ABANDONED Abandoned Payment abandoned by the buyer.
The transaction has not been created and therefore cannot be viewed in the Merchant Back Office.
ACCEPTED Accepted. Status of a VERIFICATIONtransaction for which the authorization or information request has been accepted.
This status cannot change.
Transactions with the “ACCEPTED” status are never captured in the bank.
AUTHORISED Waiting for capture
The transaction has been accepted and will be automatically captured at the bank on the expected date.
AUTHORISED_TO_VALIDATE To be validated
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 toEXPIRED. The Expired status is final.
CANCELLED Cancelled
The transaction has been canceled by the merchant.
CAPTURED Captured
The transaction has been captured by the bank.
EXPIRED Expired
This status appears in the lifecycle of a payment with deferred capture.
The expiry date of the authorization request has passed and the merchant has not validated the transaction. The cardholder’s account will therefore not be debited.
REFUSED Refused
Transaction is refused.
WAITING_AUTHORISATION Waiting for authorization The capture delay in the bank exceeds the authorization validity period.
An information request (or an authorization request for EUR 1 if the acquirer does not support information requests) has been accepted.
An authorization request for the total amount will be made one day before the requested capture date.
The transaction is automatically captured by the bank.
WAITING_AUTHORISATION_TO_VALIDATE To be validated and authorized
The capture delay at the bank exceeds the authorization validity period.
A 100 XPF (or information request about the CB network if the acquirer supports it) authorization has been accepted.The merchant must manually validate the transaction for the authorization request and the capture to occur.
- Analyze the fieldvads_occurrence_typeto determine if it is a single payment or a payment that is part of a series (subscription or installment payment).
Value Description UNITAIRE Single payment (immediate payment). RECURRENT_INITIAL First payment of a series. RECURRENT_INTERMEDIAIRE Nth payment of a series. RECURRENT_FINAL Last payment of a series. - Analyze the fieldvads_payment_configto determine whether it is an installment payment. For a payment in installments, identify the installment number by retrieving the value of the fieldvads_sequence_number.
Field name Value for an immediate payment Value for a payment in installments vads_payment_config SINGLE MULTI (The exact syntax isMULTI:first=X;count=Y;period=Z)
- Retrieve the value of the fieldvads_trans_dateto identify the payment date.
- Retrieve the value of the fieldvads_capture_delayto identify the number of days before the payment is captured by the bank. It will allow you to identify whether the payment is an immediate or a deferred payment.
- Retrieve the applied 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 applied for the payment. Set to 953. - Retrieve the value of the fieldvads_auth_resultto know the result of the authorization request.
- Retrieve the cardholder authentication result. To do this:
- Retrieve the value of the fieldvads_threeds_enrolledto determine the enrollment status of the card. By default, all OSB proprietary cards are eligible for cardholder authentication.
Value Description Empty Incomplete 3DS authentication process (3DS disabled in the request, the merchant is not enrolled or the payment method is not eligible for 3DS). Y Authentication available, cardholder enrolled. N Cardholder not enrolled. U The cardholder could not be identified. - Retrieve the result of cardholder authentication by retrieving the value of the fieldvads_threeds_status.
Value Description Empty Authentication of cardholder not carried out. Y Cardholder authentication success. N Cardholder authentication error. U Authentication impossible. A Authentication attempted but not completed.
- Retrieve the value of the fieldvads_threeds_enrolledto determine the enrollment status of the card. By default, all OSB proprietary cards are eligible for cardholder authentication.
- Retrieve the card data used for payment.
Field name Description vads_card_brand Brand of the card used for the payment: - PRV_BDP: Bank of Polynesia card.
- PRV_BDT: Bank of Tahiti card.
- PRV_OPT: MARARA card.
- PRV_SOC: Socredo card.
- PRV_SMART_CARD: Smart Card card.
vads_acquirer_network Acquirer network code. Set to OSB_PRIV. vads_card_number Masked number of the card used for the payment. vads_expiry_month Expiry month between 1 and 12 (e.g.: 3 for March, 10 for October). vads_expiry_year Expiry year in 4 digits (e.g.: 2023). vads_bank_code Code of the issuing bank. vads_bank_label Name of the issuing bank. vads_card_country Code of the card issuing country (Alpha ISO 3166-2, e.g.:"FR"France,"PF"French Polynesia,"NC"New Caledonia, "US"United States). - Retrieve the unique payment reference generated by the payment gateway transmitted in the fieldvads_trans_uuid.
- 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.
- Proceed to order update.