Payment Link

Payment links let you create a hosted checkout URL for a specific customer and invoice. Use this when your backend already knows who the customer is, what they should pay, and when the payment link should expire.

Recommended Flow

  1. Create the payment link from your server with customer details and line items.
  2. Send the returned paymentLink.url to the customer.
  3. Verify the payment link before redirecting or displaying checkout state.
  4. Listen for transaction webhooks.
  5. Verify the related transaction reference before giving value.

When To Use Payment Links

Use customer-specific payment links for invoices, payment requests, or order checkouts where the customer and currency are known before the link is created.

Use General Payment Links instead when the same link should be reusable and the customer will choose their currency later.

Integration Notes

  • Create links from your server, not directly from the browser.
  • Include enough metadata or references to reconcile the payment back to your order.
  • Verify the payment result before giving value.
  • Use webhooks so your backend updates even if the customer closes the checkout page.

For exact request and response schemas, see Reference > Payment Links.