Skip to content
ISPManISPMan Docs

Checkout links

A checkout link is a small public payment page with its own short code, for example https://…/checkouts/ABC. Anyone who opens it enters their M-Pesa number, gets a payment prompt on their phone, and sees the confirmation on the page. Use checkout links to collect money outside the normal hotspot or PPPoE flow: installation fees, equipment, event WiFi, or a payment you want to share on WhatsApp or as a printed QR code.

Checkout links live at /dashboard/payments/checkout. Open that address directly in your browser while signed in to the dashboard.

Section titled “Create a checkout link”
  1. Go to /dashboard/payments/checkout and click Create Checkout.
  2. In Create M-Pesa Checkout Link, fill in:
    • Description: what the payment is for. Payers see it on the page.
    • Currency: KES, TZS, UGX or USD.
    • Amount (Optional): set it for a fixed price. Leave it empty to let the payer type the amount (shown as Variable amount).
    • Callback URL (required): a web address where ISPMan posts a confirmation each time a payment completes. Use your own system’s webhook URL here.
  3. Optionally turn on Use Custom Code and enter exactly 3 letters or digits in Custom Code (it is converted to uppercase). A preview of the URL appears. Otherwise ISPMan generates a code for you.
  4. Click Create Checkout Link. You see “Checkout link created” with the full URL.

The new link appears in the Checkout Links list with its code, currency, amount (or Variable amount), description and creation date.

Section titled “Share and track a link”

Click a link in the list to open its page (/dashboard/payments/checkout/<code>). From there you can:

  • Copy URL to share the payment page.
  • Download QR to print or post a QR code that opens the page.
  • Copy API Secret, a secret for your own system to verify the confirmations posted to your callback URL. Keep it private.
  • See the Callback URL the link posts to.
  • See totals: Total Collections, Available Balance and Number of Wallets, followed by the payments received through this link.

What the payer sees

Section titled “What the payer sees”

The public page is titled M-Pesa Checkout and shows your business name, the Checkout Code, the Amount to Pay (for a fixed amount) and the description. The payer enters their M-Pesa Phone Number (for a variable link, also the amount), submits, and approves the prompt on their phone. The page waits and shows when the payment is confirmed.

Section titled “Related”