Sandbox et production

Chaque application pismile appartient à un environnement : sandbox pour développer et tester, production pour vos vrais utilisateurs. Votre code est le même dans les deux cas : seuls le client_id, le secret et les adresses de redirection changent.

Les différences#

Tester une connexion en sandbox#

En sandbox, aucune vraie banque n'intervient. Vous utilisez les alias de test fournis par le sandbox PI-SPI de la BCEAO et vous confirmez vous-même la demande de paiement que pismile envoie.

1. Créez votre compte sur le sandbox PI-SPI

   Rendez-vous sur pispi.bceao.int et créez un compte sur l'espace développeurs de la BCEAO.

2. Récupérez vos alias de test

   Dans le sandbox BCEAO, notez un ou plusieurs alias de test : ce sont eux que vous saisirez sur pismile à la place d'un vrai numéro.

3. Lancez la connexion depuis votre application

   Cliquez sur Se connecter avec pismile dans votre application sandbox, puis saisissez un alias de test. pismile envoie une demande de paiement de 1 FCFA vers cet alias et attend la confirmation pendant 3 minutes.

4. Confirmez la demande dans le playground

   Ouvrez le playground du sandbox BCEAO, listez les demandes de paiement reçues par votre alias de test et confirmez celle de pismile.

5. Retour sur votre application

   pismile reçoit la confirmation, affiche l'écran de consentement puis renvoie l'utilisateur de test sur votre site, connecté, avec le nom associé à l'alias de test.

Passer en production#

1. Faites vérifier votre organisation

   Depuis la console, envoyez le dossier de votre entreprise (raison sociale, identifiants comme le RCCM, représentant légal, pièces justificatives). L'équipe pismile l'examine et vous informe de sa décision.

2. Vérifiez vos domaines

   Ajoutez dans la console les domaines de votre site, puis prouvez que vous les contrôlez. Seules des adresses https sur ces domaines seront acceptées comme adresses de redirection.

3. Créez votre application de production

   Dans Applications, créez une nouvelle application, environnement Production, avec vos adresses de redirection définitives. Vous obtenez un nouveau client_id et un nouveau secret, affiché une seule fois : copiez-le immédiatement.

4. Remplacez vos identifiants

   Dans la configuration de votre serveur de production, remplacez le client_id et la variable PISMILE_CLIENT_SECRET. Aucune autre ligne de code ne change.

5. Choisissez votre plan

   En production, chaque vérification d'alias est décomptée du quota mensuel de votre plan. Comparez les formules sur la page Tarifs et souscrivez depuis Plan et usage dans la console, par Mobile Money ou carte.

Bonnes pratiques#

• Gardez votre application sandbox après la mise en ligne : elle reste votre environnement de test, sans consommer votre quota.

• N'utilisez jamais de vrais alias dans vos tests automatisés : servez-vous des alias de test du sandbox BCEAO.

• Ne réutilisez jamais un secret de production en local.

• Si un secret a fuité ou a été perdu, régénérez-le immédiatement depuis la console : l'ancien cesse de fonctionner.