Guides
Sub-processorsAbout PismoContact us
Start typing to search…

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:

  1. From the main menu, select Configurations > Exchange rates.
  2. 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:

  1. From the main menu, select Configurations > Exchange rates.
  2. On the Exchange rates screen, select Create exchange rate.
  3. On the Exchange rate details screen, enter values for the fields described in the exchange rate field table above.
  4. 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 bulk 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 11 days ago