Skip to main content
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, 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 : Utilisez un numéro complet et plausible pour vos tests (ex. 0197234560 pour un succès), pas une suite de zéros.
Réponse (HTTP 201)
Le numéro se termine par 0 : interrogez /api/v1/payments/{id}/verify/ juste après, le statut passe à SUCCESS sans délai.
Réponse de (HTTP 200, abrégée)

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é

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.