# SandPay

## Docs

- [Create a disbursement](https://docs.sandpay.dev/api-reference/disbursements/create-a-disbursement.md): Free-form payout (merchant → an msisdn), not linked to any prior collection. Debits the merchant float, credits the recipient SIM. No commission is taken. Emits a `disbursement.completed` webhook.
- [Health check](https://docs.sandpay.dev/api-reference/health/health-check.md): Returns a simple `{ ok: true }` payload when the API is reachable.
- [API version & capabilities](https://docs.sandpay.dev/api-reference/meta/api-version-&-capabilities.md): Public capability + version discovery. Feature-detect against `capabilities` rather than assuming a version. Every `/v1/*` response also carries the version in an `X-SandPay-Api-Version` header.
- [Create a payment](https://docs.sandpay.dev/api-reference/payments/create-a-payment.md): Simulate a Mobile Money payment for the given operator / country pair. Pass an explicit `scenario` to deterministically drive the outcome (handy for testing failure paths); omit it to use the default `success` path or to defer to a test_client prompt.
- [List payments](https://docs.sandpay.dev/api-reference/payments/list-payments.md): Cursor-paginated list of payments for the authenticated organisation.
- [Refund a payment](https://docs.sandpay.dev/api-reference/payments/refund-a-payment.md): Refund all or part of a prior SUCCESS collection (merchant → customer). Credits the original payer's SIM and debits the merchant float. No commission is taken — the merchant keeps absorbing the original fee. Omit `amount` for a full refund of the remaining refundable. Emits a `payment.refunded` webh…
- [Retrieve a payment](https://docs.sandpay.dev/api-reference/payments/retrieve-a-payment.md): Fetch a single payment by its transaction id.
- [Vue d'ensemble](https://docs.sandpay.dev/fr/api-reference/overview.md): Base URL, versionnage, rate limits
- [Authentification](https://docs.sandpay.dev/fr/authentication.md): Clés API et en-tête Bearer
- [Erreurs](https://docs.sandpay.dev/fr/errors.md): Codes d'erreur, format de réponse et stratégie de retry
- [Changelog d'intégration](https://docs.sandpay.dev/fr/integration-changelog.md): Historique daté et versionné de chaque modification du contrat d'intégration SandPay — et exactement ce que vous devez faire (le cas échéant) pour rester à jour.
- [FAQ & conseils d'intégration](https://docs.sandpay.dev/fr/integration-faq.md): Réponses aux questions que les intégrateurs rencontrent réellement — webhooks, commission, réconciliation et pièges du développement local.
- [Guide d'intégration](https://docs.sandpay.dev/fr/integration-guide.md): Le contrat de référence, de bout en bout, pour intégrer SandPay correctement — endpoints, statuts, commission, webhooks et l'architecture éprouvée.
- [Mise à niveau & (ré)installation](https://docs.sandpay.dev/fr/integration-upgrade.md): Procédure générique pour installer, réinstaller ou mettre à niveau une intégration SandPay depuis zéro — sans hypothèse sur votre base de code.
- [Introduction](https://docs.sandpay.dev/fr/introduction.md): API Mobile Money sandbox unifiée pour l'Afrique francophone
- [Airtel Money](https://docs.sandpay.dev/fr/operators/airtel.md): Airtel Africa Open API — sandbox openapiuat.airtel.africa
- [Moov Money](https://docs.sandpay.dev/fr/operators/moov.md): Moov Africa Transfer API — sandbox developer.moov-africa.com
- [MTN MoMo](https://docs.sandpay.dev/fr/operators/mtn.md): Collection API de MTN Mobile Money — sandbox momodeveloper.mtn.com
- [Orange Money](https://docs.sandpay.dev/fr/operators/orange.md): Orange Money Webpay — sandbox api.orange.com
- [Démarrage rapide](https://docs.sandpay.dev/fr/quickstart.md): Premier paiement en 10 minutes
- [Scénarios](https://docs.sandpay.dev/fr/scenarios.md): Les 10 scénarios déterministes du sandbox
- [SDKs disponibles](https://docs.sandpay.dev/fr/sdks/comparison.md): Quel SDK pour quel langage, et roadmap
- [SDK Node](https://docs.sandpay.dev/fr/sdks/node.md): @sandpay/node — référence complète
- [Webhooks](https://docs.sandpay.dev/fr/webhooks.md): Recevoir les événements de paiement en push

## OpenAPI Specs

- [sandpay](https://docs.sandpay.dev/openapi/sandpay.yaml)