# Payment links (/merchants/payment-links)

A payment link is a reusable address that sells exactly one of your prices, of one product. You
make it in the dashboard under **Payment links**, in the **Payments** group, then share it wherever
you like. Anyone who has the link can pay it, as many times as you allow: each click on the pay
button opens a fresh checkout of that one price: a new order for a one-time price, a new subscription for a
recurring one.

A link reads `https://checkout.fianto.xyz/l/` followed by 16 random letters and digits. Fianto makes
the code when you create the link and never changes it; you can't choose it, and a link has no domain
of its own.

## Link, shop or API? [#link-shop-or-api]

* **A payment link** sells one price with nothing to build: you create it and share the address. A
  one-time price makes a one-time payment, a recurring price makes a subscription.
* **A [shop](/merchants/shop)** is a page of your own at `<name>.fianto.xyz` that lists your
  products, shows each buyer a message and a link after paying, and emails them to buyers who
  give an email.
* **The [v1 API](/developers/checkout-sessions)** is for checkouts started from your own site or
  app, by your own server.

## How a sale works [#how-a-sale-works]

1. You create a link for one price and copy its address.
2. A payer opens it and sees one card: your name, the product, the price in USDC and a pay button.
   If you ask for an email, they type it there.
3. The button sends them to Fianto's checkout page for that one price. They pay from their Solana
   wallet, exactly as for any other checkout; the service fee (and, for a subscription, the network fee) is added there.
4. The payment goes straight to your wallet. A one-time payment appears in
   **Orders** and **Payments**, a subscription in **Subscriptions** and **Payments**, both in
   **Customers**, like any other sale, and on the link's own page under "Payments on this link".

![A payment link's page: the merchant's initial and name, the product, the price in USDC, One payment, an optional email field and the Pay with a wallet button.](/screenshots/payment-links/payer-link.webp)

*Amounts are demo values.*

## Statuses [#statuses]

A link's status is worked out every time it is read, in this order; the first that applies wins.
Only an **Open** link takes payments. On any other, the payer sees "This link is closed" and cannot
pay.

| Status      | Meaning                                             |
| ----------- | --------------------------------------------------- |
| Closed      | You closed it.                                      |
| Unavailable | Its price, or that price's product, has been ended. |
| Ended       | Its end date has passed.                            |
| Full        | It has a payment limit and has reached it.          |
| Open        | None of the above: it takes payments.               |

Because status is worked out rather than stored, a later end date or a higher limit makes an Ended
or Full link Open again. Ending a price turns every link on it Unavailable at once.

## Limits [#limits]

* **End date** ("Ends on a date"): optional. From that moment the link reads Ended.
* **Payment limit** ("Ends when full"): optional, a whole number from 1 to 10,000. It counts paid
  payments only: a one-time order that is Paid, or a subscription whose first payment succeeded.
  Visits, clicks and checkouts nobody paid are not counted. When the paid payments reach the limit,
  the link reads Full.
* **The place a payer holds while paying.** When a link has a limit, Fianto checks it again just
  before the payer's wallet opens. If there is room, that payer holds a place for 5 minutes, renewed
  each time their checkout prepares the transaction again. Places held by other payers count
  toward the limit at that check, so a payer can be turned away before their wallet opens. One wallet holds at most one place on a link. Visitors who never start paying hold nothing.
* **Money that reaches Solana is always settled.** A payment that lands after its hold ran out still
  pays, so a link can end up a little over its limit.
* **How many links you can keep:** 1,000 links that are not closed, and 10,000 in all, closed ones
  included.

## What a link can't do [#what-a-link-cant-do]

* It sells one price of one product: there is no cart and no quantity, and the price never changes.
  To charge a different amount, make a new link.
* You can't delete a link: you close it, and you can reopen it.
* Closing a link stops new payments only. It cancels nothing already paid, and a subscription bought
  through it carries on with its plan; ending the price is what ends the plan.
* Fianto sends the payer no email about a link payment, and there is no refund through Fianto: you
  send money back from your own wallet.
* Payment links live in the dashboard only. There is no v1 endpoint or SDK method for them.

## Before approval [#before-approval]

The **Payment links** page opens before Fianto approves your account, but its list is empty and
**New link** opens the same dialog as other actions before approval, for example "Set up your
account first". See [Review and approval](/merchants/review-and-approval).

## What you can do [#what-you-can-do]

- [Create a link](/merchants/payment-links-create): Pick a price or make a new product, then set the options.

- [Manage your links](/merchants/payment-links-manage): Find links by status or name, close and reopen them.

- [See payments](/merchants/payment-links-manage): Each link's payments, with CSV export.

- [What payers see](/payers/paying-through-a-payment-link): One card with the price and a pay button.

## See also [#see-also]

- [Products and prices](/merchants/products-and-prices): The prices a link can sell.

- [Paying through a payment link](/payers/paying-through-a-payment-link): What your payers see, from the link to the receipt.

- [Payment link sales in your integration](/developers/payment-link-sales): How link payments reach your webhooks.