PeerPesa API: stablecoin on and off ramps for Africa

PeerPesa is a stablecoin on and off-ramp for Africa. Use the API to let users exchange crypto assets on Stellar and Celo for local fiat across Kenya, Nigeria, Tanzania, South Africa, and Zambia, and vice versa. Settlements reach mobile money wallets and bank accounts.

KYC Verification

Verify your identity or business to unlock sandbox and production API keys.

Authentication

Obtain API keys and request a Bearer token.

Supported Currencies

Fiat currencies, networks, and available assets.

Network Stats

Check network health, fees, and confirmation times.

Rates

Fetch indicative conversion rates for any pair.

Quotes

Lock a rate and fee for 30 minutes.

Onramp

Convert fiat to crypto and send to a wallet.

Offramp

Convert crypto to fiat and pay a beneficiary.

Transactions

List and retrieve ramp transaction records.

Beneficiaries

Manage fiat payout recipients for offramps.

How a ramp works

Check currencies and rates

Use GET /currencies to see supported pairs and methods. Use GET /rates for an indicative price.

Lock a quote

Call POST /quotes with the amount, direction, and method to lock the rate and fee for 30 minutes.

Confirm the quote

Call POST /quotes/{id}/confirm with the receiving wallet for an onramp, or a saved beneficiary for an offramp.

Track the transaction

Use GET /transactions/{id} to follow status from payment/deposit through completion.

Base URLs

Use the sandbox environment for integration and testing. Use production for live transactions.

Environment	Base URL
Sandbox	`https://sandbox-api.peerpesa.co/v1`
Production	`https://api.peerpesa.co/v1`

All requests and responses use JSON with snake_case field names. Timestamps are ISO 8601 UTC strings. Money amounts are returned as decimal strings (for example, "100.00") to preserve precision.

Errors

PeerPesa returns structured errors in this shape. See Error Codes for the full list.

{
  "error": {
    "code": "quote_expired",
    "message": "..."
  }
}

Common error codes:

Code	Status	Meaning and what to do
`invalid_request`	400	The request body or query is malformed. Check field types and required parameters.
`unauthorized`	401	Token is missing or expired. Re-authenticate with POST /auth/token.
`not_found`	404	The requested resource ID does not exist. Verify the ID and environment.
`quote_expired`	422	The quote passed to an onramp or offramp has expired. Create a new quote.
`unsupported_pair`	422	The network, asset, fiat, or method combination is not supported. Check GET /currencies.
`rate_limited`	429	Slow down and retry with exponential backoff.
`internal_error`	500	Retry the request. Contact support if it persists.

Get Started

Reference

PeerPesa API: stablecoin on and off ramps for Africa

KYC Verification

Authentication

Supported Currencies

Network Stats

Rates

Quotes

Onramp

Offramp

Transactions

Beneficiaries

How a ramp works

Base URLs

Errors

KYC Verification

Authentication

Supported Currencies

Network Stats

Rates

Quotes

Onramp

Offramp

Transactions

Beneficiaries

​How a ramp works

​Base URLs

​Errors

How a ramp works

Base URLs

Errors