Orders

This module contains the complete set of endpoints required to create and manage a payment order, from checking rates to tracking its status.

Core Endpoints

Get Exchange Rates

Get a live list of all supported currencies and their indicative exchange rates.

Lock Rate

Lock a specific exchange rate for a short period to guarantee it for a transaction.

Place Order

Create a new order using a previously locked rate. This process is asynchronous.

Get Order Details

Check the current status and details of a previously created order.

Typical Workflow

A typical process for creating and handling an order consists of four steps.

1. Get current rates (optional)

Use Get Exchange Rates to display live, indicative rates to the user.

2. Lock a specific rate

When the user is ready to pay, call Lock Rate. This guarantees the rate for a short period and returns a lockId required for the next step.

3. Place the order

Use the lockId to call Place Order. The API immediately returns an orderId.
Note: The payment wallet is created asynchronously in the background.

4. Track the order’s progress

After receiving the orderId, you can track its progress in two ways:

Get real-time updates via Order Status Webhook (recommended).

Poll Get Order Details until the order status changes from WAITING_FOR_WALLET_ADDRESS.

Core Endpoints#

Typical Workflow#

1. Get current rates (optional)#

2. Lock a specific rate#