Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Exchange rates

Create exchange rate

Define the exchange rate for international transactions.

You must use this endpoint or Pismo Control Center to define the exchange rate for today or tomorrow.

Exchange rates are defined at the organization level but, optionally, you can define rates for a specific program and the platform uses this rate and not the org rate for all program-related transactions.

Note: For more information, refer to Exchange rates for international transactions.

post/v1/exchange-rates

Headers

Authorizationstring required

Access token, not an account-specific token. Tokens can expire quickly, which can result in an <b>401 Unauthorized</b> message

Request body

datestring date required

Date for today or tomorrow, format = yyyy-mm-dd.

destination_currency_idstring required

Destination ISO 4217 currency.

origin_currency_idstring required

Origin ISO 4217 currency.

exchange_ratenumber required

Wholesale exchange rate amount to 4 decimal places in the destination currency. For example 4.8123.

spreadnumber required

Day rate multiplier to 4 decimal places. For example, 1.1205 is equivalent to 1.1205%, 15.12 is equivalent to 15.12%..

hourstring time

Hour in UTC time zone, format = HH:MM:SSZ. Using this field, you be able to work with seconds precision in your international purchases.

Note: This field will be validated considering an offset of UTC subtracted three seconds just in the validation layer, to prevent you to need increase a few seconds just to pass our validation.

program_idnumber

Pismo program ID.

apply_fees_without_spreadboolean

Whether spread should be ignored in exchange transactions when calculating fee model taxes. Default = false.

Example request

{
  "date": "2022-01-02",
  "destination_currency_id": "840",
  "origin_currency_id": "032",
  "exchange_rate": 4.8123,
  "spread": 1.0567,
  "hour": "14:30:00Z",
  "program_id": 1010,
  "apply_fees_without_spread": true
}

Response

Created