Skip to main content
A payment link is a PrimePay checkout address (https://checkout.primepay.mw/l/7KQ2M9XW) you send to a customer by WhatsApp, SMS, email or a QR code. The customer opens it, chooses Airtel Money, TNM Mpamba or PrimePay Wallet, and pays. These are the same links you make in the dashboard under Payment links, and links made with the API show there too. Each payment made through a link is an ordinary payment: you get the usual payment webhooks, and the money follows your account’s normal settlement. Creating a link moves no money, so these endpoints take no Idempotency-Key. Sending the same request twice makes two links; deactivate the one you don’t want. Aggregators make a link for a sub-merchant with POST /v1/sub-merchants/{subMerchantCode}/payment-links. The customer sees the sub-merchant’s name, the sub-merchant is credited, and you keep the agreed fee. If the sub-merchant is later suspended or removed from your account, the link stops taking payments. Validation errors include error.field, which names the field (for example amount or items[1].unitAmount).