Payment Links API quickstart
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.
The Payment Links API lets you create and manage payment links programmatically — the same invoicing and collections links you can create in the dashboard. You authenticate with your seller account token, create a link, share its hosted URL, and receive a webhook when it’s paid.
Create a link
POST /api/v1/payment-links with the amount, currency, and any options (expiry, reference):
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? and verify the signature on every delivery.