Get exchange rates

Returns the indicative exchange rate Cashela applies for a country and payment type. Use it to show your customer an estimate. The amounts that apply to a deposit are the ones in Get payment methods and in the deposit itself.

POST/api/v1/pay-in/deposit-creation/exchange-rates

Authentication	HTTP Basic (api_key:api_secret)
Moves money	No

Request body

Field	Type	Required	Description
payment_type	string	Yes	A payment type available for country (for example BANK_TRANSFER).
country	string	Yes	3-letter ISO code.
amount	number	No	Amount to convert. Positive, at most two decimals.

curl https://sandbox-api.cashela.com/api/v1/pay-in/deposit-creation/exchange-rates \
  -u "$CASHELA_API_KEY:$CASHELA_API_SECRET" \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{ "payment_type": "BANK_TRANSFER", "country": "CHL", "amount": 25.50 }'

Response 200

{
  "success": true,
  "data": {
    "country": "CHL",
    "amount": 25.5,
    "exchange_rates": 940.12
  },
  "message": "Exchange rates retrieved successfully."
}

Field	Description
country	The country you asked for.
amount	The amount you sent.
exchange_rates	Indicative rate for the corridor.

Note

Rates move. The rate is indicative and is not locked for a later deposit. For card payments charged in USD, the card issuer sets the final rate the customer sees on their statement. See Card payments.

Errors

HTTP	When
404	No method of that payment type is available for the country on your account.
422	Missing payment_type, unknown country ("The selected country is invalid."), or a malformed amount.
503	The exchange rate is temporarily unavailable for this destination. Retry later.

See Errors.