API v2

Paiements (cash-in)

Endpoint unifié pour initier un paiement mobile money. Remplace les routes v1 /api/v1/tmoney/payment/make et /api/v1/flooz/payment/make.

Initier un paiement

POST /api/v2/payment/make

Header requis : Authorization: Bearer <jwt>

Champ	Type	Description
`network`	string	`tmoney` ou `flooz`
`phone`	string	8 chiffres (préfixe 228 optionnel)
`amount`	number	Montant en XOF (entier positif)
`command_id`	string	Référence unique de votre commande (≤ 100)
`description`	string?	Libellé affiché / motif

{
  "network": "flooz",
  "phone": "90123456",
  "amount": 2500,
  "command_id": "INV-2026-0042",
  "description": "Facture avril"
}

Réponse typique

{
  "code": 2000,
  "network": "flooz",
  "request_id": "TX-123",
  "command_id": "INV-2026-0042",
  "status": "WAITING",
  "amount": 2500,
  "message": null
}

Les frais sont prélevés à la confirmation du paiement (cash-in) : le marchand crédite montant − frais. Les taux se configurent par type de compte / compte dans l’admin.

Consulter le statut

POST /api/v2/payment/status

{
  "network": "flooz",
  "request_id": "TX-123"
}

Vous pouvez aussi fournir command_id selon le réseau.

status	Signification
`WAITING`	En attente de validation client / opérateur
`SUCCES`	Paiement confirmé, solde crédité
`ECHEC`	Échec
`EXPIRE` / `ANNULE`	Expiré ou annulé (selon opérateur)

Compatibilité v1

Les routes /api/v1/{tmoney|flooz}/payment/* sont dépréciées et seront désactivées le 31-01-2027. Documentation complète : API v1. Pour tout nouveau projet, utilisez exclusivement /api/v2.