Démarrer

L'API Tchin

Encaissez et décaissez en mobile money dans sept pays d'Afrique de l'Ouest et centrale, depuis votre site ou votre application. Une seule intégration couvre tous les opérateurs — vous n'avez pas à traiter avec chacun d'eux.

Trois étapes pour commencer

1. Créez une application dans votre espace Tchin, onglet API. 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 -H "TCHIN-PUBLIC-KEY: tchin_pk_xxxxxxxx" \
     -H "TCHIN-PRIVATE-KEY: tchin_sk_xxxxxxxx" \
     -H "Accept: application/json" \
  https://tchin.tech/api/v1/methods

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 -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"
}

Quatre règles qui évitent les ennuis

Limites et disponibilité