Objective

The objective of this module is to explain how the process of creating an international outbound transaction in Corporate API works.

Functionalities

Through the transaction module, it is possible to:

Outbound Transaction Flow

After creating a quote and accepting it, the last step in the API is to create an outbound transaction. The API gets all accepted quotes (not bound to a transaction), and creates a transaction with the sum of USD or EUR amounts and the weighted average of exchange rates.

Before creating the transaction, it is possible to check all the accepted quotes through the endpoint GET transaction quotes.

📘

Beneficiary

The beneficiary's information and bank details are defined in advance and associated with the partner's profile. If the beneficiary or the bank details have been changed, please let us know so we can update the client's profile on our end.

❗️

Transaction Payment

Transactions can only be created in business days from 9am to 5:00pm (BRT Time). Also, The BRL funds need to be transferred on the same day the transaction was created. Otherwise the transaction will be canceled.

🚧

Settlement Date

Corporate API does not work for future settlements, only with spot exchange. Which means that the transaction, after being paid, will have it's liquidity date settled for T+0, T+1 or T+2, depending on the time that the payment was made. The table below shows the time box for T+0 operatations:

If payment does not occur in the time box shown below, settlement will be made on T+1 or T+2.

After creating the transaction, the partner needs to transfer the funds in the equivalent amount in BRL specified in the transaction. You can check Remessa Online's partner Bank Account details below:

📍 1. Data for Creating an Outbound Transaction

To create an inbound transaction, you need to provide the required parameters:

Below you can see an example of a full request for creating an outbound transaction for the Crypto purpose:

curl --request POST \
     --url https://fx-sandbox.remessaonline.com.br/corporate/v1/transaction/OUTBOUND \
     --header 'Authorization: Bearer {{token}}' \
     --header 'Content-Type: application/json' \
     --header 'User-Agent: {partnername}-remessa' \
     --header 'accept: application/json' \
     --header 'x-token: {{x-token}}' \
     --data '
{
  "externalId": "1f8c4581-9d17-4b45-a0f6-d27277867c2d",
  "currency": "USD",
  "purpose": "CRYPTO",
  "counterpartyId": "ph23c4581-9d17-4b45-a0f6-d27277867c2d"
}

Outbound Transaction Sequence Diagram

Outbound Transaction Statuses

Transaction Flow Statuses

Other Statuses

📘

Partners can be notified through webhooks when the transaction status changes. More details can be found here