Aller au contenu
ChadPay
Menu
TESTNET ISOLÉ

Guide de Démarrage en Environnement Sandbox

Validez votre intégration sans risque financier dans l'environnement de test ChadPay. Scénarios USSD simulés, numéros de test dédiés et outillage de diagnostic.

1. Obtenir vos identifiants Sandbox

Chaque compte marchand ChadPay dispose immédiatement d'un environnement Sandbox distinct de la production.

  1. Connectez-vous à votre Espace Marchand ChadPay.
  2. Accédez à la rubrique Développeurs > Clés API.
  3. Cliquez sur Créer une clé sandbox. Votre clé générée commencera par le préfixe cp_test_.
  4. Copiez votre secret en lieu sûr (affiché une seule fois).

2. Numéros de Test & Scénarios Simulateur

En Sandbox, aucun argent réel ne transite et aucun message USSD réel n'est envoyé sur les téléphones. Utilisez les numéros suivants pour simuler les différents retours d'opérateurs (Airtel Money & Moov Money) :

Numéro de téléphone Opérateur simulé Comportement simulé Statut final
+23591595839 Airtel Money Validation client réussie après saisie du code secret PIN. completed
+23566123456 Airtel Money Validation client instantanée (Happy path). completed
+23590000000 Moov Money Refus ou annulation du paiement par l'acheteur sur son téléphone. failed (payment_refused)
+23592000000 Airtel Money Solde du portefeuille mobile de l'acheteur insuffisant. failed (insufficient_funds)
+23593000000 Moov / Airtel Expiration du délai d'attente USSD opérateur (Timeout). status_to_confirm

3. Passage en Production (LIVE)

Pour activer vos clés de production cp_live_... et encaisser de l'argent réel auprès de vos clients en zone CEMAC :

Étape 1

Dossier KYC / Conformité

Fournissez les pièces légales de votre entreprise tchadienne ou de la zone CEMAC (RCCM, NIF, pièce d'identité du représentant légal).

Étape 2

Validation Technique

L'équipe technique ChadPay vérifie la bonne implémentation des devis, de l'idempotence et de la vérification des signatures webhooks.

Étape 3

Activation Contrôlée

Activation du compte en production avec plafonds d'encaissement progressifs et surveillance continue 24/7.