![]() |
With the implementation of the second European Payment Services Directive (PSD2), banks were required to open their information systems. This has allowed new stakeholders and services to appear. One of them was payment initiation, also called transfer initiation. This payment service allows the merchant to initiate a credit transfer request sent to the buyer’s bank. The merchant is prompted to validate the transaction via their online banking space. The funds are then transferred via a classic SEPA Credit Transfer or SEPA Instant Credit Transfer, depending on the buyer’s choice. Depending on the country, some banks do not offer the SEPA Instant Credit Transfer (e.g: ING France). In this case, the request is processed as a classic SEPA transfer. In theory, the execution time of a SEPA Instant Credit Transfer is about 10s. Funds are available immediately via the merchant. Advantages for the merchant:
Advantages for the buyer:
|
![]() |
Supported currencies |
|
|
![]() |
Supported countries |
|
|
![]() |
Details information |
|
By default, only banks present in the country of the merchant’s company are suggested to the buyer.
Here is a list of available banks.
This list will be regularly updated following the evolution of the payment gateway.
|
|
| Technical code | Last names | Supported currencies | Supported countries | Authorization validity period (in days) | Payment process |
|---|---|---|---|---|---|
| IP_WIRE |
SEPA Credit Transfer |
EUR |
FR |
0 | Deferred capture |
| IP_WIRE_INST |
Instant SEPA Credit Transfer |
0 | Immediate capture |
| Sales channel | |
|---|---|
| e-commerce | |
| m-commerce | |
| MOTO payment | |
| Interactive Voice Server | |
| Payment order by e-mail/SMS | |
| Payment order by WhatsApp | |
| Operations with transactions | |
|---|---|
| Cancellation | |
| Refund | |
| Modification | |
| Validation | |
| Duplication | |
| Manual reconciliation | |
| Type of integration | |
|---|---|
| Redirection | |
| Iframe | |
| JavaScript Client | |
| Data collection form | |
| API Web Services | |
| Mobile SDK | |
| Back Office | |
| Payment type | |
|---|---|
| Immediate payment | |
| Deferred payment | |
| Payment in installments | |
| Payment by subscription | |
| Payment by file (token or batch) | |
| One-click payment | |
| Payment by wallet | |
| Miscellaneous | |
|---|---|
| Reporting | |
| Transaction settlement | |
| Chargeback settlement | |
| Extra payment attempts | |

The diagram below shows the evolution of a transaction status according to the technical statuses sent by the issuing bank.
The diagram also presents the notification rules to be activated in order to allow the merchant site to update the order status.
the payment details (Remittance Information) is a 140-character string consisting of:
:UUID:ORDER_ID:SOFT_DESCRIPTOR
:fcfd84b23fb84c01abc7508c8850872d:MyOrderId626958cb71991:DEMO STORE
without order ID in the query:
:0bb6f854baf94985ba567d4744014bf6::DEMO STORE
:fcfd84b23fb84c01abc7508c8850872d:MyOrderId626958cb71991:mystore.com
without order ID in the query:
:0bb6f854baf94985ba567d4744014bf6::mystore.com
The Merchant Back Office provides several types of notifications:
The notification is sent according to the event that takes place (payment accepted, abandonment by the buyer, cancellation by the merchant, etc.).
Instant Payment Notification URL failed
If the platform is unable to reach your URL, it sends an e-mail to the specified address.
Access to notification rules management

The payment gateway notifies on the merchant website in the following cases:
This notification is required to communicate the result of the payment request.
It informs the merchant website of the payment result even if your client has not clicked the Return to the shop button.
This rule notifies the merchant site when a transaction created with the temporary status WAITING_AUTHORIZATION is finally accepted or refused.
By default, no notifications are sent to the merchant website when an payment request is recorded and the buyer is redirected to his bank space (WAITING_FOR_PAYMENT transaction status).
However, if you want to be notified, you can create a specific notification rule.
Via the menu: Settings > Notification rules menu.
The interaction with the payment gateway is described in the Hosted Payment Page guide:
The merchant website and the payment gateway interact by exchanging data.
To create a payment, this data is sent in an HTML form via the buyer’s browser.
At the end of the payment, the result is transmitted to the merchant website in two ways:
To guarantee the security of the exchange, the data is signed with a key known only to the merchant and the payment gateway.
<form method="POST" action="https://secure.payzen.eu/vads-payment/"> <input type="hidden" name="parameter1" value="value1" /> <input type="hidden" name="parameter2" value="value2" /> <input type="hidden" name="parameter3" value="value3" /> <input type="hidden" name="signature" value="signature"/> <input type="submit" name="pay" value="Pay"/> </form>
It contains:
This data is added to the form by using the <input> tag:
<input type="hidden" name="parameter1" value="value1" />
For setting the name and value attributes, see the Data dictionary chapter also available in the online document archive.
All the data in the form must be encoded in UTF-8.
This will allow for the special characters (accents, punctuation marks, etc.) to be correctly interpreted by the payment gateway. Otherwise, the signature will be computed incorrectly and the form will be rejected.
<input type="submit" name="pay" value="Pay"/>
Different use cases are presented in the chapters below. They will allow you to adapt your payment form to your needs.
The following table lists the different formats that you can encounter when building your form.
| Notation | Description |
|---|---|
| a | Alphabetic characters (from ‘A’ to ‘Z’ and from ‘a’ to ‘z’) |
| n | Numeric characters |
| s | Special characters |
| an | Alphanumeric characters |
| ans | Alphanumeric and special characters (except ‘<’ and ‘>’) |
| 3 | Fixed length of 3 characters |
| ..12 | Variable length up to 12 characters |
| json | JavaScript Object Notation. Object containing key/value pairs separated by commas. It starts with a left brace “{” and ends with a right brace “}”. Each key / value pair contains the name of the key between double-quotes followed by " : ”, followed by a value. The name of the key must be alphanumeric. The value can be:
Example: {"name1":45,"name2":"value2", "name3":false}
|
| bool |
Boolean. Can be populated with the true or false value. |
| enum |
Defines a field with a complete list of values. The list of possible values is given in the field definition. |
| Enum list | List of values separated by a “ ; ”. The list of possible values is given in the field definition. Example: vads_available_languages=fr;en |
| map | List of key / value pairs separated by a " ; ". Each key / value pair contains the name of the key followed by " = ", followed by a value. The value can be:
The list of possible values for each key/value pair is provided in the field definition. Example: vads_theme_config=SIMPLIFIED_DISPLAY=true;RESPONSIVE_MODEL=Model_1 |
To finalize a purchase, the buyer must be redirected to the payment page.
His browser must transmit the payment form data.
Example of parameters sent to the payment gateway:
<form method="POST" action="https://secure.payzen.eu/vads-payment/"> <input type="hidden" name="vads_action_mode" value="INTERACTIVE" /> <input type="hidden" name="vads_amount" value="1315" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_cust_id" value="1234" /> <input type="hidden" name="vads_cust_email" value="jg@sample.com" /> <input type="hidden" name="vads_ctx_mode" value="TEST" /> <input type="hidden" name="vads_order_id" value="CMD012859" /> <input type="hidden" name="vads_page_action" value="PAYMENT" /> <input type="hidden" name="vads_payment_cards" value="IP_WIRE;IP_WIRE_INST" /> <input type="hidden" name="vads_payment_config" value="SINGLE" /> <input type="hidden" name="vads_site_id" value="12345678" /> <input type="hidden" name="vads_trans_date" value="20220326101407" /> <input type="hidden" name="vads_trans_id" value="362812" /> <input type="hidden" name="vads_version" value="V2" /> <input type="hidden" name=”signature" value="NM25DPLKEbtGEHCDHn8MBT4ki6aJI/ODaWhCzCnAfvY="/> <input type="submit" name="pay" value=”Pay"/> </form>
If the payment gateway detects an error while receiving the form, an error message is displayed and the buyer can not be to proceed to the payment.
In test mode:
The message indicates the source of the error and provides a link to the error code description to help you fix it.
In production mode:
The message indicates to the buyer that a technical problem has occurred.
In both cases, the merchant receives a warning e-mail containing the information:
A description of the error codes with their possible causes is available on our website:
The analysis of payment results is described in detail in the Hosted Payment Page guide.
This guide covers the processing of data specific to an Virement SEPA payment response only.
Here is an example of analysis to guide you through processing the response data.
The reason for rejection is transmitted in the vads_auth_result field.
| Codes | Description |
|---|---|
| 00 | The payment is accepted. |
| 80 | AC01: The account number is either invalid or does not exist. Incorrect IBAN/BIC, or account currency different from euro. |
| 81 | AC04: The account is closed and cannot be used. |
| 82 | AC06: The account is blocked and cannot be used. |
| 83 | AG01: Transaction forbidden for this type of account. E.g.: savings account. |
| 84 | AM18: The number of transactions exceeds the acceptance limit of the Account Servicing Payment Service Provider (ASPSP). |
| 85 | CH03: The requested execution date is too far in the future. |
| 86 | CUST: The reject is due to the debtor: refusal or insufficient funds. |
| 87 | DS02: An authorized user has cancelled the order. |
| 88 | FF01: The reject is due to the original payment request which is invalid (syntax, structure or values). |
| 89 | FRAD: The payment request is considered as fraudulent. |
| 90 | MS03: No reason specified by the Account Servicing Payment Service Provider (ASPSP). |
| 91 | NOAS: The PSU has neither accepted nor rejected the payment request and the time-out period has expired. |
| 92 | RR01: The account and/or debtor identification is missing or inconsistent. |
| 93 | RR03: Specification of the creditor’s name and/or address needed for regulatory requirements is incomplete or missing. |
| 94 | RR04: Rejection for regulatory reasons. |
| 95 | RR12: Invalid or missing identification required for a particular country or payment type. |
| 96 | DUPL: Duplicate operation. |
| 97 | TECH: Technical error |
Looking for help? See our online documentation:
|
France |
https://payzen.io/en-EN/faq/sitemap.html | |
|
Spain |
https://payzen.io/es-ES/faq/sitemap.html | |
|
Europe |
https://payzen.io/en-EN/faq/sitemap.html | |
|
Latin America (except Brazil) |
https://payzen.io/lat/faq/sitemap.html | |
|
Brazil |
https://payzen.io/pt-BR/faq/sitemap.html | |
For any technical inquiries or if you need any help, contact assistance.
Our services are available from Monday to Friday, from 09:00 a.m to 6:00 p.m..
In view of facilitating the processing of your requests, please have your shop ID ready (an 8-digit number).
This information is available in the “registration of your shop” e-mail or in the Merchant Back Office (Settings > Shop > Configuration).