Décaisser

Envoyer de la crypto

Rembourser un client, payer un fournisseur ou vider votre solde vers votre propre portefeuille : vous envoyez de la crypto depuis votre solde crypto Tchin (alimenté par les paiements en crypto de vos clients) vers n'importe quelle adresse. En USDT (TRC-20), TRON (TRX), BNB (BNB Smart Chain) ou Solana (SOL). Un seul appel : l'envoi part tout seul.

Qui paie les frais ? C'est un réglage de votre application (onglet API → les frais des retraits). À votre charge : l'adresse reçoit exactement amount, les frais s'ajoutent au débit. À la charge du destinataire : amount quitte votre solde et l'adresse reçoit amount − frais.

Les frais

Les frais Tchin du retrait en crypto (1 %, page Tarifs), plus le vrai coût du réseau mesuré au moment de l'envoi (+ 5 %). Pour l'USDT, ce coût est de l'énergie TRON : quelques TRX (davantage si l'adresse n'a jamais reçu d'USDT), convertis en USDT. Pour le TRON, une adresse jamais utilisée coûte en plus son activation (environ 1,16 TRX). BNB et Solana coûtent presque rien. La réponse vous donne toujours amount, fee et debited.

Envoyer

cURL

curl -X POST https://tchin.tech/api/v1/payouts/crypto \
  -H "TCHIN-PUBLIC-KEY: tchin_pk_xxxxxxxx" \
  -H "TCHIN-PRIVATE-KEY: tchin_sk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
        "currency":     "USDT",
        "address":      "TAhiMRY4t45skgoUgDAWByxSNdoz8UdQgL",
        "amount":       25,
        "reference":    "remboursement-CMD-1042",
        "callback_url": "https://votre-site.com/webhook/tchin"
      }'

Champ	Obligatoire	Détail
`currency`	oui	`USDT`, `TRX`, `BNB` ou `SOL`. Si votre application accepte la crypto, `/methods?for=payout` vous dit lesquelles versent en ce moment (bloc `cryptos`).
`address`	oui	L'adresse qui reçoit, sur le réseau de la crypto (TRON pour USDT et TRX).
`amount`	oui	Dans la crypto (ex. `25` USDT, `0.01` BNB). Minimum : 5 USDT, 5 TRX, 0,001 BNB, 0,005 SOL.
`reference`	oui	Votre clé d'idempotence : la même référence renvoie le même retrait, jamais un deuxième envoi.
`callback_url`	non	Où nous vous prévenons du résultat. Par défaut, le webhook de l'application.

JSON

{
  "success": true,
  "payout_id": "da672bef-7e34-4b4b-bfb9-acaaef5e47ad",
  "reference": "remboursement-CMD-1042",
  "status": "sent",           // pending → sent → completed (ou failed)
  "currency": "USDT",
  "address": "TAhiMRY4t45skgoUgDAWByxSNdoz8UdQgL",
  "amount": 25,               // ce que l'adresse reçoit
  "debited": 27.457151,       // ce qui quitte votre solde crypto
  "fee": 2.457151,            // frais Tchin + coût du réseau
  "txid": "763fe77f…",
  "explorer": "https://tronscan.org/#/transaction/763fe77f…",
  "created_at": "2026-10-02T10:59:41+00:00"
}

POST /api/v1/payouts/crypto Essayer

Clé publique Clé privée

Garder les clés dans ce navigateur Corps de la requête (JSON)

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.

Statuts

`status`	Ce que ça veut dire
`pending`	Débité, pas encore parti (le réseau ne répondait pas, ou notre portefeuille se recharge). Il partira tout seul.
`sent`	Parti sur le réseau (`txid` et `explorer` renseignés), pas encore dans un bloc.
`completed`	Dans un bloc : l'adresse l'a reçu.
`failed`	Refusé par le réseau : votre solde crypto est recrédité du montant débité.

Suivre

cURL

curl https://tchin.tech/api/v1/payouts/crypto/da672bef-7e34-4b4b-bfb9-acaaef5e47ad \
  -H "TCHIN-PUBLIC-KEY: tchin_pk_xxxxxxxx" \
  -H "TCHIN-PRIVATE-KEY: tchin_sk_xxxxxxxx"

Le webhook de décaissement ("kind": "payout") arrive à completed et à failed, avec un bloc crypto :

JSON

{
  "response_code": "00",
  "kind": "payout",
  "status": "completed",
  "token": "usdtout_…",
  "amount": 15990,          // en FCFA, au cours du moment
  "fee": 1430,
  "net": 14560,
  "currency": "XOF",
  "method": "crypto-usdt",
  "mode": "live",
  "crypto": {
    "currency": "USDT",
    "sent":     25,          // ce que l'adresse reçoit
    "debited":  27.457151,   // ce qui a quitté votre solde crypto
    "address":  "TAhiMRY4t45skgoUgDAWByxSNdoz8UdQgL",
    "txid":     "763fe77f…"
  },
  "timestamp": 1790000000,
  "signature": "…"
}

Refus possibles

Solde insuffisant — votre solde crypto dans cette crypto (voir Solde, bloc crypto).
Adresse invalide, adresse de Tchin, ou (BNB) adresse de contrat.
Plafond — 1 000 000 F de retraits crypto par 24 heures et par compte, toutes cryptos.
« Momentanément indisponible » — notre portefeuille se recharge : réessayez dans quelques minutes. Rien n'est débité.

Ce que nous garantissons

Jamais deux envois pour une même reference, même si vous rappelez pendant une coupure.
Remboursé seulement si rien n'est parti : un envoi perdu par le réseau est rediffusé à l'identique avant toute autre décision.
Une crypto envoyée est définitive : vérifiez l'adresse et le réseau avant d'appeler.

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