Checkout

Get Checkout Transactions By Source Reference

List all transaction attempts associated with a checkout identified by the merchant source reference.

GET
/api/v1/checkout/transactions/source-reference/{sourceReference}

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

sourceReference*string

Source reference tied to the checkout

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/checkout/transactions/source-reference/SRC_ABC123XYZ"
{
  "requestId": "abcd1234-5678-90ef-ghij-1234567890kl",
  "requestTimestamp": "2026-02-04 09:15:00",
  "message": "Checkout transaction fetched successfully.",
  "statusCode": 200,
  "data": {
    "transactions": {
      "data": [
        {
          "id": "txn-id",
          "type": "credit",
          "reference": "TRX_6WZSIYEK43",
          "sessionId": null,
          "amount": {
            "value": 1000,
            "currency": "NGN",
            "formatted": "NGN 1,000.00"
          },
          "status": "successful"
        }
      ],
      "links": {},
      "meta": {}
    }
  }
}
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2026-02-04 09:15:00",
  "message": "Checkout not found for the provided source reference.",
  "statusCode": 404
}

How is this guide?