DeriPayDeriPayDeriv docs
DeriPayDeriPayDeriv docs
Deriv partner portalDeripay Partner API

Get started

Partner portalAuthentication and authorizationCustomer authorization

Move money

Markets and ratesDepositsWithdrawalsWallet and Options transfersTransaction status and eventsFailed transactions and reporting issuesStatistics and CSV exports

Reliability

Idempotency and retriesErrors and recoveryGo-live checklist

API reference

API reference
Health check GETAuthorize customer POSTGet connection GETSave default phone PATCHGet balances GETList payment corridors GETGet exchange rate and limits GETGet Kenya exchange rate and limits GETCreate mobile money deposit POSTCreate crypto deposit POSTSubmit deposit verification POSTStart withdrawal verification POSTResend withdrawal verification POSTComplete withdrawal POSTList transactions GETGet transaction GETMonitor transaction GETList Wallet–Options transfers GETCreate or retry Wallet–Options transfer POSTGet Wallet–Options transfer GETDismiss unconfirmed transfer POSTGet statistics GETExport statistics CSV GETList earnings by transaction GETGet earnings by customer GET

Deripay Partner API

API referencePayment API

List payment corridors

List available mobile money countries, networks and deposit or withdrawal support. Payment requests must follow your workspace country permissions. An empty list means no mobile money markets are currently available.

GET
/api/corridors

List available mobile money countries, networks and deposit or withdrawal support. Payment requests must follow your workspace country permissions. An empty list means no mobile money markets are currently available.

Required API key scope: rates:read.

Request example

GET /api/corridors HTTP/1.1Host: api.edgepro.siteX-API-Key: <your-api-key>X-Deripay-API-Version: 2Accept: application/json

Authorization

partnerAPIKey
headerX-API-Key<token>

Header Parameters

X-API-Key*string

Your API key. Send requests from your server.

X-Deripay-API-Version*string

Selects the response and error format documented here. Without it, the same URL returns the original format.

Accept?string

Response Body

Successful request.

application/json
  1. response
  1. response
  2. …
success*boolean
message*string
data*
curl -X GET 'https://api.edgepro.site/api/corridors' \  -H 'X-API-Key: <your-api-key>' \  -H 'X-Deripay-API-Version: 2' \  -H 'Accept: application/json'
{  "success": true,  "message": "Corridors retrieved successfully",  "data": {    "corridors": [      {        "country": "KE",        "name": "Kenya",        "currency": "KES",        "payment_method": "mobile_money",        "deposit_enabled": true,        "withdrawal_enabled": true,        "dialing_code": "254",        "national_number_length": 9,        "operators": [          {            "code": "mpesa",            "name": "M-Pesa"          }        ],        "requires_operator": false,        "confirms_recipient_name": true      }    ]  }}

Get balances GET

Get the Wallet balance and, when available, the Options balance. Withdrawals use the Wallet balance. This response represents amounts as JSON numbers.

Get exchange rate and limits GET

Get exchange rates and payment limits for the selected country. Rates are local currency units per USD. Use deposit_rate to calculate the USD credited by a deposit and withdrawal_rate for withdrawals. Kenya also returns crypto_payment_rate: divide the KES deposit amount by this rate to estimate the USD to pay at crypto checkout. The checkout confirms the final payment amount. Rates and limits can change before submission. An unsupported country returns 404.