Skip to main content
POST /v1/merchants/{merchantID}/links needs the links scope.
The response carries the link’s code. Share https://api.cloudpay.africa/cloudpay/pay/{code}. To turn a link off or back on, use PATCH …/links/{linkID}.

QR codes

Every link also has a QR code, with the Cloudpay logo in the middle:
The QR carries the link itself. The amount, reference and till all come from Cloudpay when it’s scanned, so the payer has nothing to type except their M-Pesa PIN. That removes wrong amounts and wrong account numbers. Put it on invoices, receipts, delivery notes or a screen at the counter.
  • size is 128 to 1024 pixels; the default is 512. Each size scans reliably with the logo in place.
  • The X-Pay-URL response header gives the URL the QR encodes.
  • In the dashboard, each link under Payment links shows its QR. Click it to open a full-size copy you can print.
A payer who opens a link that can’t take payments sees a clear page. Through the API, the link returns: