Retrieve a Payment by ID — GET /payments/{id}

curl https://api.blockra.io/payments/pay_a1b2c3d4e5f6g7h8i9j0k1l2 \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const res = await fetch(
  "https://api.blockra.io/payments/pay_a1b2c3d4e5f6g7h8i9j0k1l2",
  { headers: { "X-API-Key": process.env.BLOCKRA_API_KEY! } }
);
const { data } = await res.json();

{
  "data": {
    "id": "pay_a1b2c3d4e5f6g7h8i9j0k1l2",
    "status": "completed",
    "asset": "LTC",
    "network": "litecoin",
    "fiat_currency": "USD",
    "fiat_amount": 9.99,
    "fee_fiat": 0,
    "net_fiat": 9.99,
    "confirmations": 4,
    "reference": "order_1234",
    "customers": {
      "id": "cus_9z8y7x6w5v4u3t2s1r0q",
      "email": "buyer@example.com"
    },
    "detected_at": "2026-07-08T12:41:00.000Z",
    "completed_at": "2026-07-08T12:52:00.000Z",
    "created_at": "2026-07-08T12:39:00.000Z"
  },
  "error": null
}

Fetches a single payment by its ID, returning the full payment object including current status, deposit address, fiat breakdown, and confirmation count. Requires the payments:read scope.

Request

GET https://api.blockra.io/payments/{id}

Path parameters

string

required

The payment ID, prefixed pay_ (e.g. pay_a1b2c3d4e5f6g7h8i9j0k1l2).

Response

Returns a 200 with the matching payment object wrapped in the standard data envelope.

string

Current lifecycle status: pending, detected, completed, overpaid, underpaid, expired, failed, or cancelled.

object

The associated customer { id, email }, or null if no customer was linked.

string

ISO-8601 timestamp when funds were first seen on-chain, or null.

string

ISO-8601 timestamp when the payment was confirmed, or null.

number

The amount you invoiced, in fiat_currency.

number

The fiat value of the crypto that settled into your wallet. Equal to fiat_amount for an exact payment; higher if the buyer overpaid, lower if they underpaid.

number

Always 0. Blockra is non-custodial and takes no per-transaction fee — funds move straight from your buyer to your wallet. Retained for backward compatibility.

curl https://api.blockra.io/payments/pay_a1b2c3d4e5f6g7h8i9j0k1l2 \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const res = await fetch(
  "https://api.blockra.io/payments/pay_a1b2c3d4e5f6g7h8i9j0k1l2",
  { headers: { "X-API-Key": process.env.BLOCKRA_API_KEY! } }
);
const { data } = await res.json();

{
  "data": {
    "id": "pay_a1b2c3d4e5f6g7h8i9j0k1l2",
    "status": "completed",
    "asset": "LTC",
    "network": "litecoin",
    "fiat_currency": "USD",
    "fiat_amount": 9.99,
    "fee_fiat": 0,
    "net_fiat": 9.99,
    "confirmations": 4,
    "reference": "order_1234",
    "customers": {
      "id": "cus_9z8y7x6w5v4u3t2s1r0q",
      "email": "buyer@example.com"
    },
    "detected_at": "2026-07-08T12:41:00.000Z",
    "completed_at": "2026-07-08T12:52:00.000Z",
    "created_at": "2026-07-08T12:39:00.000Z"
  },
  "error": null
}

curl https://api.blockra.io/payments/pay_a1b2c3d4e5f6g7h8i9j0k1l2 \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const res = await fetch(
  "https://api.blockra.io/payments/pay_a1b2c3d4e5f6g7h8i9j0k1l2",
  { headers: { "X-API-Key": process.env.BLOCKRA_API_KEY! } }
);
const { data } = await res.json();

{
  "data": {
    "id": "pay_a1b2c3d4e5f6g7h8i9j0k1l2",
    "status": "completed",
    "asset": "LTC",
    "network": "litecoin",
    "fiat_currency": "USD",
    "fiat_amount": 9.99,
    "fee_fiat": 0,
    "net_fiat": 9.99,
    "confirmations": 4,
    "reference": "order_1234",
    "customers": {
      "id": "cus_9z8y7x6w5v4u3t2s1r0q",
      "email": "buyer@example.com"
    },
    "detected_at": "2026-07-08T12:41:00.000Z",
    "completed_at": "2026-07-08T12:52:00.000Z",
    "created_at": "2026-07-08T12:39:00.000Z"
  },
  "error": null
}

Payments

Checkout

Customers

Payment Links

Webhook Endpoints

Retrieve a Payment by ID — GET /payments/{id}

Request

Path parameters

Response

​Request

​Path parameters

​Response

Request

Path parameters

Response