Integration using Checkout Page
This option allows you to get a head start on integration and saves you the trouble of building your own UI, generating user addresses for each currency and displaying them to the user.
Please check the Payment flows page for a list of payment flows and currencies available for this integration form.
Invoice payment flow
XGateway supports two types of invoices:
Floating Rate invoices
Invoice with 24-hour expiration time. An exchange rate is "floating", which means that the exchange rate updates every 15 minutes and a payment amount can change over time. The customer can have only 1 floating invoice at a time, once the customer creates a new invoice all previous invoices will be cancelled.
To create a Floating Rate invoice in the payment processing system, you need to make a POST
request to the Invoice API v1 endpoint.
Remember to authorize the request with your x-api-key
header.
Headers
Fixed Rate invoices
Invoice with short time to live. Exchange rate fixes in a moment of invoice activation. Customers can create an unlimited amount of invoices but can have only up to 10 activated invoices. To activate a new one wait till previous invoices expire.
To create a Fixed Rate invoice in the payment processing system, you need to make a POST
request to the Invoice API v2 endpoint.
To manage the display of currencies on checkout page — use displayCurrencies
parameter. When an array is provided, the function preserves and respects the specified order of the currencies. If parameter is not provided — checkout will show every enabled currency
Remember to authorize the request with your x-api-key
header.
Headers
Session Life
Invoices at the moment of creation have no expiration time. After invoice activation on the checkout page (when the customer selects the payment currency and clicks "Proceed"), the system will set an expiration time according to invoice TTL. Once an invoice has expired, the link will show an error.
You can make several requests for the same customer with a different amount/base currency and get a different checkout link back.
Invoice time to live(TTL)
v1
The time to live for floating invoices is 24 hours.
v2
The time to live for fixed invoices can be configured during merchant creation and can also be adjusted later in the Merchant's back office. The default value for the invoice TTL is 1200 seconds, which is equivalent to 20 minutes.
Last updated