History of the document

Version Date Comment
3.15 04/09/2017

Modification of the expiry of transactions: from now on, it depends on the authorization validity period.

Data dictionary
  • Update of the definition of "ans"
  • Update of the vads_action_mode field: the webview value was deleted
3.14 17/07/2017
Data dictionary
  • Format corrected for the field vads_cust_address_number
  • Update of the vads_sub_init_amount and vads_sub_amount fields
  • Update of the vads_theme_config field
3.13 06/06/2017 Data dictionary
  • Correction of the format of the fields vads_url_cancel,vads_url_error, vads_url_refused and vads_url_success (up to 1025 alphanumeric and special characters)
  • Addition of the fields vads_first_installment_delay, vads_card_holder_name, vads_proof_of_id_type and vads_proof_of_id_number
  • Update of the vads_acquirer_transient_data field
  • Correction of the format of the vads_order_id field
  • vads_url_check_src: addition of the BATCH value and its description
  • vads_payment_cards: addition of the values VPAY, FULLCB3X and FULLCB4X
3.12 03/04/2017

Data dictionary

  • vads_action_mode: addition of the values WEBVIEW and IFRAME
  • vads_theme_config: addition of the value MODE_IFRAME
  • vads_currency: addition of precisions concerning currencies
  • addition of vads_acquirer_transient_data
3.11 27/02/2017
  • Chapter Managing errors: Addition of precisions concerning error codes
  • Chapter Viewing parameters sorted by category: Addition of the Error Code column to the tables
Data dictionary
  • new field: vads_authent_paypal_protection_eligibility
  • vads_currency: addition of the alpha encoding in tables

    Removal of the Icelandic Crown (ISK), update and addition of precisions concerning the currencies

3.10 30/01/2017
  • vads_bank_product: Addition of new values for MasterCard cards
  • Addition of the field vads_effective_currency
  • Modification of the AMEX network by AMEXGLOBAL network as a result of migration
3.9 14/09/2016
  • vads_payment_cards: addition of the MASTERPASS value
  • vads_product_label: correction of the format
3.8 16/08/2016


  • Value of vads_trans_status: CANCELLED instead of CANCELED
  • Value of vads_risk_control: COMMERCIAL_CARD instead of CARD_COMMERCIAL
  • vads_url_check_src: addition of the value VOICE_ORDER
  • Addition of the note on MULTI_EXT in vads_capture_delay and vads_payment_config
  • vads_contracts: network additions and improvements on the definition of the MID
3.7 05/2016

Chapter improvements:

  • Transmitting order details
  • Activating the automatic retry.
Data dictionary
  • vads_payment_cards: addition of new values.
  • vads_theme_config: addition of the values MERCHANT_MESSAGE, RESPONSIVE_MODEL and RESPONSIVE_MAIL_MODEL.
  • vads_ship_to_speed: addition of the PRIORITY value
  • vads_ship_to_delay: new field.
3.6 01/02/2016

Data dictionary

  • vads_auth_result: addition of the AMEX values
  • vads_currency: precisions added for multi-currency management
  • vads_payment_cards: addition of the values EDENRED_TR (Ticket Restaurant) and EDENRED_EC (Ticket EcoChèque)
3.5 23/11/2015

Data dictionary

  • vads_payment_cards and vads_contracts: addition of values
  • Specifications to field formats:
    • vads_cust_address
    • vads_ship_to_street
    • vads_ship_to_street2
  • vads_trans_status: addition of the INITIAL status to the list of possible values.
  • vads_change_rate
  • vads_recurrence_number
3.4 01/10/2015 Data dictionary
  • Format corrected for the field vads_product_labelN
  • Correction of the vads_product_vatN field name
  • Field added:
    • vads_cust_national_id
3.3a 24/07/2015 Chapters added
  • Setting up a notification on batch change

Chapters updated:

  • Using i-frames
  • vads_trans_id
3.3 07/07/2015

Chapters added

  • Configuring e-mails sent to the buyer.
  • Configuring e-mails sent to the merchant.

Additional information about using i-frames.

Data dictionary

  • Fields added:
    • vads_trans_uuid
    • vads_risk_assessment_result
    • vads_product_vatN
  • vads_bank_product : values added for pure CB cards.
  • vads_risk_analyzis_result : values added.
  • vads_payment_cards : values added.
3.2 27/04/2015 Data dictionary

Correction of an error for the vads_ship_to_type field

3.1 02/03/2015

Server URL renamed to Instant Payment Notification URL

Chapters added

  • Managing the shop settings via a configuration file
  • Activating the automatic retry
  • Manual retry of the notification

Additional information about using iframes.

Data dictionary

  • Fields added:
    • vads_payment_seq
    • vads_cust_legal_name
    • vads_ship_to_legal_name
  • E_CV value added to the list of payment methods (ANCV network)
  • Precisions on the vads_url_check field
3.0 21/11/2014 Complete overhaul of documentation.

This document and its contents are confidential. It is not legally binding. No part of this document may be reproduced and/or forwarded in whole or in part to a third party without the prior written consent of Lyra Network. All rights reserved.