Processing the response data

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

  1. Identify the mode (TEST or PRODUCTION) that was used for creating the transaction by analyzing the value of the vads_ctx_mode field.
  2. Identify the order by retrieving the value of the vads_order_id field if you have transmitted it to the payment gateway.
    Make sure that the order status has not already been updated.
  3. Retrieve the payment result transmitted in the vads_trans_status field.
    Its value allows you to define the order status.
    Table 1. Values associated with the vads_trans_status field
    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.

    AUTHORISED

    Waiting for capture

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

    CANCELLED

    Canceled

    The transaction has been canceled by the merchant.

    CAPTURED

    Sent

    The transaction has been captured by the bank.

    REFUSED

    Declined

    Transaction is declined.

    SUSPENDED Suspended

    The capture of the transaction is temporarily blocked by the acquirer (AMEX GLOBAL or SECURE TRADING). Once the transaction has been correctly captured, its status changes to CAPTURED.

  4. Retrieve the payment reference transmitted in the vads_trans_id field.
  5. Retrieve the value of the vads_trans_date field to identify the payment date.
  6. Retrieve the value of the vads_capture_delay field to identify the number of days before the capture in the bank.
    It will allow you to identify whether the payment is an immediate or a deferred payment.
  7. Retrieve the used amount and currency. To do this, retrieve the values of the following fields:
    Table 2. Analysis of the payment amount and currency.
    Field name Description
    vads_amount Payment amount in the smallest currency unit.
    vads_currency Code of the currency used for the payment.
  8. Retrieve the value of the vads_auth_result field to identify the result of the authorization request.
    The complete list of returned codes can be viewed in the Data Dictionary.
  9. Retrieve the 3D Secure authentication result. To do this:
    1. Retrieve the value of the vads_threeds_enrolled field to identify the status of the card enrollment.
      Table 3. Values of the vads_threeds_enrolled field
      Value Description
      Empty The 3DS authentication is not accomplished (3DS disabled in the request, the merchant is not enrolled or 3DS is not available for the payment method).
      Y Authentication available, cardholder enrolled.
      N Cardholder not enrolled.
      U Impossible to identify the cardholder or authentication is not available for the card (e.g. corporate or prepaid credit cards).
    2. Retrieve the result of 3D Secure authentication by retrieving the value of the vads_threeds_status field.
      Table 4. Values of the vads_threeds_status field
      Value Description
      Empty The 3DS authentication is not accomplished (3DS disabled in the request, the cardholder is not enrolled or 3DS is not available for the payment method).
      Y Cardholder successfully authenticated.
      N Cardholder authentication error.
      U Authentication impossible.
      A Authentication attempted but not accomplished.
  10. Retrieve the result of fraud checks by identifying the value of the vads_risk_control field. This field is sent only if the merchant has:
    • subscribed to the "Risk management" service
    • enabled at least one verification process in the Merchant Back Office (Settings > Risk management menu).
    It is populated with the list of values separated by ";" with the following syntax: vads_risk_control = control1=result1;control2=result2
    the possible values for control are:
    Table 5. List of fraud verification processes
    Value Description
    CARD_FRAUD Verifies whether the cardholder's card number is in the card greylist.
    SUSPECT_COUNTRY Verifies whether the cardholder's card number is in the list of forbidden countries.
    IP_FRAUD Verifies whether the cardholder's IP address is in the IP greylist.
    CREDIT_LIMIT Verifies the purchase frequency and amounts for the same card number, or the maximum amount of an order.
    BIN_FRAUD Verifies whether the BIN code of the card is in the greylist for BIN codes.
    COMMERCIAL_CARD Verifies whether the buyer's card is a corporate credit card.
    SYSTEMATIC_AUTO Verifies whether the buyer's card is a MAESTRO or VISA ELECTRON credit card.
    INCONSISTENT_COUNTRIES Verifies whether the country of the IP address, the country of the payment card and the country of residence of the buyer match.
    SUSPECT_IP_COUNTRY Checks whether the buyer’s country, identified by their IP address, is on the list of forbidden countries.
    The possible values for result are:
    Table 6. List of fraud verification processes
    Value Description
    OK OK.
    WARNING Informational control failed.
    ERROR Blocking control failed.
  11. Retrieve the type of the card used for the payment.
    Table 7. Analysis of the card used for the payment
    Field name Description
    vads_card_brand Brand of the card used for the payment. e.g.: VISA, VISA_ELECTRON, MASTERCARD, MAESTRO, VPAY
    vads_card_number Card number 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_product Product code of the card
    vads_card_country Country code of the country where the card was issued (alpha ISO 3166-2 code, e.g.: "IN" for India, "US" for the United States).
  12. Save the value of the vads_trans_uuid field. It will allow you to identify uniquely the transaction if you use the Web Services APIs.
  13. 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.
  14. Proceed to order update.