The "Quotes" service is used when Ebury applies the spread to the exchange rate informed by API. It's possible to set up different spread according to the operation modality and timetable window (business and non-business hours). If you need to set up more specific pricing, such as applying different spread rates depending on customer, we suggest the use of “Custom quote” consequently, you will be responsible for applying the spread rate to the exchange rate.

The application of Income tax and IOF varies depending on the FX category and operation modality of the operation.

Use the “Simulate an Exchange Operation” service in order to check the charges.

Note 1: IOF is a tax on various types of financial transactions in Brazil — including foreign exchange, investments, and credit. It’s levied at a range of rates depending on exactly what kind of transaction is being carried out, and can change at short notice. IOF is intended to be a regulatory instrument — meaning that it helps the government measure and manage the volumes of credit and foreign exchange.

Note 2: VET stands for Total Effective Value and, as stated by the Brazilian Central Bank, "is the total number of reais delivered or received per unit of foreign currency in an exchange transaction."

All institutions authorized to operate in the foreign exchange market must inform the VET to the customer before the operation is carried out. It exists to facilitate price comparisons between companies in which the customer simulates the operation.

Calculation example:

VET = [(Amount * FX Rate) - IOF - Fee] / (Amount)

VET = [(1,000.00 * 5,00) - 19.00 - 50.00] / (1,000.00)

VET = 4,931 (R$/USD)

To indicate the operation's amount and modality in the context of foreign exchange (FX) transactions, you need to provide the several details for each. The modality refers to whether you're buying or selling a currency.

Here’s a breakdown of how to correctly structure the payload based on the options:

OPERATION MODALITY: Sell

• Goal: converting BRL to foreign currency (payin)
• Source currency: BRL REAIS
• Target currency: Foreign Currency
• Feel free to inform the gross amount in the source or target fields.

OPERATION MODALITY: Buy

• Goal: converting foreign currency to BRL (payout)
• Source currency: Foreign Currency
• Target currency: BRL REAIS
• The source currency is the foreign one, and it’s mandatory to inform it. Make sure that the amount in BRL is equal to 0.

How these fields are fulfilled depends on the specific requirements of your business. Contact your Implementation Manager to obtain detailed instructions tailored to your operational scope.

Important Observation: The "time windows" mentioned for FX operations are subject to banking business days according to the Brazilian calendar. Weekends and national holidays are not considered business days for processing and settlement purposes.