---
title: "Payment Links API quickstart"
description: "Create a payment link over the REST API, share the hosted URL, and receive a webhook when it's paid. Authenticate with your seller account token."
url: "/docs/developers/payment-links-api-quickstart/"
category: "Developers"
---

The Payment Links API lets you create and manage payment links programmatically — the same [invoicing and collections links](/features/invoicing/) you can create in the dashboard. You authenticate with your **seller account token**, create a link, share its hosted URL, and receive a [webhook](/docs/developers/which-webhook-events-does-fynex-send/) when it's paid.

## Create a link

`POST /api/v1/payment-links` with the amount, currency, and any options (expiry, reference):

```bash
curl https://api.fynex.ai/api/v1/payment-links \
  -H "Authorization: Bearer $FYNEX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 4500, "currency": "GBP", "reference": "INV-1042" }'
```

The response includes the link's **id**, **status** (`active`), and the **hosted URL** (like `pay.fynex.ai/p/…`) to send to your customer.

## What you can do

- **Create, list, get, and update** links.
- **Cancel or archive** a link.
- **Send** a link by email, or generate its **QR code**.
- Let customers pay on the hosted page at `/p/{token}` — no checkout to build.

## Get notified when it's paid

Subscribe to the `PaymentLinkPaid` event rather than polling. Also handle `PaymentLinkExpired` and `PaymentLinkCancelled`. See [Which webhook events does Fynex send?](/docs/developers/which-webhook-events-does-fynex-send/) and [verify the signature](/docs/developers/how-do-i-verify-fynex-webhook-signatures/) on every delivery.

## Related

- [Which webhook events does Fynex send?](/docs/developers/which-webhook-events-does-fynex-send/)