Create a Payment Link — POST /payment-links

curl https://api.blockra.io/payment-links \
  -X POST \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Pro plan",
    "amount": 49.00,
    "currency": "USD"
  }'

{
  "data": {
    "id": "plink_7h8i9j0k1l2m3n4o",
    "label": "Pro plan",
    "amount": 49.00,
    "currency": "USD",
    "uses": 0,
    "is_active": true,
    "created_at": "2026-07-09T02:40:00.000Z"
  },
  "error": null
}

Creates a reusable payment link. Share its hosted URL (https://pay.blockra.io/{id}) and every visit starts a fresh hosted checkout where the buyer picks a coin. Requires the payment_links:write scope.

Request

POST https://api.blockra.io/payment-links

Body parameters

string

required

A short description shown on the checkout (e.g. "Pro plan—annual").

number

required

The amount to charge, in fiat (e.g. 49.00). Required — a payment link always charges a fixed amount.

string

default:"USD"

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

Response

string

The payment link ID, prefixed plink_. Its hosted URL is https://pay.blockra.io/{id}.

string

The link’s description.

number

The fixed amount the link charges.

string

The currency code.

integer

How many times the link has been opened.

boolean

Whether the link currently accepts payments.

string

ISO-8601 creation time.

curl https://api.blockra.io/payment-links \
  -X POST \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Pro plan",
    "amount": 49.00,
    "currency": "USD"
  }'

{
  "data": {
    "id": "plink_7h8i9j0k1l2m3n4o",
    "label": "Pro plan",
    "amount": 49.00,
    "currency": "USD",
    "uses": 0,
    "is_active": true,
    "created_at": "2026-07-09T02:40:00.000Z"
  },
  "error": null
}

curl https://api.blockra.io/payment-links \
  -X POST \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Pro plan",
    "amount": 49.00,
    "currency": "USD"
  }'

{
  "data": {
    "id": "plink_7h8i9j0k1l2m3n4o",
    "label": "Pro plan",
    "amount": 49.00,
    "currency": "USD",
    "uses": 0,
    "is_active": true,
    "created_at": "2026-07-09T02:40:00.000Z"
  },
  "error": null
}

Payments

Checkout

Customers

Payment Links

Webhook Endpoints

Create a Payment Link — POST /payment-links

Request

Body parameters

Response

​Request

​Body parameters

​Response

Request

Body parameters

Response