# Deripay

> Mobile money deposits and withdrawals for Deriv sites. REST API v2 at https://deriapi.site/api/v2 (server-to-server, Bearer key). Markets: Kenya, Tanzania, Uganda. MCP server: https://deriapi.site/mcp (OAuth sign-in).

Important: never call the API from a browser; amounts in local currency are whole units; deposits and withdrawals need an Idempotency-Key; verify webhook signatures.

## Docs
- [Overview](https://deriapi.site/docs): What the Deripay API does, which markets it covers, and how an integration fits together.
- [Quickstart](https://deriapi.site/docs/quickstart): Go from a new Deripay account to a first deposit and a verified webhook.
- [Authentication](https://deriapi.site/docs/authentication): API keys, scopes, IP allowlists, rate limits and the response envelope.
- [Deriv OAuth](https://deriapi.site/docs/deriv-oauth): Register a Deriv OAuth app and connect a customer with Authorization Code and PKCE, or with a personal access token.
- [Webhooks](https://deriapi.site/docs/webhooks): Receive signed transaction events and verify them on your server.
- [Idempotency](https://deriapi.site/docs/idempotency): Retry deposits and withdrawals safely without moving money twice.
- [Go-live checklist](https://deriapi.site/docs/go-live): What to check before real customers deposit and withdraw through your site.
- [Connections](https://deriapi.site/docs/connections): Create, read and list customer connections, and read a connected Deriv balance.
- [Markets and rates](https://deriapi.site/docs/markets-and-rates): List open markets and read live exchange rates and limits before every transaction.
- [Deposits](https://deriapi.site/docs/deposits): Collect mobile money from a customer and credit their Deriv account.
- [Withdrawals](https://deriapi.site/docs/withdrawals): Take USD from a customer's Deriv account and pay it out to their phone.
- [Transactions](https://deriapi.site/docs/transactions): The transaction object, its states, listing, polling and the live event stream.
- [Errors](https://deriapi.site/docs/errors): Every error code the v2 API can return, with its HTTP status, meaning and what to do.
- [Examples](https://deriapi.site/docs/examples): Minimal complete integrations in Next.js, PHP and Python.
- [Using Deripay with AI agents](https://deriapi.site/docs/ai): Connect Claude Code, Codex or Cursor to the Deripay MCP server and machine-readable docs.
- [Changelog](https://deriapi.site/docs/changelog): Changes to the Deripay API and developer platform.

## Machine-readable
- [OpenAPI 3.1](https://deriapi.site/openapi.json)
- [Full docs in one file](https://deriapi.site/llms-full.txt)
- [MCP server](https://deriapi.site/mcp): docs tools plus your dashboard data