Create a Payment Link — POST /payment-links

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

label

string

required

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

amount

number

required

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

currency

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}.

label

string

The link’s description.

amount

number

The fixed amount the link charges.

currency

string

The currency code.

uses

integer

How many times the link has been opened.

is_active

boolean

Whether the link currently accepts payments.

created_at

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
}

​Request

​Body parameters

​Response

Request

Body parameters

Response