Remittance quotation

Remittance quotation

GET {{Environment_URL}}/v1/exchanges/remittance/outbound/?purposeCode=AVAILABILITY&currency=USD&correspondentId=1&value=200000&personType=PHYSICAL

This endpoint generates a detailed quotation for international remittance operations. It provides real-time exchange rates, fee calculations, and amount breakdowns for converting from foreign currencies to Brazilian Real (BRL).

Supported Currencies

The following foreign currencies are available for quotation: USD, EUR, GBP, AUD, CAD, PEN, ARS

Query Parameters

Parameter	Description	Type	Required	Example
currency	Target foreign currency (ISO 4217 code)	String	Yes	USD
value	Amount in foreign currency (multiplied by 100 for decimal precision)	Integer	Yes	10000 (represents 100.00)
purposeCode	Regulatory code that indicates the reason for an international remittance	String	Yes	AVAILABILITY
correspondentId	Id of the correspondent	Integer	Yes	10
personType	specifies the type of person, either PHYSICAL (individual) or LEGAL (company)	String	Yes	LEGAL

Amount Precision Handling

The value must be multiplied by 100 to maintain two decimal places precision:

• For 100.00 units → send 10000

• For 250.50 units → send 25050

• For 75.25 units → send 7525

Remittance Modalities

Modality	Description	Purpose Code
Availability	The receiving account holder is the Simple client themselves	AVAILABILITY
Maintainability	Resident maintenance - account holder is a third party	MAINTENANCE
Services	Resident services - account holder is a third party (individual or legal entity)	SERVICES
Investments	Investment operations - account holder is a legal entity	INVESTMENTS

Remittance Quotation

Attribute	Description	Type
id	Quotation unique identifier	String
correspondentId	Quotation correspondent id	String
purposeCode	Quotation type identifier	String
currency	Currency info	Currency
tax	Tax applied to current quotation	Tax
futureTax	Future Tax applied to current quotation	FutureTax
total	Totals of current quotation	Total
price	Price information of current quotation	Price
type	I's the type of operation that you will use (The default is "OUTBOUND", other types are not available)	String
clamp	Information about the current quotation limits	String
	Amount in seconds that current quotation is valid	Integer
createdAt	Creation date and time	DateTime
expireAt	Expiration date and time	DateTime

Value

Attribute	Description	Type
value	amount	Integer
dvisor	value precision	Integer

Currency

Attribute	Description	Type
code	Currency unique identifier	String
name	Currency name	String
offer	Final amount offered in current currency with current quotation	Integer
countryFlagUrl	URL for country flag icon	String
maxValue	maximum amount to sell for current currency	Integer
minValue	minimum amount to sell for current currency	Integer
commercialExchangeRate	Commercial exchange rate for current currrency	CommercialExchangeRate
spreadPercentage	Spread percentage of current currency	Decimal
levelingRate	Leveling rate applied to current currency	Value

CommercialExchangeRate

Attribute	Description	Type
updatedAt	Updated date of current commercial quotation	Date
value	amount	Integer
dvisor	value precision	Integer

Tax

Attribute	Description	Type
IOF	IOF tax applied to current quotation	IOF
bankFee	Is a bank tax not applied for this type of operation	BankFee

Future Tax

Attribute	Description	Type
ir	Income tax applied to current quotation	IR

When a purposeCode is different from SERVICES, the income tax amount is equal to zero.

BankFee

Attribute	Description	Type
valueUSD	It's a base value for bank taxes	String
total	amount in money applied to current quotation	Value

BankFee

Attribute	Description	Type
percentage	Tax percentage applied	Decimal
total	amount in money applied to current quotation	Value

IR

Attribute	Description	Type
percentage	Tax percentage applied	Decimal
total	amount in money applied to current quotation	Value

Price

Attribute	Description	Type
withoutTax	price to pay without taxes applied	Value
withTax	price to pay with taxes applied	Value
withFutureTax	price to pay with future taxes applied	Value

Total

Attribute	Description	Type
withoutTax	total price to pay without taxes applied	Value
withTax	total price to pay with taxes applied	Value
withFutureTax	total price to pay with future taxes applied	Value

Enum Clamp Param

Name	Description
NORMAL	Clamp using only multiples
MAXIMUM	Clamp using maximum amount to sell for a given currency
MINIMUM	Clamp using minimum amount to sell for a given currency

Response

200 - Success Availability

{
    "id": "ee4e29d9532b28b3064c3a44bea76c2d0b648cf6",
    "correspondentId": 1,
    "purposeCode": "AVAILABILITY",
    "currency": {
        "code": "USD",
        "name": "Dólar Americano",
        "commercialExchangeRate": {
            "divisor": 10000,
            "updatedAt": "2020-11-19T11:24:18.000Z",
            "value": 53370
        },
        "countryFlagUrl": "https://s3.amazonaws.com/frente-exchanges/flags/united-states.svg",
        "levelingRate": {
            "divisor": 10000,
            "value": 53370
        },
        "maxValue": 3000,
        "minValue": 101,
        "offer": {
            "divisor": 100,
            "value": 300000
        },
        "price": {
            "withoutTax": {
                "divisor": 10000,
                "value": 53904
            },
            "withTax": {
                "divisor": 10000,
                "value": 54497
            },
            "withFutureTax": {
                "divisor": 10000,
                "value": 54497
            }
        },
        "spreadPercentage": 1
    },
    "tax": {
        "bankFee": {
            "valueUSD": "20",
            "total": {
                "divisor": 100,
                "value": 0
            }
        },
        "iof": {
            "percentage": 1.1,
            "total": {
                "divisor": 100,
                "value": 17790
            }
        }
    },
    "futureTax": {
        "ir": {
            "percentage": 0,
            "total": {
                "divisor": 100,
                "value": 0
            }
        }
    },
    "total": {
        "withoutTax": {
            "divisor": 100,
            "value": 1617120
        },
        "withTax": {
            "divisor": 100,
            "value": 1634910
        },
        "withFutureTax": {
            "divisor": 100,
            "value": 1634910
        }
    },
    "type": "OUTBOUND",
    "clamp": "MAXIMUM",
    "timeToLive": 600,
    "expiresAt": "2020-11-19T11:36:59.000Z",
    "createdAt": "2020-11-19T11:26:59.862Z"
}

200 - Success Services

200 - Success Maintainability

404 - Not Found