# Tanda API

> Collect and send KES payments in Kenya through M-PESA, Airtel Money and bank transfer with one API.

- [Tanda API](https://api.tandapay.io/introduction.md): Collect and send KES payments in Kenya through M-PESA, Airtel Money and bank transfer with one integration.
- [Quickstart](https://api.tandapay.io/quickstart.md): Authenticate, collect a payment and send a payout in sandbox.
- [Authentication](https://api.tandapay.io/guides/authentication.md): Exchange your API keys for a bearer token and keep it fresh.
- [Environments](https://api.tandapay.io/guides/environments.md): How sandbox and production work, and what to check before going live.
- [Kenya payment methods](https://api.tandapay.io/guides/kenya-payment-methods.md): Supported methods, operator codes, phone number format and bank codes.
- [Accepting payments](https://api.tandapay.io/guides/collections/overview.md): Choose between hosted checkout and direct collection APIs.
- [Checkout](https://api.tandapay.io/guides/collections/checkout.md): Accept M-PESA, Airtel Money and bank transfer on one Tanda-hosted payment page.
- [M-PESA and Airtel Money](https://api.tandapay.io/guides/collections/mobile-money.md): Send a payment prompt to a customer's phone and confirm the result.
- [Bank transfer](https://api.tandapay.io/guides/collections/bank-transfer.md): Issue a temporary bank account for one payment and reconcile it automatically.
- [Refunds](https://api.tandapay.io/guides/collections/refunds.md): Return a successful mobile money payment to the customer.
- [Payouts](https://api.tandapay.io/guides/payouts/overview.md): Send KES to M-PESA, Airtel Money, Kenyan banks, paybills and tills.
- [Sending payouts](https://api.tandapay.io/guides/payouts/sending-payouts.md): Request bodies for every payout destination, plus status and failure handling.
- [Beneficiaries](https://api.tandapay.io/guides/payouts/beneficiaries.md): Save recipients once and pay them by ID.
- [Webhooks](https://api.tandapay.io/guides/webhooks/overview.md): Get payment and payout outcomes pushed to your server.
- [Verify webhooks](https://api.tandapay.io/guides/webhooks/verify-signatures.md): Check the signature header before trusting a webhook.
- [Events and payloads](https://api.tandapay.io/guides/webhooks/events.md): The webhook envelope, every event type and example payloads.
- [Testing](https://api.tandapay.io/guides/testing.md): Sandbox values that trigger success, failure and every customer step.
- [API errors](https://api.tandapay.io/guides/errors/api-errors.md): HTTP status codes and errorCode values for rejected requests.
- [Transaction errors](https://api.tandapay.io/guides/errors/transaction-errors.md): Why charges and payouts fail, and what to tell the customer.
- [API reference](https://api.tandapay.io/api-reference/introduction.md): Conventions shared by every Tanda endpoint.
- [Generate bearer token](https://api.tandapay.io/api-reference/endpoint/generate-bearer-token.md): Exchange your keys for a one-hour bearer token.
- [Get user](https://api.tandapay.io/api-reference/endpoint/get-user.md): Your profile, webhook URLs and KES wallet balance.
- [Create checkout session](https://api.tandapay.io/api-reference/endpoint/create-checkout-session.md): Create a hosted checkout link (unified payment SDK) for M-PESA, Airtel Money and bank transfer.
- [Get checkout methods](https://api.tandapay.io/api-reference/endpoint/get-checkout-methods.md): List the payment methods enabled for checkout on your account.
- [Mobile money charge](https://api.tandapay.io/api-reference/endpoint/mobile-money-charge.md): Send an M-PESA or Airtel Money payment prompt to a customer's phone.
- [Bank transfer](https://api.tandapay.io/api-reference/endpoint/bank-transfer.md): Create a temporary virtual account for one bank payment.
- [Validate OTP](https://api.tandapay.io/api-reference/endpoint/validate-otp.md): Submit an OTP for a mobile money charge.
- [Refund deposit](https://api.tandapay.io/api-reference/endpoint/refund-deposit.md): Refund a successful mobile money deposit.
- [Create payout](https://api.tandapay.io/api-reference/endpoint/create-payout.md): Send KES to a wallet, bank account, paybill or till.
- [Create beneficiary](https://api.tandapay.io/api-reference/endpoint/create-beneficiary.md): Save a recipient for repeat payouts.
- [List beneficiaries](https://api.tandapay.io/api-reference/endpoint/list-beneficiaries.md): List your saved beneficiaries.
- [Get beneficiary](https://api.tandapay.io/api-reference/endpoint/get-beneficiary.md): Fetch one saved beneficiary.
- [Update beneficiary](https://api.tandapay.io/api-reference/endpoint/update-beneficiary.md): Change a saved beneficiary's details.
- [Delete beneficiary](https://api.tandapay.io/api-reference/endpoint/delete-beneficiary.md): Remove a saved beneficiary.
- [List transactions](https://api.tandapay.io/api-reference/endpoint/list-transactions.md): List recent transactions, up to 10 per page.
- [Get transaction](https://api.tandapay.io/api-reference/endpoint/get-transaction.md): Fetch one transaction by Tanda ID or your reference.
- [Get banks](https://api.tandapay.io/api-reference/endpoint/get-banks.md): Kenyan banks and the codes to use for bank payouts.
- [Get mobile money providers](https://api.tandapay.io/api-reference/endpoint/get-mobile-money-providers.md): Mobile money networks available on your account.
- [Get phone number operator](https://api.tandapay.io/api-reference/endpoint/get-phone-number-operator.md): Find which network a phone number is on.
- [Account resolver](https://api.tandapay.io/api-reference/endpoint/account-resolver.md): Verify a wallet, bank account, paybill or till and get the registered name.
- [Service status](https://api.tandapay.io/api-reference/endpoint/service-status.md): Current health of collections and payouts.
- [List webhook deliveries](https://api.tandapay.io/api-reference/endpoint/list-webhook-deliveries.md): Find webhook deliveries, including failed ones.
- [Get webhook delivery](https://api.tandapay.io/api-reference/endpoint/get-webhook-delivery.md): Inspect one webhook delivery and your server's response.
- [Resend webhook](https://api.tandapay.io/api-reference/endpoint/resend-webhook.md): Send a webhook delivery again.
- [Simulate webhook](https://api.tandapay.io/api-reference/endpoint/simulate-webhook.md): Fire a test webhook in sandbox.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.