Démarrer
L'API Tchin
Encaissez et décaissez en Mobile Money au Togo, au Bénin et au Burkina Faso, et en crypto (USDT, TRON, BNB, Solana), depuis votre site ou votre application. Une seule intégration couvre tous les réseaux — vous n'avez pas à traiter avec chacun d'eux.
Commencez par comprendre le système
5 minutesDeux canaux par opérateur, un solde par pays qui se partage entre voisins, ce qui arrive quand un versement échoue. Six points qui évitent la quasi-totalité des mauvaises surprises.
Trois étapes pour commencer
- Créez une application dans votre espace Tchin, onglet API. Vous y choisissez ce que vos clients peuvent utiliser (Mobile Money, crypto, ou les deux) et qui paie les frais — des paiements et des retraits. Vous obtenez une paire de clés.
- Faites vos essais avec
"env": "test": le parcours est identique, aucun argent ne circule. - Branchez votre webhook, vérifiez la signature, puis passez en
live.
S'authentifier
Chaque appel porte vos deux clés en en-têtes. Elles vivent sur votre serveur : jamais dans une page web, jamais dans une application mobile, jamais dans un dépôt de code. Quiconque les possède peut encaisser et décaisser à votre place.
curl -H "TCHIN-PUBLIC-KEY: tchin_pk_xxxxxxxx" \
-H "TCHIN-PRIVATE-KEY: tchin_sk_xxxxxxxx" \
-H "Accept: application/json" \
https://tchin.tech/api/v1/methods
/api/v1/methods
Essayer avec vos clés
Utilisez vos clés de test : en mode test aucun argent ne circule. Vos clés restent dans ce navigateur — elles ne sont ni enregistrées ni transmises à un tiers. Dans votre intégration réelle, les clés doivent rester sur votre serveur, jamais dans une page.
Quel parcours choisir
Page de paiement
Une requêteAvec redirection : vous créez le paiement, notre page propose Mobile Money et/ou crypto. Le plus rapide à intégrer.
Paiement direct
Trois requêtesSans redirection : votre propre écran, les moyens lus chez nous. Le client ne quitte jamais votre site.
Payer en crypto
CryptoUSDT, TRON, BNB, Solana : un montant exact et votre adresse, la commande passe toute seule.
Abonnements
RécurrentUn montant fixe prélevé tous les mois, trimestres, semestres ou années.
Décaissement
SortantEnvoyer de l’argent vers un numéro Mobile Money depuis votre solde.
Retraits en crypto
SortantEnvoyer de la crypto depuis votre solde crypto vers n’importe quelle adresse.
Votre premier encaissement
Le chemin le plus court : vous créez le paiement, nous renvoyons une adresse, vous y envoyez votre client.
curl -X POST https://tchin.tech/api/v1/payments \
-H "TCHIN-PUBLIC-KEY: tchin_pk_xxxxxxxx" \
-H "TCHIN-PRIVATE-KEY: tchin_sk_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"amount": 5000,
"description": "Commande CMD-1042",
"env": "test",
"return_url": "https://votre-site.com/merci",
"callback_url": "https://votre-site.com/webhook/tchin"
}'
{
"success": true,
"token": "inv_9d3f7a21c4",
"payment_url": "https://tchin.tech/pay/9d3f7a21c4",
"env": "test"
}
/api/v1/payments
Essayer
Utilisez vos clés de test : en mode test aucun argent ne circule. Vos clés restent dans ce navigateur — elles ne sont ni enregistrées ni transmises à un tiers. Dans votre intégration réelle, les clés doivent rester sur votre serveur, jamais dans une page.
Quatre règles qui évitent les ennuis
Ne livrez que sur un webhook signé
La réponse à un appel dit « la demande est partie », pas « l'argent est arrivé ».
Attendez completed et vérifiez la signature.
Traitez chaque token une seule fois
Un webhook peut arriver en double. Le champ token est votre clé d'idempotence.
Regardez le champ mode
Un webhook test ne doit rien déclencher de réel. C'est l'oubli le plus courant.
Les montants sont des entiers, en FCFA
Pas de décimales, pas d'espaces. 5000 vaut cinq mille francs. Seuls les
montants en crypto (bloc crypto, retraits en crypto) sont décimaux.
Limites et disponibilité
| Sujet | Valeur |
|---|---|
| Base de l'API | https://tchin.tech/api/v1 |
| Débit autorisé | 120 requêtes/minute par clé, 300/minute par adresse IP |
| Devise | XOF (FCFA), montants entiers ; crypto en décimal |
| Pays couverts | Togo, Bénin, Burkina Faso (applications d'avant le 2 octobre 2026 : anciens pays jusqu'au 1er novembre 2026) |
| Cryptos | USDT (TRC-20), TRX, BNB (BNB Smart Chain), SOL |
| Depuis un navigateur | Impossible — l'API n'accepte que nos propres origines. Appelez-la depuis votre serveur. |
https://tchin.tech/api/v1
Retour au sommaire