Skip to main content

Get payment by id

Retrieve a single payment by its ID to get amount, status, currency, products, deposit attempt history, and timestamps. Use this after a payment is created (e.g. from the checkout flow or from a webhook transaction_id).

For how to use deposit history in your integration, see Deposit attempts.

Endpoint

GET /api/transactions/<id>/

Authentication: Required (API key).

id — Path parameter: public payment ID (e.g. TXabc123) or numeric transaction ID. The public ID is returned in webhooks as transaction_id.

Response (200)

{
"id": "TXabc123",
"amount": "99.00",
"status": "paid",
"currency": "USD",
"payer_email": "customer@example.com",
"products": [
{ "id": "prod_xyz", "name": "Premium Plan" }
],
"depositAttempts": [
{
"status": "succeeded",
"paymentId": "pay_abc123",
"attemptedAt": "2026-06-16T23:56:01.145Z",
"errorMessage": null,
"paymentMethod": "card"
},
{
"status": "requires_payment_method",
"paymentId": "pay_abc123",
"attemptedAt": "2026-06-16T23:55:04.411Z",
"errorMessage": "Your card has insufficient funds.",
"paymentMethod": "card"
}
],
"created_at": "2026-02-22T14:30:00Z"
}
FieldDescription
idPublic payment ID (e.g. TXabc123)
amountNet amount (after fees)
statuspaid, failed, refund_pending, refunded, canceled, processing
currencyCurrency code (e.g. USD)
payer_emailCustomer email when available
productsList of products (id, name)
depositAttemptsArray of deposit attempts (status, attemptedAt, errorMessage, etc.). See Deposit attempts.
created_atISO 8601 timestamp

Example

curl -X GET "https://api.sandbox.nd8.com/api/transactions/TXabc123/" \
-H "Authorization: Api-Key YOUR_API_KEY"

Use the same API key as for Create payment. The payment must belong to your organization.