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

# Manage Payment Links

> Learn how to view, edit, share, and deactivate your payment links on Bila.

Monitor performance, share links, edit configurations, and deactivate or delete payment links from the dashboard.

<Info>
  Only admins with **Merchant Admin** or **Initiator & Approver** roles can manage payment links.
</Info>

***

## Watch: How to Manage Payment Links

<iframe src="https://www.youtube.com/embed/5lgHj1UPRQA" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

***

## Step 1: Open the Payment Links Dashboard

Click **Payment Links** in the left sidebar.

The dashboard displays a summary of all your links with the following columns:

| Column        | What It Shows                                                   |
| ------------- | --------------------------------------------------------------- |
| **Link**      | The name and description of the payment link                    |
| **Type**      | The payment configuration — `Flexible`, `Fixed`, or `Suggested` |
| **Amount**    | The configured amount in ZMW, or `Flexible` if customer-defined |
| **Payments**  | The number of completed payments received through this link     |
| **Collected** | The total amount collected via this link to date                |
| **Status**    | Whether the link is `Active` or `Inactive`                      |

***

## Step 2: Open the Link Actions Menu

To manage any specific link:

1. Locate the link in the table.
2. Click the options menu **`...`** at the far right of the link row.

A dropdown menu appears with the following actions:

| Action           | What It Does                                                     |
| ---------------- | ---------------------------------------------------------------- |
| **View Details** | Opens performance metrics and full payment history for this link |
| **Open Link**    | Previews the customer-facing payment page in a new tab           |
| **Copy Link**    | Copies the shareable URL to your clipboard                       |
| **Download QR**  | Saves a printable QR code for this payment link                  |
| **Edit**         | Opens the link configuration to make changes                     |
| **Deactivate**   | Temporarily disables the link without deleting it                |
| **Delete**       | Permanently removes the link                                     |

***

## View Link Details

Select **View Details** from the options menu.

The details page displays performance metrics for this link:

| Metric              | What It Shows                                    |
| ------------------- | ------------------------------------------------ |
| **Total Collected** | The cumulative amount received through this link |
| **Total Payments**  | The number of completed transactions             |
| **Average Payment** | The mean payment amount across all transactions  |

Below the summary, the **Payment History** table lists every individual transaction:

| Column       | What It Shows                          |
| ------------ | -------------------------------------- |
| **Customer** | The name or phone number of the payer  |
| **Date**     | The exact timestamp of the transaction |
| **Amount**   | The amount paid in ZMW                 |
| **Status**   | The outcome — `Completed` or `Failed`  |

<Tip>
  Use the Payment History table to identify your highest-value customers and your most active payment links — this is your fastest view into which links are driving real revenue.
</Tip>

***

## Preview the Customer Experience

Select **Open Link** from the options menu.

The customer-facing payment page opens in a new tab — exactly as your customers see it. The page includes fields for:

* **Amount** — pre-filled if Fixed, editable if Flexible or Suggested
* **Phone number** — used for payment processing and SMS confirmation
* **Name** — the payer's name for the transaction record

The customer clicks **Pay Securely Now** to complete the payment.

<Tip>
  Preview every new link before sharing it — confirm the amount, description, and payment flow appear exactly as intended from your customer's perspective.
</Tip>

***

## Share Your Link

Bila gives you two ways to share a payment link with customers:

### Copy Link

Select **Copy Link** from the options menu.

**Confirmation:** A green toast notification appears — *"Payment link copied."*

Paste the URL anywhere — WhatsApp, email, Instagram bio, Facebook post, or your website.

### Download QR

Select **Download QR** from the options menu.

A QR code image is saved to your device. Print it and display it at your physical location — customers scan it to open the payment page directly on their phone.

| Share Method    | Best For                                                           |
| --------------- | ------------------------------------------------------------------ |
| **Copy Link**   | Digital channels — WhatsApp, email, social media, website          |
| **Download QR** | Physical locations — printed menus, reception desks, event signage |

***

## Edit a Link

Select **Edit** from the options menu.

The **Manage Link** screen opens with all current settings pre-filled. You can update:

| Field                     | What You Can Change                                                |
| ------------------------- | ------------------------------------------------------------------ |
| **Link Name**             | Update the name displayed to customers                             |
| **Description**           | Update the payment description                                     |
| **Payment Configuration** | Switch between Customer Chooses, Fixed Amount, or Suggested Amount |
| **Active Status**         | Toggle the link ON or OFF                                          |
| **Target Wallet**         | Change which wallet receives the payments                          |

Once your changes are complete, click **Save Changes**.

**Confirmation:** A green toast notification appears — *"Payment link updated."*

<Warning>
  Changing the **Payment Configuration** or **Amount** on an active link takes effect immediately. Any customer who opens the link after saving will see the new configuration — notify customers if the amount has changed before resharing the link.
</Warning>

***

## Deactivate or Delete a Link

### Deactivate

Select **Deactivate** from the options menu to temporarily disable the link.

The link status updates to `Inactive` in your dashboard. Customers who visit the URL cannot complete a payment until you reactivate it via **Edit → Active Status → ON**.

### Delete

Select **Delete** from the options menu to permanently remove the link.

<Warning>
  Deleting a payment link is permanent and cannot be undone. All customers who visit the URL after deletion will see an error. If you only need to pause payments temporarily, use **Deactivate** instead — the link can be reactivated at any time.
</Warning>

***

## Link Status Reference

| Status     | What It Means                       | Customer Experience                 |
| ---------- | ----------------------------------- | ----------------------------------- |
| `Active`   | Link is live and accepting payments | Customer can open the page and pay  |
| `Inactive` | Link is disabled                    | Customer sees an error — cannot pay |
| `Deleted`  | Link is permanently removed         | Customer sees an error — cannot pay |

***

## Management Action Reference

Use this to quickly decide which action to take in common situations:

| Situation                                          | Recommended Action                     |
| -------------------------------------------------- | -------------------------------------- |
| You want to pause a link during a sold-out period  | **Deactivate** — reactivate when ready |
| You need to update the price or description        | **Edit** — changes apply immediately   |
| You want to check how much a link has earned       | **View Details**                       |
| You want to confirm the link works before sharing  | **Open Link**                          |
| You are sharing the link digitally                 | **Copy Link**                          |
| You are displaying the link at a physical location | **Download QR**                        |
| The link is no longer needed permanently           | **Delete**                             |

***

## Troubleshooting

| Issue                                       | What to Do                                                                                                |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Customer says the link is not working       | Confirm the link status is `Active` in your dashboard — inactive and deleted links cannot accept payments |
| Copied link is not opening correctly        | Re-copy the link via **`...` → Copy Link** — avoid manually typing or editing the URL                     |
| QR code is not scanning                     | Ensure the printed QR is not too small — minimum 3cm × 3cm is recommended for reliable scanning           |
| Payment history shows `Failed` transactions | Ask the customer to retry — confirm their phone number is registered with their mobile money provider     |
| Funds are going to the wrong wallet         | Click **Edit** and update the **Target Wallet** — future payments will route to the new wallet            |
| Link was deleted in error                   | A deleted link cannot be restored — create a new link with the same configuration and reshare the URL     |

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Create a Payment Link" icon="link" href="/payment-links/create-payment-link">
    Set up a new payment link and configure it for your use case.
  </Card>

  <Card title="Track Business Alerts" icon="bell" href="/settings/sms-logs">
    Monitor payment notifications triggered by your payment links in SMS logs.
  </Card>
</CardGroup>