Overview
Last update: February 5, 2025
This section of the documentation describes how to integrate Oney payment products in stores.
It explains the general operation of our multi-payment system, as well as the technical implementation details of our product.
Available payment methods by country
| Payment methods | France | Portugal | Spain | Italy | Romania | Belgium | Netherlands |
|---|---|---|---|---|---|---|---|
| Card opening |
List of services
For more information about services, you can find more information in our API Explorer.
Buy now pay later (3x4x)
URL : /b2b/proximity_payments/purchase/v1/proximity_facilypay_url
Method : POST
Description : The service allows generating a URL to redirect the customer on the payment solution.
Loan subscription
URL : /b2b/proximity_payments/purchase/v1/proximity_payment_url
Method : POST
Description : Generate a URL to redirect the customer to repayment loan subscription 5x to 60x.
Card opening
URL : /b2b/proximity_payments/purchase/v1/proximity_line_of_credit_url
Method : POST
Description : Generate a URL to redirect on card opening subscription.
Nominal behavior
This sequence diagram shows the nominal behavior of the subscription process:
Callback
Once the credit is accepted (or refused), a data stream is sent from the Oney server to the URL supplied in the server_response_url parameter.
This data stream tells you application's state of progress at Oney.
This API, provided by the merchant, enables Oney to communicate the Status of a payment request. The signature of the service is defined below. The url of the service is given to Oney by the merchant in the body of the payment request (field: server_response_url).
Requirements
• The service must be available 24/7. Notifications are actions carried out by the customer.
• The url must be accessible from the internet.
• The URL call is done via the 'POST' method
In case the selected protocol is HTTPS, you should:
• Use a certificate generated by a recognized certified authority
• Exposes the full chain of the certificate (including the (the certificate (s) intermediate (s)).
• Inform Oney prior to any change of certificate in order to ensure the presence of the CA certificate in Oney warehouse.
Callback API request header
| Field name | Type | Mandatory | Description |
|---|---|---|---|
| X-Oney-Secret | String | M | Valued as follows (based on security standard): Bearer <token> where <token> represent a JWE token used for data encryption. |
| Content-type | String | M | application/json |
| Key | String | O | These keys are filled as requested by partner in the payment request table server_response_header_params.key and server_response_header_params.value |