1. Votre compte
- Identité vérifiée : elle est déjà faite si vous avez pu créer votre application. Pour une entreprise, le type de compte Business ouvre aussi le paiement en caisse et le multi-envoi.
- Tchin PIN défini (Paramètres › Sécurité) : il confirme vos retraits et l'affichage de vos clés. Ajoutez la biométrie sur votre téléphone si vous voulez aller plus vite.
- Notifications : gardez les e-mails d'encaissement et de décaissement (Paramètres › Notifications). Ce sont vos reçus.
2. Votre application
- Une image nette et un nom que vos clients reconnaissent : ils les voient dans la feuille, au moment de payer.
- Les moyens que vous voulez vraiment proposer (Mobile Money, crypto, compte Tchin). Un moyen coché est un moyen que vos clients verront.
- Qui paie les frais, à l'encaissement et au versement : décidez-le avant, il change le prix payé ou le montant reçu. Voir les frais.
- L'adresse du webhook par défaut, en HTTPS, si vous ne la donnez pas à chaque appel.
3. Votre code
| Point | Vérifié quand |
|---|---|
Les clés | lues dans les variables d’environnement du serveur ; absentes du code, du dépôt Git, des pages et des applications |
Le mode | "env": "live" sur chaque création (le défaut de POST /payments est test) |
Un paiement par commande | le token est enregistré avec la commande dès sa création |
La livraison | seulement quand le webhook signé (ou la lecture de l’état) dit completed, avec le bon montant et "mode": "live" |
Une seule fois | un webhook reçu deux fois ne livre pas deux fois (vous gardez la trace des références traitées) |
La signature | vérifiée avec la clé secrète ; un webhook de plus de 10 minutes est refusé |
La réponse au webhook | 200 en moins de 10 secondes ; le travail long se fait après |
Les erreurs | le message de Tchin est montré ou journalisé ; les réessais ne se font que sur 429 et 5xx |
4. Le premier paiement réel
- Créez un paiement réel de 100 F (le minimum), avec
"env": "live". - Payez-le vous-même, avec votre propre numéro Mobile Money ou votre compte Tchin.
- Vérifiez que le webhook arrive avec
"status": "completed"et"mode": "live", que votre commande passe « payée » une seule fois, et que l'argent apparaît sur votre solde Tchin (Transactions). - Si vous versez de l'argent (Recevoir ou versements directs), faites de même avec un petit versement vers votre propre numéro.
Astuce
Le paiement de 100 F vous coûte les frais du moyen choisi (4 F en Mobile Money, frais à votre charge). Entre deux comptes Tchin, il ne coûte rien.
5. Le suivi au quotidien
- Transactions (tchin.tech) : chaque paiement, chaque versement, avec son état, ses frais et le moyen utilisé. Le relevé mensuel arrive par e-mail si vous l'avez activé.
- Webhooks manqués : si votre serveur était en panne, Tchin a essayé 5 fois en tout (tout de suite, puis 10 secondes, 1 minute, 5 minutes et 15 minutes plus tard). Au-delà, relisez l'état avec
GET /api/v1/payments/{token}/statuspour les commandes restées en attente. - Moyens en pause : un réseau peut être coupé quelques minutes chez l'opérateur. La feuille le grise d'elle-même ;
GET /api/v1/methodsle dit (available,payout_available). - Letou, l'assistant de votre compte, répond sur vos ventes, cherche un paiement, explique un échec et vous aide sur le code.
6. En cas de besoin
Écrivez-nous sur WhatsApp au +228 73 38 49 90 avec le token (ou la reference) de l'opération, l'heure et le message reçu : nous retrouvons tout de suite l'opération. Ne nous envoyez jamais votre clé secrète.
