Easypaisa
Collect payments with Easypaisa
EASYPAISA collects by wallet push through Easypay’s mobile account
transaction. The payer enters their Easypaisa number on the portal and approves
the payment in their Easypaisa app. They never leave the portal page. It works
on every payment screen that takes a wallet number, including admin invoice
prompts and agent float top-ups.
Offered in the country catalog for Pakistan (PK), in Pakistani rupees. An ISP that prices in another currency is refused at checkout.
Centipid Billing uses two calls from the Easypay API:
initiate-ma-transactionsends the payment request.inquire-transactionreports whether it was paid.
Nothing is credited until the inquiry reads PAID.
Configure the gateway
Get your credentials from Easypaisa
From your Easypay merchant account, copy your Store ID, Account number, Username and Password.
Open Settings → Payments → Easypaisa in Centipid
Enter the four values. There is no URL to register: Centipid reads each payment back from Easypaisa.
Run a controlled test payment
Pay PKR 10 from the captive portal, approve it in the Easypaisa app, and confirm the payment reaches the ledger.
Credentials
| Field | Required | Notes |
|---|---|---|
| Store ID | Yes | Sent as storeId. |
| Account number | Yes | Sent as accountNum on status checks. |
| Username | Yes | With the password, sent as the Credentials header. |
| Password | Yes | See above. |
How a payment completes
Centipid checks the payment’s status every 5 seconds for about 3 minutes after
the request is sent and credits it only when Easypaisa reports PAID. A payment
the payer approves after that window is not credited automatically.
If Easypaisa times out or answers with a server error, Centipid still checks the payment’s status in case the request reached the payer. Only a clear refusal from Easypaisa is shown to the payer as a failure.
Troubleshooting
- “Unable to send the Easypaisa payment prompt”: Easypaisa refused the request, usually wrong credentials or Store ID. The response is in the application log.
- “Enter a Pakistani mobile number”: the number is not a
03…mobile number. - “Easypaisa bills in PKR, but your prices are in …”: the ISP’s prices are in another currency. Contact Centipid support to change it.
- “Your billing currency is not set”: contact Centipid support.
