Paiements

Créer un paiement

POST /payments route automatiquement vers le partenaire de paiement le plus adapté, avec bascule sur le suivant en cas d'échec.

curl -X POST https://api.passerelle.abecedaire.tg/payments \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "customerName": "Jane Doe",
    "customerPhone": "+22890123456",
    "customerEmail": "jane.doe@example.com",
    "description": "Abonnement mensuel",
    "returnUrl": "https://votre-site.example/retour",
    "metadata": { "orderId": "cmd_42" }
  }'

Champs optionnels supplémentaires :

Champ	Valeurs	Effet
country	TG | BJ | CI | SN | BF | GW | ML | NE	Sinon, déduit strictement de customerPhone (indicatif requis) — voir Créer votre premier paiement
paymentMethod	CARD | MOBILE_MONEY	Sinon, tous les moyens acceptés par votre compte sont considérés
currency	XOF	Seule devise supportée aujourd'hui
metadata	objet libre	Renvoyé tel quel dans le détail de la transaction

503 si aucun partenaire éligible n'a réussi (tous indisponibles ou mal configurés pour votre compte).

Consulter le statut

GET /payments/:reference re-vérifie auprès du partenaire de paiement si le paiement est encore pending.

curl https://api.passerelle.abecedaire.tg/payments/pay_0d9ace5b-... \
  -H "Authorization: Bearer sk_..."

status : pending | succeeded | failed | expired. 404 si la référence n'existe pas ou appartient à un autre marchand.

Historique des transactions

GET /transactions — liste paginée et filtrable (status, gatewayCode, from/to, page, limit). GET /transactions/stats — volume, taux de succès, répartition par partenaire de paiement. GET /transactions/:reference — détail complet, y compris les payloads bruts échangés avec le partenaire de paiement (jamais de numéro de carte).

merchantNetAmount dans ces réponses est le montant qui vous sera effectivement reversé après frais Passerelle — null tant que la transaction n'est pas succeeded.