# Easypaisa

> Collect Pakistani mobile wallet payments with Easypaisa. The payer enters their wallet number and approves the request in the Easypaisa app. Setup and tips.

Source: https://docs.centipidbilling.com/billing/payment-gateways/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

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