Orders

This module contains the complete set of endpoints required to create and manage a payment order. It covers the full lifecycle from checking rates and locking the conversion pair (User's Payment Currency Your Settlement Currency) to tracking the final status.

Core Endpoints

Get Exchange Rates

Get a live list of all supported currencies and their indicative exchange rates against your desired settlement currency.

Lock Rate

Lock a specific exchange rate between the payment asset and settlement currency to guarantee the amount you receive.

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)

Get Exchange Rates Retrieve live indicative rates. You can check rates for standard Fiat settlement or specific Crypto settlement (e.g., cost of USDC in DOGE).

2. Lock a specific rate

When the user is ready to pay, call Lock Rate.
This step defines the transaction pair:

Payment Currency: The asset the user sends (e.g., DOGE).

Settlement Currency: The asset you receive (e.g., EUR or USDC).

If you choose to receive funds in a specific crypto (e.g., USDC), this endpoint locks the conversion rate from the user's chosen coin (DOGE) to your target currency (USDC). It 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#