API ReferenceCheckout
Get checkout session status
Returns the current state of a checkout session along with its full event
history. Use this to poll for status changes after submitting a transaction
hash. The events array shows every state transition with timestamps.
Path Parameters
id*string
The checkout session ID (UUID).
Format
uuidResponse Body
application/json
application/json
curl -X GET "https://api.justusebag.xyz/api/checkout/session/b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e"{
"status": "success",
"data": {
"session": {
"_id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
"paymentLinkId": "d4e5f6a7-b8c9-4d0e-a1f2-b3c4d5e6f7a8",
"walletAddress": "0xCuStOmEr1234567890abCdEf1234567890aBcDeF",
"walletType": "evm",
"network": "base",
"expectedAmount": 32.61,
"status": "txn_confirming",
"txHash": "0x8f3a2b1c4d5e6f7890abcdef1234567890abcdef1234567890abcdef12345678",
"expiresAt": "2026-03-01T10:30:00.000Z",
"createdAt": "2026-03-01T10:00:00.000Z"
},
"events": [
{
"_id": "c3d4e5f6-a7b8-4c9d-0e1f-2a3b4c5d6e7f",
"sessionId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
"status": "payment_session_created",
"source": "server",
"createdAt": "2026-03-01T10:00:00.000Z"
},
{
"_id": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
"sessionId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
"status": "txn_broadcast",
"source": "client",
"chain": "base",
"createdAt": "2026-03-01T10:02:15.000Z"
},
{
"_id": "e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b",
"sessionId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
"status": "txn_confirming",
"source": "chain",
"chain": "base",
"createdAt": "2026-03-01T10:02:30.000Z"
}
]
}
}{
"status": "error",
"message": "Not found",
"code": "NOT_FOUND"
}