Skip to main content

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.

​
Overview

Payment links are shareable URLs that let your customers pay you directly — no checkout integration or POS device needed. Configure each link with a fixed, suggested, or flexible amount, assign it to any wallet, and share it anywhere: WhatsApp, email, Instagram bio, or your website.
Only admins with Merchant Admin or Initiator & Approver roles can create and manage payment links.

​
Prerequisites

Before you begin, make sure you have:
  • Admin access to your Bila dashboard
  • At least one active wallet to receive funds
  • A clear name and description for the payment link ready
Click Payment Links in the left sidebar. The Payment Links dashboard displays summary stats at the top and a table of all existing links below.
StatWhat It Shows
Total Payment LinksThe total number of links created on your account
Active LinksLinks currently enabled and accepting payments
Total CollectedCumulative amount received across all payment links
Click the + New Link button at the top right of the page. The Manage Link screen opens.

​
Step 3: Fill in Basic Information

FieldWhat to Enter
Link NameA clear, descriptive name customers will see — e.g. IT Consultancy
DescriptionAn explanation of what the customer is paying for — e.g. Payment for technical documentation and system security manuals as per the April agreement
Use specific, professional link names and descriptions — customers see these on the payment page before entering their details. A clear description reduces payment disputes and confusion.

​
Step 4: Set the Payment Configuration

Choose how you want to collect the amount:
OptionHow It WorksBest For
Customer ChoosesCustomer enters any amount they wishDonations, tips, open invoices
Fixed AmountA set amount the customer cannot changeSpecific products, service packages
Suggested AmountA default amount the customer can editDeposits, flexible invoices
If you select Fixed Amount or Suggested Amount, an amount field will appear for you to enter the value in ZMW.

​
Step 5: Set Target Wallet and Visibility

Target Wallet Under the Settlement section, select the wallet where incoming payments should be deposited from the Target Wallet dropdown — e.g. Development Work (ZMW) or Main Wallet (ZMW). Active Status Use the Active Status toggle to control whether the link is live:
Toggle StateWhat It Means
ONLink is live — customers can open it and make payments immediately
OFFLink is disabled — customers who visit the URL cannot complete a payment
You can create a link with Active Status set to OFF to prepare it in advance — flip it ON when you are ready to start accepting payments. This is useful for campaign launches or scheduled payment windows.
  1. Review all the details you have entered.
  2. Click Create Link in the top right corner.
Confirmation: A green toast notification appears at the top of the screen — “Payment link created.”
You are returned to the Payment Links dashboard. Your new link now appears in the table. Each link in the table shows the following:
ColumnWhat It Shows
LinkThe name and description of the payment link
TypeThe payment configuration — Flexible, Fixed, or Suggested
AmountThe configured amount in ZMW, or Flexible if customer-defined
PaymentsThe number of completed payments received through this link
CollectedThe total amount collected via this link to date
StatusWhether the link is Active or Inactive

​
Payment Configuration Reference

Use this to decide which configuration fits each use case:
SituationRecommended Configuration
Charging a fixed fee for a serviceFixed Amount
Collecting a deposit where the customer may pay moreSuggested Amount
Receiving donations or tipsCustomer Chooses
Sharing one link for multiple different invoice valuesCustomer Chooses
Running a product pre-order at a set priceFixed Amount
Issuing a recurring retainer where amount may varySuggested Amount
To edit, deactivate, or delete an existing payment link:
  1. Locate the link in the Payment Links table.
  2. Click the options menu ... on the right side of the link row.
  3. Select the action you want to perform.
ActionWhat It Does
EditOpens the Manage Link screen to update name, description, amount, or wallet
DeactivateDisables the link — customers cannot complete payments until reactivated
DeletePermanently removes the link — this cannot be undone
Deleting a payment link is permanent. Any customer who tries to visit the URL after deletion will see an error. If you only need to pause payments temporarily, use Deactivate instead.

​
Troubleshooting

IssueWhat to Do
Link created but customers cannot payConfirm the Active Status toggle is ON — inactive links do not accept payments
Funds not appearing in the expected walletCheck the Target Wallet setting on the link — payments go to whichever wallet was selected at creation
Customer says the link is not workingVerify the link status is Active in your dashboard and share the correct URL
Need to change the target wallet after creationClick ... → Edit and update the Target Wallet field, then save
Payment link amount needs updatingClick ... → Edit, update the amount, and save — the new amount applies to all future payments on that link

​
Next Steps

Wallet-to-Wallet Transfers

Move funds from your payment link wallet to another wallet or sub-wallet.

Track Business Alerts

Monitor payment notifications triggered by your payment links.