> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionicfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment links

> Reusable hosted checkout entry points.

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](/api-reference/products/create-a-product) and [Create price](/api-reference/prices/create-a-price), then publishes a reusable link with [Create payment link](/api-reference/payment-links/create-a-payment-link). Buyers enter through the public link and create buyer-scoped checkout sessions from there.

## Endpoints

| Endpoint                                                                          | Use it for                                                                |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [Create payment link](/api-reference/payment-links/create-a-payment-link)         | Create a reusable hosted payment link.                                    |
| [List payment links](/api-reference/payment-links/list-payment-links)             | Page through active and inactive links.                                   |
| [Get payment link](/api-reference/payment-links/retrieve-a-payment-link)          | Retrieve one link by `pl_` ID.                                            |
| [Update payment link](/api-reference/payment-links/update-a-payment-link)         | Rename, change metadata, replace line items, or update checkout behavior. |
| [Deactivate payment link](/api-reference/payment-links/deactivate-a-payment-link) | Stop a link from creating new buyer sessions.                             |
| [Activate payment link](/api-reference/payment-links/activate-a-payment-link)     | Reactivate a previously deactivated link.                                 |

## 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.