Skip to main content

​
Collect payments with OPay

OPAY uses a hosted cashier: Centipid Billing creates a checkout session, sends the payer to OPay’s page, and confirms the result on a signed callback. Offered in the country catalog for Nigeria (NG) and Pakistan (PK).

​
Before you start

  1. Complete OPay merchant onboarding in an account owned by the ISP.
  2. From the OPay dashboard collect the merchant ID, the public key, and the private key.
  3. Plan the walled garden: the payer’s browser must reach OPay’s cashier page, so a Hotspot subscriber who is not yet online cannot pay unless OPay is reachable pre-authentication.

​
Configure the gateway

1

Open Settings → Payments → OPay

Select OPay from the payment marketplace.
2

Enter the merchant ID

Merchant ID (required) is sent as a header on every request.
3

Enter the public key

Public key (required) authenticates outgoing checkout requests.
4

Enter the private key

Private key (required, stored as a secret) is what validates the callback signature. Without the right value, confirmations are rejected.
5

Register the callback, return, and cancel URLs

See Callback URLs below.
6

Run a controlled test payment

Pay a small amount from the captive portal on an unauthenticated device, and confirm both the cashier page loads and the payment reaches the ledger.

​
Credentials

Requests go to OPay’s live API. There is no sandbox switch on this form, so test with a small real amount rather than with test credentials.

​
Callback URLs

Settings → Payments shows three: All three are also sent with every checkout request. Register them in the OPay dashboard where OPay requires it, and confirm they are not blocked by a firewall or WAF rule.
Callbacks are verified with an HMAC-SHA512 signature computed with your private key. A wrong private key means every callback is rejected — payers are charged and never provisioned. If checkout works but the ledger stays empty, suspect this key first.

​
What the payer must provide

Whatever OPay’s cashier page asks for — bank transfer, card, or the OPay wallet. The payer’s email, phone number, and name are sent with the request when known, so keep subscriber profiles accurate. The country and currency come from your account’s country. A checkout session expires 30 minutes after it is created.

​
How a payment completes

1

Request

Centipid Billing creates the cashier session with the amount in minor units, the reference, and the return, cancel, and callback URLs.
2

Payment

The payer completes the payment on OPay’s page.
3

Confirmation

OPay posts a signed callback. The signature is verified, the transaction matched on its reference, and the payment status re-read from OPay rather than trusted from the callback body alone. Repeated callbacks for a transaction already recorded are ignored, not double-credited.

​
Troubleshooting

For every gateway’s fields in one place, see the credential reference.