Create and Finalize an Exchange

Executes a currency exchange using a pre-established rate lock.

You must provide a valid rate lock ID (from the Retrieve Exchange Rate and Create a Lock endpoint) to execute at the locked rate.

Asynchronous Workflow

The exchange process is asynchronous and requires the following steps:

Create a Rate Lock: Call Retrieve Exchange Rate and Create a Lock to obtain a valid lockId. This ID is mandatory to execute the exchange at the locked rate.

Execute the Exchange: Submit this endpoint with the lockId, amount, and currency pair. The system reserves funds and immediately returns an exchangeId.

Track Status: To determine the final outcome (COMPLETED or FAILED):

Listen for the Exchange Webhook.

Poll Retrieve Exchange Details using the exchangeId.

Asynchronous Processing

Business logic errors such as insufficient funds are not checked immediately.
The API accepts the request and schedules it for processing. Verify the final outcome via the incoming webhook or by calling the details endpoint.

curl --location 'https://stage-api.fintegence.io/v1/partner/exchange' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "amount": 10, "currencyFrom": "eth", "currencyTo": "eur", "lockId": "ee7b2f0f-0ffb-4fce-8fb3-66db2ca1f461" }'

Create and Finalize an Exchange

Asynchronous Workflow

Request

Responses

Create and Finalize an Exchange

Asynchronous Workflow#

Request

Responses

Asynchronous Workflow