Tchin Docs

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 minutes

Deux 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

  1. 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.
  2. Faites vos essais avec "env": "test" : le parcours est identique, aucun argent ne circule.
  3. 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
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
GET /api/v1/methods Essayer avec vos clés
Vos clés se trouvent dans votre espace, onglet API.

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

Votre premier encaissement

Le chemin le plus court : vous créez le paiement, nous renvoyons une adresse, vous y envoyez votre client.

cURL
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"
      }'
Réponse
{
  "success": true,
  "token": "inv_9d3f7a21c4",
  "payment_url": "https://tchin.tech/pay/9d3f7a21c4",
  "env": "test"
}
POST /api/v1/payments Essayer
Vos clés se trouvent dans votre espace, onglet API.

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é

SujetValeur
Base de l'APIhttps://tchin.tech/api/v1
Débit autorisé120 requêtes/minute par clé, 300/minute par adresse IP
DeviseXOF (FCFA), montants entiers ; crypto en décimal
Pays couvertsTogo, Bénin, Burkina Faso (applications d'avant le 2 octobre 2026 : anciens pays jusqu'au 1er novembre 2026)
CryptosUSDT (TRC-20), TRX, BNB (BNB Smart Chain), SOL
Depuis un navigateurImpossible — l'API n'accepte que nos propres origines. Appelez-la depuis votre serveur.
Base API https://tchin.tech/api/v1 Retour au sommaire