curl https://api.zbdpay.com/api/v1/transactions/txn_7f2c \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"message": "Transaction retrieved.",
"data": {
"transaction_id": "txn_7f2c",
"type": "purchase",
"status": "completed",
"currency": "GEMS",
"amount": 500,
"payer": { "user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652" },
"movements": [
{ "movement_id": "mv_1", "to": { "party": "publisher" }, "amount": 500 }
],
"reference_id": "order_9921",
"project_id": null,
"created_at": "2026-10-01T18:20:00Z"
},
"error": null
}
Transactions
Get a Transaction
Read one transaction, whichever call created it.
GET
/
api
/
v1
/
transactions
/
{transactionId}
curl https://api.zbdpay.com/api/v1/transactions/txn_7f2c \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"message": "Transaction retrieved.",
"data": {
"transaction_id": "txn_7f2c",
"type": "purchase",
"status": "completed",
"currency": "GEMS",
"amount": 500,
"payer": { "user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652" },
"movements": [
{ "movement_id": "mv_1", "to": { "party": "publisher" }, "amount": 500 }
],
"reference_id": "order_9921",
"project_id": null,
"created_at": "2026-10-01T18:20:00Z"
},
"error": null
}
Credits, debits, purchases, transfers, and marketplace sales all come back in the same shape, so you can read and reconcile them the same way.
Configuration
Header Parameters
Path Parameters
curl https://api.zbdpay.com/api/v1/transactions/txn_7f2c \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"message": "Transaction retrieved.",
"data": {
"transaction_id": "txn_7f2c",
"type": "purchase",
"status": "completed",
"currency": "GEMS",
"amount": 500,
"payer": { "user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652" },
"movements": [
{ "movement_id": "mv_1", "to": { "party": "publisher" }, "amount": 500 }
],
"reference_id": "order_9921",
"project_id": null,
"created_at": "2026-10-01T18:20:00Z"
},
"error": null
}
Response
The transaction is indata.
Which call created it: a credit
type such as reward, debit, purchase, a transfer type such as gift, or marketplace_sale.Each movement of value: who received it (
to, either a user_id or a party such as publisher or zbd), the amount, and for marketplace sales the recipient’s role. A marketplace sale groups its movements under line_items.Errors
| HTTP | code | When |
|---|---|---|
401 | unauthorized | The API key is missing or invalid |
404 | transaction_not_found | The transaction doesn’t exist under your key |
Was this page helpful?