> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sandpay.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> API Mobile Money sandbox unifiée pour l'Afrique francophone

SandPay est une API Mobile Money sandbox unifiée qui couvre **MTN, Orange, Moov et Airtel** sur quatre marchés africains (Côte d'Ivoire, Bénin, Togo, Rwanda). Une seule surface d'API, une seule clé, des réponses déterministes, des temps de latence réalistes — et aucune somme d'argent qui circule réellement.

## Pour qui ?

SandPay s'adresse aux équipes qui intègrent du Mobile Money en Afrique et qui veulent **exercer le chemin critique** (succès, PIN invalide, solde insuffisant, timeouts, opérateur en maintenance…) en toute sécurité. Plutôt que de jongler avec quatre portails développeurs, quatre formats d'authentification et quatre schémas d'erreurs distincts, vos applications parlent à `api.sandpay.dev` et SandPay traduit en interne.

## Pourquoi un sandbox unifié ?

Chaque opérateur a son propre portail, ses propres formats OAuth, ses propres codes d'erreur natifs (`PIN_INVALID` chez MTN, `INSUFFICIENT_FUNDS` chez Orange…). SandPay normalise tout cela en 11 statuts canoniques (`SUCCESS`, `PIN_INVALID`, `INSUFFICIENT_FUNDS`, `TIMEOUT`, …) et 10 scénarios reproductibles que vous déclenchez via un simple champ `scenario` dans la requête.

## Vous voulez démarrer ?

<Tip>
  **Nouveau** : essayez le [Stack Builder](/fr/quickstart) pour un setup sans copy-paste — vous téléchargez un starter zip pré-rempli avec vos clés et lancez `./setup.sh`.
</Tip>

<CardGroup cols={2}>
  <Card title="Démarrage rapide" icon="rocket" href="/fr/quickstart">
    Premier paiement simulé en 10 minutes — Stack Builder (zip starter) ou intégration manuelle.
  </Card>

  <Card title="Référence API" icon="book" href="/fr/api-reference/overview">
    Endpoints, schémas, codes d'erreur — la spec complète.
  </Card>
</CardGroup>

<Tip>
  Tout est simulé en sandbox — aucune somme d'argent ne circule. Chaque clé `sp_sk_test_...` produit des transactions simulées sans coût.
</Tip>