Markets and rates
Get available countries, mobile networks, exchange rates and payment limits.
Call GET /api/corridors to build your payment options. Each entry includes a country, currency, available deposit and withdrawal directions, mobile networks, phone-number format and recipient-name verification support. The list can be empty when no markets are available.
Use payment_method to distinguish mobile_money from crypto. For mobile money, use the operator codes returned for the selected country. Send operator with the payment request when requires_operator is true. It is optional in markets with one network.
If you omit country, Deripay uses your workspace's country, or Kenya if none is assigned. Payments must stay within your workspace's country permissions, even when the corridor list includes other countries.
Call GET /api/rates?country=KE for a market's current rates and limits. /api/rates/usdkes is also available for Kenya. Both deposit and withdrawal rates are local currency units per USD. Deposit limits are whole local currency units; withdrawal limits are USD. Refresh these values before submission. The transaction response contains the amounts accepted for that payment.
For mobile money deposits, send a positive whole-number amount in the local currency. Kenya also accepts amount_kes. Send one amount field; if both are present and amount is nonzero, Deripay uses amount. Withdrawals use amount_usd. Crypto deposits use a whole-number KES quote amount; the customer selects their asset and network in checkout.
When recipient-name confirmation is unavailable, show the phone number and network to the customer and ask them to confirm the destination before payout.