Skip to content

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:

  1. initiate-ma-transaction sends the payment request.
  2. inquire-transaction reports whether it was paid.

Nothing is credited until the inquiry reads PAID.

Configure the gateway

  1. Get your credentials from Easypaisa

    From your Easypay merchant account, copy your Store ID, Account number, Username and Password.

  2. Open Settings → Payments → Easypaisa in Centipid

    Enter the four values. There is no URL to register: Centipid reads each payment back from Easypaisa.

  3. 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.