Skip to main content
Payment links are reusable checkout links backed by catalog prices. Create products and prices first, then create a link with one or more price_id line items. Use this page for the model. Use the generated endpoint pages for request fields, required badges, examples, and response schemas. A typical setup creates catalog records with Create product and Create price, then publishes a reusable link with Create payment link. Buyers enter through the public link and create buyer-scoped checkout sessions from there.

​
Endpoints

​
Notes

  • name, line_items, currency, and amount_total are required on create.
  • line_items uses price_id; payment links do not accept inline name and amount items.
  • When updating line_items, include the new currency and amount_total.
  • collect_config controls buyer fields on hosted checkout.
  • custom_fields is for merchant-defined checkout fields such as PO number or account ID.