Payment with separate FX conversion

The steps are as follows:

1. Initialise quote request - initiate the quote request. The process is asynchronous. This means that after initialising the quote request, you need to find the response(s) and call the quote request (refer to step 2).

   To create a quote request, use the initialise endpoint. You must provide the following information:

   • The sell currency code. For example, EUR.

   • The buy currency code. For example, GBP.

   • The fixed currency code must be equal to either the buy currency or the sell currency.

   • The amount to be exchanged. The endpoint generates a quote request ID, response ID, and other parameters as the response.

2. Find quote requests with responses - gives one or several responses to the respective quote request depending on your Tuum platform configuration.

   To find the quote requests, use the fx-quotes endpoint.

3. Confirm quote - initiate the FX order with reference to the respective quote. This process is asynchronous. After confirmation, you need to get the FX order to check the status of the quote (refer to step 4). To initiate the FX order, use the confirm endpoint. The response includes an FX order ID and other parameters.

4. Find FX order - gets the FX order with the order ID as the search parameter. Use the orderID endpoint.

5. Initialise payment - refers to payment initialisation. The transaction is carried out in this step. Use the initialise payment endpoint and continue with the regular payment initiation process.

Sample API calls

Refer to the full examples in the API cookbook for sample API calls that show how to create FX quotes and initiate related payments:

• Initialise FX quote request

• Get FX quote response

• Initiate FX order