Payout Prices

Overview

The Prices API provides real-time exchange rates for converting US Dollars (USD) into local currencies for cross-border payouts. These rates enable you to show customers the current exchange rate before initiating international payments.

⚠️
Exchange rates and fees
The exchange rate displayed by the Prices API reflects the current market rate and does not include any platform or payout fees. When you request a quote or initiate a trade, all applicable fees (such as flat and percentage-based fees) are calculated and shown separately in the fee field of the quote response. Review the quote response to see the total fee breakdown before confirming a transaction.

ℹ️
Sandbox vs. production fees
In the sandbox environment, payout fees may not be applied or reflected in the same way as in production. Always validate fee calculations and workflow in production with a small test transaction before going live.

👍
Enable this feature
Contact Cybrid support to enable this feature for your bank.

Understanding Payout Symbols

Payout symbols represent local currency conversions from USD:

MXN-USD: Mexican Peso from US Dollar
COP-USD: Colombian Peso from US Dollar
INR-USD: Indian Rupee from US Dollar
PKR-USD: Pakistani Rupee from US Dollar

The format is always [Local Currency]-USD.

Participants Type

The participants_type parameter defines the sender-receiver relationship:

Type	Sender	Receiver	Typical Use Case
C2C	Consumer (Individual)	Consumer (Individual)	Personal remittances, sending money to family
C2B	Consumer (Individual)	Business	Individual paying a business invoice
B2C	Business	Consumer (Individual)	Payroll, contractor payments, refunds
B2B	Business	Business	Corporate cross-border payments, supplier payments

Why it matters: Different participants types may have different:

Exchange rates
Processing fees
Transaction limits
Regulatory requirements

Always use the participants type that matches your actual use case.

Delivery Route

The route parameter specifies how funds are delivered:

Route	Description
bank_account	Direct bank transfer to recipient's account
mobile_wallet	Digital wallet providers

Making a Request

Get all available payout prices

GET /api/prices?payout_symbol=MXN-USD
Authorization: Bearer YOUR_ACCESS_TOKEN

Required scope: prices:read

Filter by specific criteria

GET /api/prices?payout_symbol=MXN-USD&payout_participants_type=B2B&payout_route=bank_account
Authorization: Bearer YOUR_ACCESS_TOKEN

Query Parameters:

Parameter	Type	Description
`payout_symbol`	String	Currency pair (e.g., MXN-USD, PKR-USD)
`payout_country_code`	String	Destination country (e.g., MX, PK, IN)
`payout_participants_type`	String	Sender-receiver relationship (C2C, C2B, B2C, B2B)
`payout_route`	String	Delivery method (bank_account, mobile_wallet)

Response Example

[
  {
    "symbol": "MXN-USD",
    "type": "payout",
    "buy_price": 1855,
    "sell_price": null,
    "buy_price_last_updated_at": "2025-10-31T18:59:00.000000Z",
    "sell_price_last_updated_at": null,
    "country_code": "MX",
    "participants_type": "B2B",
    "route": "bank_account"
  }
]

Overview

Exchange rates and fees

Sandbox vs. production fees

Enable this feature

Understanding Payout Symbols

Participants Type

Delivery Route

Making a Request

Get all available payout prices

Filter by specific criteria

Response Example

Related Resources