Manage Payment Links and usages

Overview

Use the Lean Dashboard v2 or Payment Links API to find existing Payment Links, understand how they are being used, and control whether they can accept new payments.

A Payment Link is the hosted payment page you created and shared with your customer.

A usage is one customer payment attempt through that link. It is created when the customer submits the required identifiers on the hosted page and clicks Pay. Each usage helps you understand what happened for that attempt, including its usage status, payment status, collected identifiers, and linked IDs such as payment_id or customer_id when available.

View Payment Links

Open Payments > Links to view all Payment Links created for your application.

The list page shows each link's ID, name, status, amount, usage count, and expiry in one table. Click a Link ID to open that link's details page. Use Create payment link in the top-right when you need a new link.

Use this page to quickly answer questions such as which links are still active, which links have already expired or been used, and which link you need to open to investigate a payment attempt.

Links can appear as ACTIVE, DISABLED, EXPIRED, or USED. For the full lifecycle behavior, see Payment Link lifecycle.

If a link has no expiry, the Expires at column may show —.

View Payment Link Details

Click a Link ID to open dashboard.leantech.me/payments/links/{link_id}.

The details page brings together the link's current status, amount, expiry, hosted URL, QR code, configured identifiers, redirect_url when set, and its current usage count. Use this page when you need the current state of one link. It combines the link configuration, sharing actions, and usage history in one place, so it is the main page for day-to-day management after creation.

Share the Payment Link

When you need to send the same Payment Link, the details page lets you quickly share the hosted URL or download the QR code. This is useful when a customer needs the link resent, or when you want to place the QR code in a printed invoice, point-of-sale flow, or other offline journey.

Review Payment Link Usages

A usage represents one customer payment attempt through the Payment Link. It is created when the customer submits the required identifiers on the hosted page and clicks Pay. Simply opening or loading the link does not create a usage. Reviewing usages helps you understand whether customers are opening the link, whether a payment was created for that attempt, and which identifiers were captured during checkout.

Use the Usages table to review the history of a link, check whether a payment was created for a specific attempt, view the usage status and payment status, and find any identifiers collected for that attempt.

For details on how usage limits affect link status, see the Payment Link lifecycle section below.

View Usage Details

Click any row in the Usages table to open a side drawer. The Dashboard does not navigate to a separate page for usage details.

Use the drawer when you need to inspect one payment attempt in detail. This is where you can review the identifier values captured during checkout and confirm which records were created for that usage.

This is also the easiest place to grab a specific Usage ID, Customer ID, or Payment ID when you need to reconcile a payment or share details with your team.

For more on configuring identifiers, see Create and configure a Payment Link.

Accessing collected data

When a customer submits the required fields and clicks Pay, Lean creates a usage for that payment attempt.

Any identifier values the customer entered are shown on that usage.

In Lean Dashboard v2, you can access this data from the payment link's details page under Usages.

Click any usage to open its details. The usage details drawer shows the collected identifier values together with the usage status, payment status, Payment ID, and Customer ID, when available.

Disable or Re-enable a Payment Link

Use Disable on the Payment Link details page to stop the link from accepting new payments.

This is useful when you want to pause a campaign, replace a link with a new one, or temporarily stop new payments without removing the existing record.

Before the change is applied, the Dashboard shows a confirmation modal. After you confirm, the link status updates to DISABLED and customers can no longer use that link to start a new payment.

Disabling a link is reversible. After a link is disabled, the Disable button changes to Enable.

Use Enable to allow the link to accept payments again, as long as the link has not already reached a terminal lifecycle state such as EXPIRED or USED. For the full lifecycle rules, see Payment Link lifecycle.

Payment Link lifecycle

Use this section to understand how a Payment Link moves between statuses and what you can still change after creation.

Every Payment Link starts as ACTIVE when you create it and can move to DISABLED, EXPIRED, or USED depending on how you manage it and how customers use it.

%%{init: {'flowchart': {'curve': 'linear'}}}%%
flowchart LR
    classDef active fill:#16a34a,stroke:#15803d,color:#fff
    classDef muted fill:#64748b,stroke:#475569,color:#fff
    classDef terminal fill:#dc2626,stroke:#b91c1c,color:#fff

    ACTIVE:::active <-->|"Disable / re-enable"| DISABLED:::muted
    ACTIVE -->|"payment link expires"| EXPIRED:::terminal
    ACTIVE -->|"max_usages reached"| USED:::terminal
    DISABLED -.->|"payment link expires"| EXPIRED

Status	What it means
ACTIVE	The link can accept new payments.
DISABLED	The link cannot accept new payments, but you can return it to `ACTIVE` unless it later reaches `EXPIRED`.
EXPIRED	The expiration time has passed. This is a terminal state.
USED	The link has reached its configured number of successful payments. This is a terminal state.

Keep these rules in mind when you manage a link:

You can change the link status between ACTIVE and DISABLED.
You cannot reactivate a link after it reaches EXPIRED or USED.
Set link expiration when you create the link if it should stop accepting payments after a specific time.
Limit max usages when you create the link if it should stop accepting payments after a fixed number of successful payments. The default usage cap is 1,000.
If you need different expiry rules, usage limits, payment details, identifiers, or redirect_url, create a new link.