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 if you have transmitted it in the payment form.
    Make sure that the order status has not been updated yet.
  2. Retrieve the payment result transmitted in the vads_trans_status field.
    Its value allows you to define the order status.
    VALUE DESCRIPTION
    CAPTURED

    Captured

    The merchant has requested the creation of an immediate payment.

    The transaction has been captured by the bank.

    AUTHORISED

    Waiting for capture

    The merchant has requested the creation of a deferred payment.

    The transaction has been captured by the bank.

    REFUSED

    Declined

    The transaction is refused.

    See the following chapter to obtain more information on the rejected payment.

    WAITING_AUTHORISATION Waiting for authorization

    The merchant has requested the creation of a payment deferred by more than 3 days.

    AUTHORISED_TO_VALIDATE To be validated and authorized

    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.

    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.

    UNDER_VERIFICATION

    Control in progress

    For PayPal transactions, this value means that PayPal withholds the transaction for suspected fraud.

    The payment will remain in the Transactions in progress tab until the verification process has been completed. The transaction will then take one of the following statuses: AUTHORISED or CANCELED.

    A notification will be sent to the merchant to warn them about the status change (Instant Payment Notification on batch change).

  3. Retrieve the payment reference transmitted in the vads_trans_id field.
  4. Retrieve the value of the vads_trans_date field to identify the payment date.
  5. Retrieve the used amount and currency. To do this, retrieve the values of the following fields:
    Table 1. Analysis of the payment amount and currency
    Field name Description
    vads_amount Payment amount in the smallest currency unit.
    vads_currency Numeric code of the currency used for the payment.
    vads_change_rate Exchange rate used to calculate the effective payment amount (see vads_effective_amount).
    vads_effective_amount Payment amount in the currency used for the capture in the bank.
    vads_effective_currency Numeric code of the currency that will be used for the capture at the bank.
  6. Retrieve the used payment method by analyzing the vads_card_brand field.
  7. 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.
  8. Store the value of the vads_authent_paypal_protection_eligibility field to identify the protection type used for the transaction.
    Three values are possible:
    • ELIGIBLE
      Merchant is protected by PayPal's Seller Protection Policy for unauthorized payments and Item Not Received.
    • PARTIALLY_ELIGIBLE
      Merchant is protected by PayPal's Seller Protection Policy for Item Not Received.
    • INELIGIBLE
      Merchant is not protected by PayPal's Seller Protection Policy for Item Not Received.
  9. Proceed to order update.