6. Track and cancel

Fetch a transaction's status alongside the webhook (for example after a network outage on your side), or cancel it while it is still pending.

Track the payment

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

Returns the current status. Filterable list: GET /transactions?status=success&type=collection&date_from=...&per_page=20.

Response 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": "..."
  }
}

Code	When
401	Invalid API key.
404	Unknown transaction or owned by another account.

Possible statuses: see the Transaction statuses appendix.

Cancel a pending payment

POST/transactions/{uuid}/cancelAPI key + X-Application-ID

Cancels a transaction that is still pending. Triggers the transaction.cancelled webhook. The response has the same structure as a transaction, with the updated status.

Code	When
404	Transaction not found.
422	Transaction already completed: it can no longer be cancelled.