Processing the response data

Here is an example of analysis to guide you through processing the response data.

  1. Identify the order by retrieving the value of the vads_order_id field.
    Make sure that the order status has not been updated yet.
  2. Retrieve the payment reference transmitted in the vads_trans_id field.
  3. Retrieve the value of the vads_trans_date field to identify the payment date.
  4. 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 Numeric code of the currency used for the payment.
  5. 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.
  6. Analyze the value of the vads_card_brand field:
    Its value allows to know if the amount has been paid in full with Chèque-Vacances Connect or if a complementary payment is required.
    VALUE DESCRIPTION
    MULTI

    Several payment methods have been used to complete the transaction.

    The list of payment methods used by the buyer can be found in the vads_payment_seq field (in the JSON format).

    For more information, see chapter Processing data specific to the response of a Chèque-Vacances Connect payment.

    CVCO Payment paid in full with Chèque-Vacances Connect.
  7. If the payment was made using only Chèque-Vacances Connect, retrieve the payment result transmitted in the vads_trans_status field.
    Its value allows you to define the order status.
    VALUE DESCRIPTION
    AUTHORISED

    The transaction has been accepted and will be automatically captured at the bank on the expected date.

    REFUSED

    Declined

    Transaction is declined.

    See the chapter Analyzing the result of the authorization request to obtain more information on the reason of payment rejection.

    ABANDONED Abandoned

    payment abandoned by the buyer.

    The transaction is visible in the Merchant Back Office.

  8. If the payment was made using several payment methods, see the following chapter with the vads_payment_seq field analysis.
  9. Proceed to order update.