Back to Blog E-commerce · 10 min read

JazzCash, EasyPaisa & HBL Payment Gateway Integration in Pakistan — What You Need to Know

Pakistan has five major payment gateways and no single one works for every business. Here is how each one works, what it actually costs, and which to integrate first.

By Loop Origin Team·July 2026·10 min read

If you are building an e-commerce website in Pakistan, payment gateway integration is the part that trips up most developers. The documentation is outdated, the sandbox environments are unreliable, and webhook handling is rarely covered in tutorials. This guide covers what actually works in production.

The Payment Landscape in Pakistan (2026)

Pakistan's payment ecosystem has matured significantly. As of 2026, the main options for e-commerce businesses are:

JazzCash — wallet + mobile account + card payments, largest user base (100M+ registered accounts)
EasyPaisa — wallet + OTC payments, strong in lower-tier cities
HBL Pay / PayPak — bank-issued card payments, preferred by corporate buyers
Stripe (via Pakistan entity) — international card payments, USD settlement
PayFast — aggregator that wraps JazzCash, EasyPaisa, and HBL behind one API

For most Pakistani e-commerce businesses, the practical choice is between integrating each gateway individually or using an aggregator like PayFast to get all of them through one integration.

JazzCash Payment Gateway Integration

JazzCash offers two integration paths: their hosted checkout (redirect-based) and their direct API. For e-commerce sites, the direct API gives you more control over the checkout experience but requires MPIN-based authentication from the customer, which adds friction.

What you actually need for JazzCash:

A JazzCash Merchant account (applied for through Mobilink Microfinance Bank, takes 5-10 business days)
Merchant ID, password, and integrity salt from the merchant portal
HMAC-SHA256 signature on every request — this is where most developers make errors
Webhook endpoint to receive payment status callbacks (not always reliable; implement polling as fallback)
Handle transaction reversal manually — refunds through JazzCash API are not automatic

The sandbox works inconsistently. Budget for real test transactions (JazzCash allows small live transactions for testing) before deploying to production.

EasyPaisa Payment Gateway Integration

EasyPaisa is run by Telenor Microfinance Bank and has a separate developer portal. Their API is REST-based and generally more stable than JazzCash's, but their merchant approval process is slower (2–4 weeks).

EasyPaisa integration specifics:

Two flows: Wallet-to-Merchant (customer pays from EasyPaisa wallet) and OTC (customer pays at any EasyPaisa agent using a transaction ID)
The OTC flow is critical for customers in areas with low smartphone penetration
SHA-256 hashing on request parameters in a specific field order — get the order wrong and every request fails silently
Settlement is T+1 in PKR to your nominated bank account

HBL Pay and Bank Card Payments

HBL Pay (formerly HBL Konnect) handles Visa, Mastercard, and UnionPay card transactions. It is the preferred option for B2B and corporate customers who pay by company card. Integration requires an HBL merchant account and uses a 3DS-compliant hosted checkout iframe.

If your business sells to corporate buyers or takes large-ticket orders, HBL Pay or a similar bank gateway (MCB, UBL, Meezan) is worth the setup overhead. Card-to-card payments have lower chargeback risk than wallet transfers and come with proper dispute resolution.

PayFast — The Aggregator Route

PayFast Pakistan is an aggregator that gives you JazzCash, EasyPaisa, bank card payments, and Raast through a single API. The trade-off: PayFast charges 2–3% per transaction on top of the underlying gateway fees, whereas direct integration costs 0.5–1.5% depending on volume.

When PayFast makes sense:

You want all payment methods live quickly (1–2 weeks vs 6–8 weeks for direct integrations)
Your transaction volumes are under PKR 5M/month (above this, direct integration saves meaningfully)
Your dev team does not have backend experience with webhook handling and HMAC signing

When to go direct:

You are doing over 500 transactions/month — the per-transaction fee difference compounds fast
You need refund automation (PayFast manual refunds require a support ticket)
You need split settlements, marketplace payouts, or custom ledger logic

Raast Instant Payment Integration

Raast, Pakistan's central bank-backed instant payment system, now supports merchant payments via IBFT (Interbank Fund Transfer). Settlement is instant, the fee is near-zero, and it works from any bank account in Pakistan. As of 2026, Raast integration for e-commerce is still maturing — most implementations go through a bank's Raast-enabled payment gateway rather than direct SBP API access.

The Right Integration Stack for Pakistani E-commerce

Based on what we have built for Pakistani clients, the practical recommendation is:

Must-have: JazzCash (widest wallet coverage) + HBL or Meezan card gateway (corporate buyers)
Add if targeting tier-2/3 cities: EasyPaisa OTC flow
Add for international buyers: Stripe (requires a Pakistan-registered company)
COD always: Cash on delivery is still 60–70% of Pakistani e-commerce orders — no payment gateway replaces it

The backend implementation that handles all of these cleanly — including idempotent webhook processing, automatic retry on failed callbacks, and a payment ledger that reconciles daily settlements against orders — is roughly 3–4 weeks of backend development time. Doing it right the first time is cheaper than patching a broken payment flow after launch.

If you are building an e-commerce website in Pakistan and want a payment integration that actually works in production, talk to us. We have integrated JazzCash, EasyPaisa, HBL, and Stripe across multiple live Pakistani stores.