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

# Mode Sandbox

> Testez votre intégration sans argent réel, sans vérification KYC, avec des numéros de test déterministes.

Le sandbox est un **environnement entièrement séparé** de la production — pas juste un type de clé API différent sur la même base. Base de données propre, pas de KYC, aucun appel à un vrai opérateur mobile money ou à une vraie carte bancaire.

## Créer un compte sandbox

Un compte sandbox est **différent de votre compte de production** — même avec un compte AlphaPay existant, vous devez créer un compte séparé (email + mot de passe, aucun document KYC requis, approbation immédiate).

Depuis votre tableau de bord [app.alphapay.me](https://app.alphapay.me), le menu de votre compte propose un sélecteur **Sandbox / Live**. Passer en Sandbox vous déconnecte et vous redirige vers la création/connexion d'un compte sandbox dédié.

## Numéros magiques

Le **dernier chiffre** du numéro de téléphone (ou de la carte bancaire simulée) que vous utilisez pour tester détermine le résultat — peu importe le réseau ou le pays :

| Dernier chiffre | Résultat |
| - | - |
| `0` | Succès |
| `1` | Échec (générique) |
| `2` | Solde insuffisant |
| `9` | Reste en attente indéfiniment (utile pour tester le polling/timeout de votre côté) |
| tout autre chiffre | Succès par défaut |

Utilisez un numéro complet et plausible pour vos tests (ex. `0197234560` pour un succès), pas une suite de zéros.

```bash theme={null}
curl -X POST https://sandbox-api.alphapay.me/api/v1/payments/softpay/ \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1000.00",
    "currency": "XOF",
    "country": "BJ",
    "network": "mtn_bj",
    "description": "Test sandbox",
    "customer": {
      "email": "client@example.com",
      "first_name": "Awa",
      "last_name": "Sossou",
      "phone": "+2290197234560"
    }
  }'
```

```json Réponse (HTTP 201) theme={null}
{
  "success": true,
  "data": {
    "message": "Payment pushed successfully",
    "id": "a8a8c2cf-b211-4564-8588-bae1e6dde8e9",
    "status": "PENDING",
    "checkout_url": "",
    "instructions": []
  },
  "code": 201
}
```

Le numéro se termine par `0` : interrogez `/api/v1/payments/{id}/verify/` juste après, le statut passe à `SUCCESS` sans délai.

```json Réponse de /verify/ (HTTP 200, abrégée) theme={null}
{
  "success": true,
  "data": {
    "id": "a8a8c2cf-b211-4564-8588-bae1e6dde8e9",
    "status": "SUCCESS",
    "net_amount": "1000.00",
    "currency": "XOF",
    "external_reference": "sbx-success-a05ed1c0bd444767964d"
  },
  "code": 200
}
```

## Ce qui n'existe pas en sandbox

* Pas de KYC — tout compte est vérifié automatiquement à l'inscription.
* Pas de retraits/Settlements ni de Support — ces fonctionnalités nécessitent une intervention admin, absente du sandbox.
* Pas d'appel réseau réel à un opérateur mobile money ou à une carte bancaire — tout est simulé.

## Ce qui détermine le sandbox, ce n'est PAS le préfixe de clé

> [!WARNING]
>
> Le bascule sandbox/production se fait **par l'URL de base appelée** (`sandbox-api.alphapay.me` contre `api.alphapay.me`), jamais par le préfixe `sk_test_`/`sk_live_` de la clé. Ce préfixe est une étiquette, pas une protection. Une clé marquée `sk_test_` appelée sur `api.alphapay.me` (production) y traite de l'argent réel, exactement comme une clé `sk_live_`. Vérifiez toujours l'URL de base que vous appelez.

## Checkout hébergé en sandbox

Les sessions de checkout créées via `sandbox-api.alphapay.me` renvoient un `checkout_url` sur `sandbox-checkout.alphapay.me` au lieu du domaine de production — votre code d'intégration n'a rien à changer, l'URL de base que vous appelez fait toute la différence.


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