Skip to main content
ShadhinPay Docs

Invoices

Bill customers with a shareable payment link or QR code, track invoice status, and download PDFs.

Invoices are the simplest way to get paid without writing any code. You create an invoice in the dashboard, share a link or QR code, and your customer pays on a hosted page using bKash or Nagad.

Creating an invoice

When you create an invoice you set:

  • Line items — each with a description, quantity, and unit price
  • Discount and tax — optional adjustments to the total
  • Total — between ৳10 and ৳200,000
  • Expiry — optional; if set, the invoice can no longer be paid after that date
  • Note — optional message to the customer
  • Redirect URL — optional; where to send the customer after they pay

You can save an invoice as a draft first, or send it straight away.

Each invoice gets a human-readable number like INV-HB_71c4-00042 and a unique, unguessable public link.

Sharing an invoice

Once an invoice is sent, share it however suits your customer:

  • Payment link — a public URL like https://com.shadhinpay.pay/i/{code}
  • QR code — download and print it, or show it on screen
  • Email or SMS — send (or re-send) the invoice directly to the customer

The public payment page shows your logo, business name, the itemised total, and the due date, then lets the customer pay with any provider you have enabled.

Invoice statuses

StatusMeaning
DraftCreated but not shared yet
SentLive and payable; the customer can open the link and pay
ViewedThe customer has opened the link (still payable)
PaidPayment received — done
CancelledYou cancelled it; it can no longer be paid
ExpiredThe expiry date passed before it was paid

If a customer's payment attempt fails or they cancel, the invoice returns to Sent so they can try again — as long as it hasn't expired or been cancelled.

When an invoice is paid

The moment the customer's payment completes, the invoice flips to Paid and — if you've set up webhooks — your systems receive an invoice.paid event. You'll also see it reflected in your balance.

Refunds don't change the invoice

If you later refund an invoice payment, the invoice stays Paid; the refunded amount is tracked separately. See Refunds.

Downloading a PDF

Every invoice can be downloaded as a PDF for your records or to send to a customer who needs a formal document.

Cancelling an invoice

You can cancel an invoice while it's still a Draft or Sent (a reason is required). Cancelling blocks any new payment attempts but doesn't affect a payment that's already in progress.

Next steps

On this page