• 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

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.

POSThttps://api.systempay.fr/api-payment/V4/Charge/CreatePayment

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:

© 2025 {'|'} All rights reserved to Systempaylegal
25.18-1.11