Use cases
- Invoicing - send a payment link in an email or SMS
- Donations - embed a payment link on a website or social media
- Event tickets - sell a fixed number of seats by setting a max use limit
- Subscriptions alternative - recurring manual billing for small businesses
Creating a payment link
- Go to Payment Links in the dashboard
- Click New Payment Link
- Configure the link:
- Click Create - PayBridgeNP generates a URL like:
Tracking payments
Payments made through a link fire webhooks (payment_link.paid and payment.succeeded), which are the reliable way to know a link has been paid. See Confirming a payment for the webhooks-first pattern and how to verify a payment server-side.
Webhooks
Payment link payments fire apayment_link.paid event (and also payment.succeeded). The webhook payload includes the metadata attached to the payment link, a payment_link_id field, and - when address collection is enabled - a customer_address object.
Set up a webhook endpoint in the dashboard to receive these events.
Link lifecycle
You can disable or re-enable a link at any time from the dashboard.
Creating links programmatically
Payment links have a full API - see Create a payment link. Beyond a fixedamount, a link can accept an open amount within a range (minAmount/maxAmount) so the customer enters what they pay, and it can send the customer to your own page after payment with redirectUrl. You can also create and manage links from the dashboard.
Limitations
- A link’s provider set and currency (NPR) are fixed once created