Checkout
Get Checkout Transactions By Reference
List all transaction attempts associated with a checkout identified by the Atlas checkout reference.
Authorization
BearerAuth AuthorizationBearer <token>
In: header
Path Parameters
reference*string
Checkout reference
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/checkout/CHT_ABC123/transactions"{
"requestId": "abcd1234-5678-90ef-1234-567890abcdef",
"requestTimestamp": "2026-01-01 12:00:00.000",
"message": "Checkout transactions fetched successfully.",
"statusCode": 200,
"data": {
"checkoutReference": "CHT_ABC123",
"sourceReference": "SRC_ABC123",
"checkoutStatus": "completed",
"paymentMethod": "bank_transfer",
"transactionsSummary": {
"total": 2,
"successful": 1,
"failed": 1,
"pending": 0
},
"transactions": [
{
"transactionReference": "TRX_ABC123",
"status": "successful",
"channel": "bank_transfer",
"amount": {
"value": 1050,
"currency": "NGN",
"formatted": "NGN 1,050.00"
},
"feeAmount": {
"value": 50,
"currency": "NGN",
"formatted": "NGN 50.00"
},
"senderName": "Jane Doe",
"reason": null,
"createdAt": "2026-01-01T12:00:00+00:00",
"updatedAt": "2026-01-01T12:05:00+00:00"
}
]
}
}{
"requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
"requestTimestamp": "2026-01-01 12:00:00.000",
"message": "Invalid API key.",
"statusCode": 401
}{
"requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
"requestTimestamp": "2026-01-01 12:00:00.000",
"message": "Checkout with reference CHT_ABC123 not found",
"statusCode": 404
}How is this guide?