6. Suivre et annuler

Consultez l'état d'une transaction en complément du webhook (par exemple après une coupure réseau de votre côté), ou annulez-la tant qu'elle est en attente.

Suivre le paiement

GET/transactions/{uuid}Clé API + X-Application-ID

Retourne l'état courant. Liste filtrable : GET /transactions?status=success&type=collection&date_from=...&per_page=20.

Réponse 200
{
  "success": true,
  "data": {
    "uuid": "018f1a2b-3c4d-7e5f-a6b7-c8d9e0f1a2b3",
    "type": "collection",
    "provider": "orange_money",
    "status": "success",
    "amount": "5000.00",
    "currency": "XAF",
    "reference": "MP240101.1234.A56789",
    "external_id": null,
    "phone_number": "696246686",
    "checkout_url": null,
    "metadata": {
      "description": "Commande 1234",
      "customer_name": "Nom du client"
    },
    "expires_at": null,
    "created_at": "2026-11-02T08:00:00Z",
    "updated_at": "2026-11-02T08:00:00Z"
  },
  "meta": {
    "request_id": "...",
    "timestamp": "..."
  }
}
CodeQuand
401Clé API invalide.
404Transaction inconnue ou appartenant à un autre compte.

Statuts possibles : voir l'annexe Statuts d'une transaction.

Annuler un paiement en attente

POST/transactions/{uuid}/cancelClé API + X-Application-ID

Annule une transaction encore pending. Déclenche le webhook transaction.cancelled. La réponse a la même structure qu'une transaction, avec le statut mis à jour.

CodeQuand
404Transaction introuvable.
422Transaction déjà terminée : elle ne peut plus être annulée.