Décaisser

Consulter votre solde

Votre argent est réparti par pays : ce que vous encaissez au Togo reste sur le solde Togo, et c'est de lui que partiront vos déboursements togolais. Cet appel vous donne le détail.

curl -H "TCHIN-PUBLIC-KEY: tchin_pk_xxxxxxxx" \
     -H "TCHIN-PRIVATE-KEY: tchin_sk_xxxxxxxx" \
     -H "Accept: application/json" \
  https://tchin.tech/api/v1/balance

{
  "success":  true,
  "currency": "XOF",
  "total":    125000,
  "balances": [
    { "country": "SN", "name": "Sénégal",       "balance": 60000 },
    { "country": "CI", "name": "Côte d’Ivoire", "balance": 25000 },
    { "country": "BJ", "name": "Bénin",         "balance": 15000 },
    { "country": "BF", "name": "Burkina Faso",  "balance": 10000 },
    { "country": "TG", "name": "Togo",          "balance":  8000 },
    { "country": "ML", "name": "Mali",          "balance":  5000 },
    { "country": "CM", "name": "Cameroun",      "balance":  2000 }
  ]
}

Pourquoi un solde par pays

Chaque opérateur détient les fonds dans son pays. Payer un vendeur ivoirien avec de l'argent encaissé au Sénégal suppose donc un mouvement préalable entre les deux comptes — ce n'est pas une écriture, c'est un vrai virement.

Deux zones monétaires distinctes coexistent : le FCFA UEMOA (Sénégal, Côte d'Ivoire, Bénin, Burkina, Togo, Mali) et le FCFA CEMAC (Cameroun). Aucun mouvement n'est possible de l'une à l'autre — ce sont deux monnaies différentes.

Vos soldes UEMOA se partagent

À l'intérieur de la zone UEMOA, un solde vide ne bloque plus rien. Si vous demandez un décaissement au Togo et que le solde Togo ne suffit pas, nous rapatrions le complément depuis vos autres soldes de la zone, puis le versement part normalement. Vous n'avez rien à demander.

Ce que /balance vous montre reste donc la vérité pays par pays : c'est ce que vous détenez réellement à chaque endroit. Pour savoir ce qu'un pays peut réellement payer une fois la zone mise à contribution, tentez le décaissement — en cas de refus, le champ available_zone vous donne le plafond exact, frais déduits.

Un usage utile

Surveiller un pays isolé n'a plus grand sens : c'est la trésorerie de la zone qui décide si vos versements passent.

<?php
// Surveiller la ZONE, pas un pays isolé : un solde Togo à zéro n'empêche plus
// un versement togolais tant que le reste de l'UEMOA peut le couvrir.
const UEMOA = ['SN', 'CI', 'BJ', 'BF', 'TG', 'ML'];

function soldeZone(array $pays): int
{
    $d = appelTchin('GET', '/balance');
    $total = 0;
    foreach ($d['balances'] as $b) {
        if (in_array($b['country'], $pays, true)) {
            $total += (int) $b['balance'];
        }
    }

    return $total;
}

// Le rapatriement coûte 1,5 % : gardez une marge au-dessus de vos besoins.
if (soldeZone(UEMOA) < 500000) {
    alerterEquipe('Trésorerie UEMOA basse : les versements du jour vont coincer.');
}

// Le Cameroun ne partage avec personne : il se surveille à part.
if (soldeZone(['CM']) < 100000) {
    alerterEquipe('Solde Cameroun bas.');
}

À savoir

• Les montants sont des entiers en FCFA, déjà nets de nos frais.
• Un pays où vous n'avez jamais encaissé renvoie 0 — ce n'est pas une erreur.
• Le solde bouge en temps réel : un encaissement confirmé s'y voit immédiatement.
• Un décaissement peut faire baisser un autre solde que celui du pays visé : c'est le rapatriement de zone, et il est tracé dans votre historique.
• Pour déplacer de l'argent entre vos pays de votre propre initiative, passez par votre espace Tchin — ce n'est pas exposé dans l'API.
• Le solde Cameroun ne se mélange à aucun autre : approvisionnez-le séparément.