Versements directs - Documentation Tchin

Astuce

Pour un client qui choisit lui-même où recevoir, utilisez plutôt Recevoir.

Vers un numéro Mobile Money

Deux appels : préparer, puis envoyer.

POST/api/v1/disburse/initiateprépare le versement

Champ	Type	Description
`account_alias`	texte	obligatoire. Le numéro, sans indicatif (« 90112233 »).
`amount`	entier	obligatoire. Ce que le destinataire reçoit, en F CFA (200 minimum).
`withdraw_mode`	texte	obligatoire. Le réseau : `t-money-togo`, `moov-togo`, `mtn-benin`, `moov-benin`, `orange-money-burkina`, `moov-burkina`…
`callback_url`	URL	votre webhook pour ce versement.

curl -X POST https://tchin.tech/api/v1/disburse/initiate \
  -H "TCHIN-PUBLIC-KEY: tchin_pk_..." -H "TCHIN-PRIVATE-KEY: tchin_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"account_alias": "90112233", "amount": 5000, "withdraw_mode": "t-money-togo",
       "callback_url": "https://wintg.group/webhook-tchin"}'

La réponse donne un disburse_token. Envoyez-le :

POST/api/v1/disburse/submit{ "disburse_token": "…" } : envoie l’argent

POST/api/v1/disburse/status{ "disburse_token": "…" } : l’état

Les frais (3,4 %) suivent le réglage de votre application : par défaut, ils s'ajoutent et votre solde paie le montant plus les frais.

Vers une adresse crypto

POST/api/v1/payouts/cryptoenvoie depuis votre solde crypto

Champ	Type	Description
`currency`	texte	obligatoire. `USDT`, `TRX`, `BNB` ou `SOL`.
`address`	texte	obligatoire. L’adresse du destinataire, sur le bon réseau.
`amount`	nombre	obligatoire. La quantité de crypto.
`reference`	texte	obligatoire. Votre référence unique : la même référence n’envoie qu’une fois.
`callback_url`	URL	votre webhook.

GET/api/v1/payouts/crypto/{id}l’état et la transaction sur le réseau

Attention

Un envoi en crypto ne s’annule pas : vérifiez l’adresse et le réseau (USDT : réseau TRON, TRC-20).

Votre solde

GET/api/v1/balancevos soldes par pays et en crypto

Réponse

{
  "success": true,
  "currency": "XOF",
  "total": 418500,
  "balances": [
    { "country": "TG", "name": "Togo", "balance": 250000 },
    { "country": "BJ", "name": "Bénin", "balance": 168500 },
    { "country": "BF", "name": "Burkina Faso", "balance": 0 }
  ],
  "crypto": { "USDT": 120.5, "TRX": 2400, "BNB": 0.12, "SOL": 1.4 }
}