PaybytokenDocs
Payment Links
API reference · Payment Links

Payment Links

Publish a reusable hosted payment page with fixed or customer-entered amounts.

A Payment Link is a reusable checkout template. It creates a new Checkout Session for each visit, so every customer attempt still receives an isolated payment lifecycle and destination address.

Use a Payment Link when the merchant does not need to create an order server-side before sharing a URL. Use a Payment Request for one named receivable with a due date, partial-payment allocation and delivery history. Use a Checkout Session for an application-owned order.

Amount modes

ModeConfigurationCustomer experience
fixedProvide line_items. Paybytoken calculates amount_total.The customer pays the fixed order total.
customer_enteredProvide minimum, optional maximum and optional suggested amounts.The customer chooses an allowed USD amount.

The link snapshots supported tokens, checkout branding and completion behavior. Deactivating the link prevents new sessions but does not cancel sessions that already exist.

Lifecycle

  1. Create the Payment Link from a trusted server or the Merchant Portal.
  2. Share its public url.
  3. The public page resolves the template and creates a distinct Checkout Session.
  4. Fulfill from the resulting payment_intent.succeeded event, not from a visit or redirect.
  5. Inspect link analytics separately from payment accounting.

Continue with Create and manage a Payment Link or the Payment Links guide.

On this page

API Workbench

Full Explorer

Open in new tab