PayGo
PayGo is a QR-code wallet. The customer scans a code to authorise the payment — you collect nothing from them up front. It is currently offered in ZiG only.
| Payment method code | PZW210 |
| Currency code to send | ZiG |
| Amount range | 1.00 – 2,400.00 |
| Required fields | None |
| Redirect required | No |
Customer experience
Section titled “Customer experience”The customer is shown a QR code and scans it with the PayGo app to approve the payment. With Hosted checkout the Pesepay-hosted page renders the code for you, which is the simplest way to support PayGo.
Direct API
Section titled “Direct API”PayGo needs no required fields — send an empty object:
{ "paymentMethodCode": "PZW210", "paymentMethodRequiredFields": {}}Because you’re not redirecting the customer, you have to render the QR code
yourself. Make Payment returns it in
transactionMetadata:
| Key | Description |
|---|---|
qrCodeUrl | URL of the QR code image to display to the customer |
qrCode | The PayGo transaction identifier the code encodes |
Show the code, then wait for the
result callback or poll pollUrl until the
status is terminal.
Amount limits
Section titled “Amount limits”PayGo accepts 1.00 to 2,400.00 per transaction. Amounts above the
ceiling are rejected, not collected in parts. Read minimumAmount and maximumAmount
live from
Get Payment Methods by Currency to
stay in sync if the limits change.
Failure modes
Section titled “Failure modes”| What happened | What you see |
|---|---|
| The customer doesn’t pay within five minutes, and the QR code expires | The transaction ends CLOSED_PERIOD_ELAPSED, or TIME_OUT if PayGo reports the expiry first |
| Insufficient balance | The transaction fails; the message comes from PayGo and is passed through as free text |
| Amount outside the range | 400 — see Errors |