Exchange rates
The Pismo platform supports multi-currency exchange rates for international transactions. By default, daily exchange rates are defined at the organization (org) level. However, you can use the Create exchange rate endpoint to create an exchange rate for today or tomorrow for your org or a specific program.
You can use the Get exchange rates endpoint to get exchange rates for your org or a specific program.
Example create exchange rate request
{
"program_id": 1985,
"date": "2022-04-05",
"exchange_rate": 4.8123,
"spread": 1.1205,
"origin_currency_id": "840",
"destination_currency_id": "896"
}
The purchase is made in US dollars, but the payment for it is in Brazilian reals, so the origin_currency_id
is 840
and destination_currency_id
is 986
. These are ISO 4217 currency code values.
The exchange_rate
in the example is 4.8123
, which means that 1 US dollar (origin currency) equals 4.8123 Brazilian reals (destination currency).
The spread
value of 1.1205
is equivalent to 1.1205% , which represents the percentage rate multiplier on the day. The platform adds this percentage that the issuer wants to charge for the conversion to the value of exchange rates.
If this request is successful, the platform creates the exchange rate and applies it to the program, since the program_id
is specified in the request.
Updated 9 months ago