# Payment links

A hosted page with a shareable URL and QR code. Fixed price or let the payer enter an amount.

```bash
curl -X POST https://paylynks.io/api/v1/payment_links \
  -H "Authorization: Bearer $PAYLYNKS_SECRET_KEY" -H "Content-Type: application/json" \
  -d '{"title": "Drain cleaning", "amount": 12900}'
```

Returns `url` (`https://paylynks.io/pay/<slug>`) and `qr_code_url`.

| Field | Notes |
| --- | --- |
| `title` | Required. |
| `amount` | Cents. Omit to let the payer choose, optionally within `min_amount` / `max_amount`. |
| `description`, `success_message`, `metadata` | Optional. |

- `GET /api/v1/payment_links` — list
- `GET /api/v1/payment_links/:id` — retrieve
- `POST /api/v1/payment_links/:id` with `{"active": false}` — deactivate

Each payment creates a payment intent with `channel: "payment_link"`. Embed a link anywhere with the [pay button](/docs/checkout#pay-button).