> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Payment Link — POST /payment-links

> Create a reusable, shareable payment link for a fixed or buyer-chosen amount. Requires payment_links:write.

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

<ParamField body="label" type="string" required>
  A short description shown on the checkout (e.g. `"Pro plan—annual"`).
</ParamField>

<ParamField body="amount" type="number" required>
  The amount to charge, in fiat (e.g. `49.00`). Required — a payment link always charges a fixed amount.
</ParamField>

<ParamField body="currency" default="USD" type="string">
  The fiat currency to price in. One of `USD`, `EUR`, or `GBP`.
</ParamField>

## Response

<ResponseField name="id" type="string">
  The payment link ID, prefixed `plink_`. Its hosted URL is `https://pay.blockra.io/{id}`.
</ResponseField>

<ResponseField name="label" type="string">
  The link's description.
</ResponseField>

<ResponseField name="amount" type="number">
  The fixed amount the link charges.
</ResponseField>

<ResponseField name="currency" type="string">
  The currency code.
</ResponseField>

<ResponseField name="uses" type="integer">
  How many times the link has been opened.
</ResponseField>

<ResponseField name="is_active" type="boolean">
  Whether the link currently accepts payments.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO-8601 creation time.
</ResponseField>

<RequestExample>
  ```bash cURL theme={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"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "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
  }
  ```
</ResponseExample>