Using the buyer wallet
Payment by meal voucher is compatible with the use of the buyer wallet.
For more information on the buyer wallet, see our integration guide.
In order to use the buyer wallet, make a call to the Charge/CreatePayment Web Service.
Use the same fields as for a single payment and change the value of the formAction field using the value below:
Value of the formAction field | Description |
---|---|
CUSTOMER_WALLET | Proposes to add the payment method in the buyer wallet and allows to use already registered payment methods. The customer.reference field becomes mandatory. |
Note on the buyer details associated with the buyer wallet
The billing information (billingDetails object) transmitted during the registration of the payment method is automatically applied to the transactions made with the buyer wallet.
However, if the merchant transmits the billing details in the Charge/CreatePayment request, then it is the request data that is used for the transaction.
In this case, the buyer details associated with the payment method are not updated.
Example of a request:
POST https://api.systempay.fr/api-payment/V4/Charge/CreatePayment
{ "amount": 1715, "currency": "EUR", "formAction": "CUSTOMER_WALLET", "customer": { "reference": "104123487", "email": "sample@example.com", "billingDetails": { "category": "PRIVATE", "firstName": "Jeanne", ... }
Examples of a form
If no meal vouchers are associated with the buyer wallet, the form will propose to enter the card details: | If a meal voucher is associated with a buyer wallet, the fields are pre-filled. Th buyer will also have the possibility to add a new card: |