Create a Crypto Payment — POST /payments

Creates a payment for a fiat amount in the crypto asset you specify, locks the live exchange rate, and returns a unique deposit address to show the buyer. The quote is valid for 30 minutes. Requires the payments:write scope.

Request

POST https://api.blockra.io/payments

Body parameters

asset

string

required

The coin the buyer pays in. One of BTC, LTC, ETH, USDC, or USDT.

fiat_amount

number

required

The amount to charge, expressed in fiat. Blockra locks the live exchange rate and computes the exact crypto amount. Example: 9.99.

fiat_currency

string

default:"USD"

The fiat currency to price in. One of USD, EUR, or GBP. Defaults to USD.

reference

string

Your own order or reference ID (max 255 characters). Echoed back on the payment object and in webhook payloads.

customer_email

string

Associates the payment with a customer by email. A customer record is created automatically if one does not already exist.

metadata

object

Arbitrary key/value pairs stored on the payment and returned as-is in all responses.

Response

Returns a 201 with the newly created payment object wrapped in the standard data envelope.

string

The payment ID, prefixed pay_.

status

string

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

asset

string

The crypto asset (e.g. LTC).

network

string

The blockchain network: bitcoin, litecoin, or ethereum.

fiat_currency

string

The fiat currency code.

fiat_amount

number

Gross amount the buyer is charged (fiat).

fee_fiat

number

The Blockra fee in fiat.

net_fiat

number

Amount credited to your balance (fiat_amount − fee_fiat).

confirmations

number

On-chain confirmations seen so far. Always 0 on a freshly created payment.

reference

string

Your reference ID, if provided.

expires_at

string

ISO-8601 time the quote expires (30 minutes from creation).

created_at

string

ISO-8601 timestamp when the payment was created.

deposit

object

Where and how much the buyer should send.

Show deposit fields

address

string

The deposit address to send crypto to.

asset

string

The coin.

network

string

The chain.

expected_amount

string

The exact amount to send as a human-readable decimal string, rounded to payable precision. Show this to the buyer.

expected_amount_atoms

string

The exact amount in the asset’s smallest unit (satoshis, wei, etc.) as a string. Use for precise comparisons.

qr_data

string

A wallet-URI string (e.g. litecoin:address?amount=0.1183) to render as a QR code for mobile wallets.

status

string

Deposit status, mirrors the top-level payment status (e.g. pending).

confirmations

number

On-chain confirmations seen for this deposit so far.

required_confirmations

number

Number of on-chain confirmations required before the payment is considered complete.

expires_at

string

ISO-8601 time the quote expires (30 minutes from creation).

curl https://api.blockra.io/payments \
  -X POST \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": "LTC",
    "fiat_amount": 9.99,
    "fiat_currency": "USD",
    "reference": "order_1234",
    "customer_email": "buyer@example.com"
  }'

const res = await fetch("https://api.blockra.io/payments", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.BLOCKRA_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    asset: "LTC",
    fiat_amount: 9.99,
    fiat_currency: "USD",
    reference: "order_1234",
  }),
});
const { data, error } = await res.json();

{
  "data": {
    "id": "pay_a1b2c3d4e5f6g7h8i9j0k1l2",
    "status": "pending",
    "asset": "LTC",
    "network": "litecoin",
    "fiat_currency": "USD",
    "fiat_amount": 9.99,
    "fee_fiat": 0.22,
    "net_fiat": 9.77,
    "confirmations": 0,
    "reference": "order_1234",
    "expires_at": "2026-07-08T13:09:00.000Z",
    "created_at": "2026-07-08T12:39:00.000Z",
    "deposit": {
      "address": "ltc1q0u0dnysyzuyua7tg2fu05ztgssazx0j5fqfhun",
      "asset": "LTC",
      "network": "litecoin",
      "expected_amount": "0.1183",
      "expected_amount_atoms": "11830000",
      "qr_data": "litecoin:ltc1q0u0dnysyzuyua7tg2fu05ztgssazx0j5fqfhun?amount=0.1183",
      "status": "pending",
      "confirmations": 0,
      "required_confirmations": 4,
      "expires_at": "2026-07-08T13:09:00.000Z"
    }
  },
  "error": null
}

Get PaymentFetch a single payment by its ID. Returns the full payment object including status, deposit details, fiat breakdown, and on-chain confirmation count.

curl https://api.blockra.io/payments \
  -X POST \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": "LTC",
    "fiat_amount": 9.99,
    "fiat_currency": "USD",
    "reference": "order_1234",
    "customer_email": "buyer@example.com"
  }'

const res = await fetch("https://api.blockra.io/payments", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.BLOCKRA_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    asset: "LTC",
    fiat_amount: 9.99,
    fiat_currency: "USD",
    reference: "order_1234",
  }),
});
const { data, error } = await res.json();

{
  "data": {
    "id": "pay_a1b2c3d4e5f6g7h8i9j0k1l2",
    "status": "pending",
    "asset": "LTC",
    "network": "litecoin",
    "fiat_currency": "USD",
    "fiat_amount": 9.99,
    "fee_fiat": 0.22,
    "net_fiat": 9.77,
    "confirmations": 0,
    "reference": "order_1234",
    "expires_at": "2026-07-08T13:09:00.000Z",
    "created_at": "2026-07-08T12:39:00.000Z",
    "deposit": {
      "address": "ltc1q0u0dnysyzuyua7tg2fu05ztgssazx0j5fqfhun",
      "asset": "LTC",
      "network": "litecoin",
      "expected_amount": "0.1183",
      "expected_amount_atoms": "11830000",
      "qr_data": "litecoin:ltc1q0u0dnysyzuyua7tg2fu05ztgssazx0j5fqfhun?amount=0.1183",
      "status": "pending",
      "confirmations": 0,
      "required_confirmations": 4,
      "expires_at": "2026-07-08T13:09:00.000Z"
    }
  },
  "error": null
}

​Request

​Body parameters

​Response

Request

Body parameters

Response