Erreurs & statuts

Toutes les erreurs renvoient un JSON avec success: false et un message explicatif, accompagné d'un code HTTP approprié.

Format

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

Codes HTTP

Code	Signification
`200`	Succès (vérifiez quand même `success`).
`400`	Requête invalide (champ manquant, solde insuffisant, moyen non pris en charge…).
`401`	Clés API manquantes ou invalides.
`404`	Ressource introuvable (token inexistant…).
`422`	Validation des données échouée.
`500`	Erreur côté serveur — réessayez plus tard.

Message	Cause / solution
Clés API manquantes…	Ajoutez les en-têtes `TCHIN-PUBLIC-KEY` et `TCHIN-PRIVATE-KEY`.
Clés API invalides.	Vérifiez vos clés (menu API → Voir).
Paiement momentanément indisponible	Configuration de paiement incomplète côté Tchin. Contactez le support.
Paiement refusé.	En test : vérifiez les identifiants du compte de test. En live : le client a annulé ou échoué.

Message	Cause / solution
withdraw_mode non pris en charge.	Utilisez une valeur de la liste des `withdraw_mode`.
Solde insuffisant sur le pays XX.	Créditez le solde du pays concerné (le débit se fait sur ce pays).
Déboursement introuvable.	Le `disburse_token` n'existe pas ou n'appartient pas à votre compte.
Échec du déboursement.	Vérifiez le statut ; si `pending`, patientez ; si `failed`, recommencez.

Statut	Que faire
`created`	Soumettez la transaction (étape 2).
`pending`	Patientez puis vérifiez le statut.
`success`	Terminé. Vous pouvez clore la transaction.
`failed`	Informez le client ou recommencez une nouvelle transaction.