• France
status page
Merchant Back Office
assistance
FAQContact support
Search
Categories
Tags
English
French
English
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
Logos
Push mail
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

History of the document

Version Author Date Comment
3.15 BPCE Payment Services 5/19/2023
  • Update of the Presentation of the service chapter.
3.14.2 BPCE Payment Services 9/20/2022
  • Update of the Presentation of the service chapter
  • Update the description of the vads_risk_assessment_result field values in the Processing the response data chapter.
3.14.1 BPCE Payment Services 5/25/2022
  • Added clarification on the amount of authentication in the different use cases.
3.14 BPCE Payment Services 4/26/2022
  • Added chapter Suggesting additional payment attempts.
  • Added chapter Chaining of CIT/MIT transactions.
  • Added the currency in the parameters to be transmitted when creating a token without payment.
  • Updated use cases for displaying transaction chaining.
  • Update of the chapter Compatible payment methods.
  • Addition of vads_initial_issuer_transaction_identifier fields in the Processing the response data chapter.
3.13 BPCE Payment Services 2/10/2022
  • Update of the chapter Compatible payment methods.
  • Update of chapters Creating a token without payment, Creating a token during a payment, Creating a token during a recurring payment and Creating a token upon the creation of a subscription with payment.
  • Update of Lifecycle of a recurring payment chapter.
3.12 BPCE Payment Services 10/12/2021
  • Update of the vads_sub_effect_date field description.
3.11 BPCE Payment Services 3/1/2021
  • Addition of the vads_occurrence_type field in the Lifecycle of a recurring payment chapter.
  • Addition of fields describing the recurrence in the chapters related to the notification upon the creation of a recurring payment.
  • Addition of the Installment payment chapter.
  • Update of the Payment by token chapter: the CVV entry and cardholder authentication are required.
  • Update of the chapters related to token creation: the cardholder must undergo strong authentication.
3.10 BPCE Payment Services 1/18/2021
  • Update of the Presentation of the service chapter.
  • Addition of the Uniqueness of registered payment methods chapter.
  • Clarification on daily recurrences added to chapters related to recurring payment creation.
  • Update of the chapter Compatible payment methods.
  • Update of the chapter Automatically canceling a recurring payment via Web Services.
  • Addition of the Test cards chapter in the appendix.
3.9 BPCE Payment Services 5/5/2020
  • Additional information on the attempts made by the payment gateway in case of activation of anticipated authorizations.
  • Additional details on payment creation in case of an expired payment method or purged payment data.
  • Update of notification rule configuration.
3.8 BPCE Payment Services 10/21/2019
  • Update of compatible payment methods.
  • Addition of a chapter on the payment guarantee during a payment by token.
  • Update of the description of the vads_sub_desc field in the Generating a payment form chapter.
3.7 BPCE Payment Services 8/5/2019
  • The hash algorithm is now available via Settings > Shop, Keys tab.
  • Addition of the vads_identifier field as an input parameter when creating a token.
  • Addition of the Risk analysis details category in the Data dictionary.
  • vads_threeds_auth_type: the field is always present in the response and can be empty.
  • The hash algorithm is now available via Settings > Shop, Keys tab.
  • Additional information provided on the computation of the IPN signature.
  • Additional information provided on the format of the vads_trans_date and vads_presentation_date fields.
  • Additional information provided on the format of the fields: vads_product_label, vads_cust_zip, vads_order_id, vads_cust_first_name, vads_cust_last_name, vads_cust_phone, vads_cust_cell_phone, vads_cust_id, vads_cust_city, vads_cust_address.
  • vads_auth_result: correction of field format (an..11)
  • vads_contracts: Possibility to force the to be used.
3.6 BPCE Payment Services 5/22/2019

Clarifications provided on the methods of creation and termination of recurring payments via web services Terminal ID

Data dictionary: update of vads_trans_date.

3.5 BPCE Payment Services 3/26/2019
  • Addition of a note on token creation via the Merchant Back Office
  • Addition of a clarification on data deletion in the chapter Managing payments by identifier.
  • Addition of the time of recurring payment creation in the chapter Managing payments by identifier.
  • Update of screenshots in chapters Creating a token in Test mode and Creating a token in Production mode.
  • Update of screenshots in Creating a recurring payment via the Merchant Back Office
  • Addition of the chapter Defining the currency for creating or updating a token.
  • Update of the table of parameters in the chapter Creating a “Payment with the token creation option for the cardholder” form.
  • Data dictionary:
    • Clarification added about the format of the vads_product_qty field.
    • Addition of the vads_presentation_date field in the Transaction details section.
    • Clarification added about the format of the vads_identifier field.
    • Clarification added about the format of the vads_subscription field.
    • Removal of the fields vads_ext_info_donation, vads_ext_info_donation_recipient, vads_ext_info_donation_recipient_name, vads_ext_info_donation_merchant, vads_ext_info_donation_contribution and vads_risk_primary_warranty.
3.4.1 BPCE Payment Services 3/19/2019
  • Creation of a “Verification” transaction when requesting an update or creating tokens without payment via the Merchant Back Office.
  • New value for the vads_trans_status : ACCEPTED field.
  • New value for the vads_operation_type field: VERIFICATION
3.4 BPCE Payment Services 1/14/2019
Addition of chapters:
  • Creating a token in Test mode via the Merchant Back Office
  • Creating a token via the Merchant Back Office
  • Payment with the token creation option for the cardholder
  • Creating a 'Payment with option for the cardholder to create a token’ form
  • Redraft of chapter Analyzing the payment result.
  • Data dictionary:
    • Addition of the vads_bank_label field.
    • Addition of the vads_tax_rate field.
    • Addition of the vads_pretax_amount field.
    • Addition of the vads_totalamount_vat field.
    • Addition of the vads_wallet field.
    • Update of the vads_ship_to_legal_name field description.
    • Update of the vads_payment_src field description.
    • Update of the values in the vads_bank_product field.
    • Update of the vads_tax_amount field description.

This document and its contents are confidential. It is not legally binding. Any reproduction and / or distribution of all or part of this document or its content to a third party is strictly prohibited or subject to prior written authorization from BPCE Payment Services. All rights reserved.
© 2025 {'|'} All rights reserved to Systempaylegal
25.25.0-1.11