Démarrer

Moyens de paiement

Sept pays, vingt-et-un opérateurs. Cet appel vous donne la liste à jour — utilisez-le pour construire votre écran plutôt que de coder les opérateurs en dur : nous en ajoutons, et un opérateur peut tomber en panne.

Chaque opérateur y porte deux disponibilités, une par sens : encaisser et verser sont deux canaux distincts, qui tombent séparément. Voir Comment ça marche.

cURL

curl -H "TCHIN-PUBLIC-KEY: tchin_pk_xxxxxxxx" \
     -H "TCHIN-PRIVATE-KEY: tchin_sk_xxxxxxxx" \
  https://tchin.tech/api/v1/methods

JSON

{
  "success": true,
  "countries": [
    {
      "country": "TG",
      "country_name": "Togo",
      "dial": "+228",
      "methods": [
        {
          "code": "t-money-togo",
          "name": "Yas",
          "flow": "push",
          "needs_otp": false,
          "available": true,
          "payout_available": true,
          "subscription_eligible": true
        }
      ]
    }
  ]
}

GET /api/v1/methods Essayer

Clé publique Clé privée

Garder les clés dans ce navigateur

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.

Les champs qui comptent

Champ	À quoi il sert
`code`	Ce que vous envoyez dans `operator` ou `withdraw_mode`.
`flow`	Comment le client valide. Détermine ce que vous affichez ensuite.
`needs_otp`	Raccourci pour `flow === "otp"`.
`available`	Peut-il ENCAISSER en ce moment ? À `false`, grisez-le sur votre page de paiement.
`payout_available`	Peut-il RECEVOIR un versement en ce moment ? À `false`, refusez-le comme destination de décaissement. Les deux champs sont indépendants.
`subscription_eligible`	Prélèvement automatique possible. Voir Abonnements.

Ne demander que ce qui vous sert

Le paramètre ?for= filtre la liste pour vous, plutôt que de vous laisser trier vous-même :

Appel	Ce que vous obtenez
`/methods`	Tout, avec les deux disponibilités. Pour votre page de paiement.
`/methods?for=payout`	Seulement les réseaux qui acceptent un versement maintenant. Pour votre écran de décaissement.
`/methods?for=subscription`	Seulement ceux qui se prélèvent sans le client devant l'écran. Pour vos abonnements.

GET /api/v1/methods?for=payout Voir qui verse en ce moment

Clé publique Clé privée

Garder les clés dans ce navigateur

Vos clés se trouvent dans votre espace, onglet API.

Comment nous le savons

Nous interrogeons chaque réseau toutes les minutes, dans les deux sens, sans déplacer un franc. Un canal qui ne répond plus passe à false en moins d'une minute ; dès qu'il se rétablit, il repasse à true tout seul. Vous n'avez rien à redéployer, et nous prévenons par message les comptes vérifiés quand un canal tombe ou revient.

Les trois façons de valider

push

Confirmation sur le téléphone

Le client reçoit une demande et valide avec son code secret.

otp

Code à composer

Le client compose un code USSD, reçoit un code, vous le saisissez.

redirect

Redirection

Le client valide dans l’application de son opérateur.

En paiement direct, ces trois cas correspondent aux trois valeurs du champ action. Sur la page hébergée, nous les gérons pour vous.

La liste complète

Générée depuis notre configuration, et l'état des canaux est celui de cette minute : ce que vous voyez ici est ce que l'API vous répondrait à l'instant. Rechargez la page pour rafraîchir.

Burkina Faso

BF · +226

Orange Money
orange-money-burkina
Code à composer
Moov
moov-burkina
Confirmation sur le téléphone Abonnement

Bénin

BJ · +229

Moov
moov-benin
Confirmation sur le téléphone Abonnement
MTN
mtn-benin
Confirmation sur le téléphone Abonnement
Celtiis Cash
celtiis-benin
Confirmation sur le téléphone Abonnement

Côte d’Ivoire

CI · +225

Orange Money
orange-money-ci
Code à composer
MTN
mtn-ci
Confirmation sur le téléphone Abonnement
Moov
moov-ci
Confirmation sur le téléphone Abonnement
Wave
wave-ci
Redirection
Djamo
djamo-ci
Redirection

Cameroun

CM · +237

MTN
mtn-cameroun
Confirmation sur le téléphone Abonnement

Mali

ML · +223

Orange Money
orange-money-mali
Confirmation sur le téléphone Abonnement
Moov
moov-mali
Ne verse pas Confirmation sur le téléphone Abonnement

Sénégal

SN · +221

Orange Money
orange-money-senegal
Redirection
Yas
free-money-senegal
Confirmation sur le téléphone Abonnement
Wave
wave-senegal
Redirection
Wizall
wizall-senegal
Confirmation sur le téléphone Abonnement
Djamo
djamo-senegal
Redirection

Togo

TG · +228

Yas
t-money-togo
Confirmation sur le téléphone Abonnement
Moov
moov-togo
Confirmation sur le téléphone Abonnement

Gris comment le client valide Vert abonnement possible Orange canal coupé en ce moment

Une mention orange ne veut pas dire que l'opérateur est retiré : le canal est indisponible chez notre fournisseur, et il redeviendra actif tout seul. C'est précisément pour ces moments-là que available et payout_available existent.

Trois conseils

Ne codez pas la liste en dur. Appelez /methods au chargement de votre page de paiement, et mettez-la en cache quelques minutes.
Respectez les deux drapeaux. available pour encaisser, payout_available pour verser. Proposer un canal coupé, c'est un paiement perdu et un client mécontent.
L'opérateur doit correspondre au pays. mtn-ci avec country: "TG" est refusé en 422.

Base API https://tchin.tech/api/v1 Retour au sommaire