Updating information associated with the token

In order to understand the result, analyze the following fields:

Field name Description
vads_page_action Action complete.

The returned value is REGISTER_UPDATE.

vads_identifier_status Token update status.

The possible values are:

  • UPDATED: the token has been successfully updated.
  • NOT_UPDATED: the token has not been updated.
  • ABANDONED: action abandoned by the buyer.

    The token has not been created and does not appear in the Merchant Back Office.

vads_identifier The token identifier to be updated.

The returned value is the same as the one transmitted in the request.

vads_cust_email Buyer’s e-mail address transmitted in the request.
vads_site_id Shop ID

The returned value is the same as the one submitted in the form.

vads_ctx_mode Operating mode.

The returned value (TEST or PRODUCTION) is the same as the one submitted in the form.

A “token update” request triggers the creation of a VERIFICATION type transaction, visible in the Back Office.

The purpose of this transaction is to help the merchant understand, via their Back Office, the reasons for refusal of token creation.

Here are its characteristics:

Field name Description
vads_operation_type Transaction type

Its value is VERIFICATION.

vads_trans_status Transaction status.

The possible values are:

  • ACCEPTED

    The authorization or information request has been accepted.

    The token has been created and can be viewed in the Merchant Back Office.

  • REFUSED

    The authorization or information request has been declined.

    The token is not created.

vads_amount
Possible values:
  • 0 if the acquirer supports information requests,
  • if not, 100.
vads_trans_id Transaction identifier.

Its value is generated by the payment gateway.

vads_trans_uuid Unique transaction ID.

Its value is generated by the payment gateway.

vads_auth_mode

Type of request made via authorization servers.

Its value is MARK.
vads_auth_number Authorization number returned by the authorization server.

Empty if the authorization has failed.

vads_auth_result Return code of the authorization request returned by the issuing bank.

See chapter Managing the return codes of the authorization request.

Empty if the error occurred before the authorization.

vads_risk_assessment_result

List of actions performed for the transaction, following the activation of the advanced risk assessment rules.

The rules related to the amount, or whose action is “Validate manually”, do not apply in case of a VERIFICATION type transaction.

The possible values are:

  • ENABLE_3DS: 3D Secure enabled.
  • DISABLE_3DS: 3D Secure disabled.
  • REFUSE: The token creation request is rejected.
  • RUN_RISK_ANALYSIS: Result of the external risk analyzer.

    See the description of the vads_risk_analysis_result field for more information.

  • INFORM: A warning message appears.

    The merchant is notified that a risk has been identified via one or several notification center rules.

Details of the used payment method.

Field name Note
vads_card_brand Used payment method.

See chapter Compatible payment methods to see the list of possible values.

vads_card_number Truncated/masked card number.
vads_expiry_month Expiry month of the used card.
vads_expiry_year Expiry year of the used card.
vads_brand_management

Allows to know the brand used for the payment, the list of available brands as well as whether the buyer has changed the brand chosen by the merchant.

vads_card_country Country code of the used card in compliance with the ISO 3166 standard.
vads_bank_label Name of the issuing bank of the used card.
vads_bank_product Product code of the used card.

Details of 3DS authentication
Field name Note
vads_threeds_enrolled

Enrollment status of the buyer to the 3D Secure program.

The possible values are:
  • Y: Authentication available.
  • N: Authentication not available.
  • U: Enrollment status to the 3D Secure program unknown.
  • empty: Incomplete 3DS authentication process (3DS disabled in the request, unregistered merchant or payment method not eligible for 3DS).
vads_threeds_status 3D Secure authentication result.
The possible values are:
  • Y: Cardholder authentication success.
  • N: Cardholder authentication error.
  • U: Authentication impossible.
  • A: Authentication attempted but not completed.
  • empty: Unauthorized 3DS authentication (3DS disabled in the request, unregistered cardholder or payment method not eligible for 3DS).

The optional fields transmitted in the request are returned in the response with unmodified values.

See the Data dictionary to know the parameters returned in the response for the following categories:

Order details Order details
Buyer details Buyer details
Shipping details Shipping details