• France
status page
Demo shops
assistance
FAQContact support
Search
Categories
Tags
Europe (English)
France
Spain
Europe (English)
India
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
SDD mandates by REST API
Snippets
Payment methods
Plugins
Marketplace
Guides
Merchant Back Office
Back Office Expert
Functional guides

Installment payment

If the Buyer wishes to extend the payment over a period of time, he or she can make a payment in installments.

During a payment in installments, all the transactions are created on the days of payment.

Only the first installment can be guaranteed to the Merchant on the condition that their requested capture date is set before the authorization expiry date, depending on the payment method.

At the time of the payment, the validity of the payment method is checked throughout the payment schedule.

This payment mode is not supported by the embedded form.

The list of transactions can be seen at the following address:

GET /orders/{order}/transactions

It also appears on the list of links in response to a GET ORDER, POST ORDER, or PUT ORDER.

You should note that transactions are generated after the order has been paid. If the link is visited before, the list of transactions is empty.

In order to initialize a payment in installments, simply add the payment_config attribute in the POST ORDER resource when creating the order.

Here is an example of how to use the payment_config attribute:

{
"marketplace": "9537e049-8862-400a-ae8d-da2ec9ca6051",
"payment_config" : "MULTI:first=30000;count=3;period=30"
"reference": "order00053",
"description": Order",
"currency": "EUR",
"url_return": "http://www.my-website.com",
"language":"en"	
}

Notes:

  • By default, the payment is mono-transactional. If the payment_config attribute is not specified when the order is created, it will take the SINGLE value;
  • Once the order is fixed, it is not possible to change the payment_config value. However, some parameters of pending transactions can still be changed (see infra);
  • Payment in installments is currently not compatible with cascading payment (and is therefore not compatible with the Electronic Meal Voucher system).

Two different payments in installments can be defined, depending on whether the Marketplace wishes to automatically create a regular schedule, or define the dates and amounts at its discretion.

  • Regular payments: MULTI
  • Custom schedule: MULTI_EXT
Jobs
Legal
GDPR
25.18-1.11