Exchange rates
The Pismo platform supports multi-currency exchange rates for international transactions. By default, daily exchange rates are defined at the organization level.
Exchange rates for international transactions
If you have network acceptance for international purchases you must register exchange rates daily. Refer to Exchange rates for international transactions for more information
For more information on exchange rates, refer to the following:
From Control Center, you can:
View exchange rates
To view exchange rates:
- From the main menu, select Configurations > Exchange rates.
- On the Exchange rates screen, you can view organizations and programs and their daily exchange rates. The table shown includes the following fields.
| Field | Description | API Parameters | Type | Validation Rules |
|---|---|---|---|---|
| Program ID or ORG | The program or organization this exchange rate is associated with. | program_id OR the word "ORG" | number | For programs, the program ID For orgs only, the word ""ORG"" |
| Origin currency code | The three-letter ISO 4217 code representing the currency from which the exchange is being calculated. The code must be listed in Control Center. | origin_currency_id | string | Control Center list of three-letter ISO 4217 currency codes |
| Destination currency code | The three-letter ISO 4217 code representing the currency you are converting into. The code must be listed in Control Center. | destination_currency_id | string | Control Center list of three-letter ISO 4217 currency codes |
| Exchange rate | The wholesale exchange rate amount in the destination currency. The wholesale exchange rate is the real market rate without any added fees. You can enter up to 4 decimal places. | exchange_rate | number | Number up to 4 decimal points |
| Spread | The percentage markup added to the base exchange rate to account for conversion costs or profit. You can enter up to 4 decimal places. For example: a spread value of 1.1205 means a 1.1205% markup is added to the exchange rate. This is the percentage the issuer charges for converting currency on that day." | spread | number | Number up to 4 decimal points |
| Apply fees to spread | When enabled (you select yes), the spread is excluded from exchange transactions when calculating fee model taxes. Default: no (spread is included) For example: If the exchange rate is 1.3000 and the spread is 1.1205%, taxes will be calculated on 1.3000 if this setting is yes, not on the final conversion rate of 1.3146." | apply_fees_without_spread | boolean | yes or no |
| Conversion rate | The exchange rate including the spread—a percentage markup added by the issuer. For example: If the exchange rate is 1.3000 and the spread is 1.1205%, the conversion rate is 1.3146. | Auto-generated in Control Center | number | Auto-generated in Control Center |
| Created time and date | Timestamp when the request was created | Auto-generated in Control Center | short date | Auto-generated in Control Center |
| Date | Today or tomorrow’s date in Coordinated Universal Time (UTC). If you have network acceptance for international purchases, you must register exchange rates daily. | date | short date | YYYY-MM-DD |
Create an exchange rate
To create a exchange rate:
- From the main menu, select Configurations > Exchange rates.
- On the Exchange rates screen, select Create exchange rate.
- On the Exchange rate details screen, enter values for the fields described in the exchange rate field table above.
- When you are done, select Add exchange rate.
Bulk upload exchange rates
You can bulk upload exchange rates in a CSV file. First, select the link to download the spreadsheet. Complete the spreadsheet and then upload it using the Bulk upload button.
Refer to the table above for fields that need to be present in the CSV file. You don't need to enter the fields auto-generated by Control Center (Conversion rate and Created time and date).
Important: Separate fields with semi-colons (;) not commas. Some of the exchange rate fields use commas.
Sample buik upload file:
PROGRAM ID/ORG;DATE;EXCHANGE RATE;FEE (SPREAD);ORIGIN CURRENCY CODE;DESTINATION CURRENCY CODE;APPLY FEES WITHOUT SPREAD?
ORG;2025-09-23;1.0001;1,9999;USD;BRL;false
31776;2025-09-23;1,0021;1,9979;BRL;EUR;true
1865;2025-09-23;1,0022;1,9978;EUR;BRL;false
2070;2025-09-23;1,0071;1,9929;USD;EUR;false
Updated about 6 hours ago