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

# Payment Links

> Create a shareable link that lets anyone pay you — no checkout integration required

## Overview

A payment link is a regular payment with a longer expiry window and a short, shareable URL. Send it by email, chat, or QR code — the payer opens it in any browser and completes the payment on the Ebioro-hosted payment page. No storefront or widget integration is needed.

|                | Checkout payment                            | Payment link                                     |
| -------------- | ------------------------------------------- | ------------------------------------------------ |
| Created via    | `POST /payments`                            | `POST /payments`                                 |
| Expiry         | 30 minutes (default)                        | Hours to days — you choose with `expiresInHours` |
| Payer lands on | Your site after redirect                    | Ebioro-hosted confirmation screen                |
| Shareable URL  | `hostedUrl` (long, carries a session token) | `shortUrl` (short, no token in the URL)          |

## Creating a payment link

Create a payment as usual, but set `expiresInHours` and omit `redirectUrl`:

```bash theme={null}
POST /payments
{
  "amount": { "currency": "USD", "value": 25000 },
  "description": "Invoice 2026-104 — design services",
  "name": "Your Store",
  "expiresInHours": 168
}
```

The response contains the link to share:

```json theme={null}
{
  "id": "pt_8CZ3BFuIbw",
  "status": "open",
  "shortUrl": "https://pay.ebioro.com/iqtRR_42J4TAIFbciUUlV",
  "hostedUrl": "https://pay.ebioro.com/payments?paymentId=pt_8CZ3BFuIbw&auth_token=...",
  "expiresAt": "2026-06-17T14:44:47.578Z"
}
```

Share `shortUrl`. It contains no session token — the payment page resolves it securely when opened — so it stays compact and safe to forward.

<Info>
  In the sandbox environment, short links are served from `https://sandbox-pay.ebioro.com`. In production they use `https://pay.ebioro.com`.
</Info>

## Behaviour details

* **`expiresInHours`** — accepts any number of hours (e.g. `24`, `168` for 7 days). If omitted, the payment expires after 30 minutes, which suits a live checkout but not a link shared with a payer. After expiry the payment status becomes `expired` and the link shows an expiry notice.
* **No `redirectUrl`** — when you omit it, the payer sees an Ebioro-hosted confirmation screen after paying. Set it if you want the payer forwarded to your own page instead.
* **Status flow** — identical to any other payment (`open → paid → settled`), and webhooks fire the same way. See [Payments](/concepts/payments).
* **One link, one payment** — each link belongs to a single payment for a fixed amount. To request the same amount from several payers, create one payment per payer.

## Cancelling a link

There is no cancel operation for an open standard payment yet — set a conservative `expiresInHours` and let unused links expire. The payment expires automatically and the link stops accepting payment.