Erreurs & statuts

{
  "success": false,
  "message": "Description lisible de l'erreur"
}

{
  "message": "The amount field is required. (and 1 more error)",
  "errors": {
    "amount": [
      "The amount field is required."
    ],
    "withdraw_mode": [
      "The withdraw mode field is required."
    ]
  }
}

<?php
// Appel générique à l'API Tchin puis gestion homogène des erreurs.
$ch = curl_init('https://tchin.tech/api/v1/disburse/initiate');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'TCHIN-PUBLIC-KEY: tchin_pk_xxxxxxxx',
        'TCHIN-PRIVATE-KEY: tchin_sk_xxxxxxxx',
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'account_alias' => '771234567',
        'amount'        => 5000,
        'withdraw_mode' => 'wave-senegal',
    ]),
]);

$body   = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true);

// 1) Erreur réseau / serveur
if ($status >= 500) {
    // Réessayez plus tard (avec backoff). Ne considérez rien comme fait.
    throw new RuntimeException('Tchin indisponible, réessayez.');
}

// 2) Validation Laravel (422) : champ manquant ou mal formé
if ($status === 422) {
    foreach ($data['errors'] ?? [] as $champ => $messages) {
        // Affichez $messages[0] à côté du champ $champ
    }
    return;
}

// 3) Erreur métier : toujours vérifier "success"
if (empty($data['success'])) {
    // $data['message'] contient la cause (solde insuffisant, mode non pris en charge…)
    // $data['balance'] est présent en cas de solde insuffisant.
    error_log('Tchin: ' . ($data['message'] ?? 'erreur inconnue'));
    return;
}

// 4) Succès
$disburseToken = $data['disburse_token'];

// Node.js — gestion homogène des réponses Tchin
async function callTchin(path, payload) {
  const res = await fetch(`https://tchin.tech/api/v1${path}`, {
    method: 'POST',
    headers: {
      'TCHIN-PUBLIC-KEY': process.env.TCHIN_PUBLIC_KEY,
      'TCHIN-PRIVATE-KEY': process.env.TCHIN_PRIVATE_KEY,
      'Content-Type': 'application/json',
      'Accept': 'application/json',
    },
    body: JSON.stringify(payload),
  });

  // 500+ : incident serveur, à réessayer avec backoff
  if (res.status >= 500) {
    throw new Error('Tchin indisponible, réessayez plus tard.');
  }

  const data = await res.json();

  // 422 : erreurs de validation Laravel, champ par champ
  if (res.status === 422) {
    const details = Object.entries(data.errors || {})
      .map(([champ, msgs]) => `${champ}: ${msgs[0]}`)
      .join(' | ');
    throw new Error(`Validation: ${details}`);
  }

  // Erreur métier : toujours tester success
  if (!data.success) {
    const err = new Error(data.message || 'Erreur Tchin');
    err.balance = data.balance; // présent si solde insuffisant
    throw err;
  }

  return data;
}

# Python (requests) — gestion homogène des erreurs Tchin
import os
import requests

def call_tchin(path, payload):
    res = requests.post(
        f"https://tchin.tech/api/v1{path}",
        json=payload,
        headers={
            "TCHIN-PUBLIC-KEY": os.environ["TCHIN_PUBLIC_KEY"],
            "TCHIN-PRIVATE-KEY": os.environ["TCHIN_PRIVATE_KEY"],
            "Content-Type": "application/json",
            "Accept": "application/json",
        },
        timeout=30,
    )

    # 500+ : incident serveur — réessayez avec backoff
    if res.status_code >= 500:
        raise RuntimeError("Tchin indisponible, réessayez plus tard.")

    data = res.json()

    # 422 : validation Laravel, détaillée champ par champ
    if res.status_code == 422:
        details = {champ: msgs[0] for champ, msgs in data.get("errors", {}).items()}
        raise ValueError(f"Validation: {details}")

    # Erreur métier : toujours vérifier "success"
    if not data.get("success"):
        raise RuntimeError(data.get("message", "Erreur Tchin"))

    return data