Pakistan H2H Integration

API Documentation for Pakistan H2H Integration

Overview

This API allows Pakistan customers to integrate JazzCash and EasyPaisa payment methods into their applications seamlessly.

API Endpoint

POST https://{domain}/api/request.php

Request Headers

Name	Value
Content-Type	application/json

Request Parameters

Parameter	Date Type	Required	Description
pid	String	Required	Your provided PID
amount	Integer	Required	Your requested payment amount
order_id	String	Required	Unique order identifier from your system
name	String	Required	Customer's full name
email	String	Required	Customer's email address
phone	String	Required	Customer's phone number
pak_wallet	String	Required	Payment wallet type. Allowed values: "JAZZCASH", "EASYPAISA"
account_number	String	Required	Customer's JazzCash or EasyPaisa account number (must start with '03')

Sample Request

{
    "pid": "09xxxxx",
    "amount": 60,
    "order_id": "ORD123",
    "name": "demo",
    "email": "[email protected]",
    "phone": "9990000000",
    "pak_wallet": "JAZZCASH",
    "account_number": "03333333333"
}

API Response

Success Response

{ 
    "status": "success", 
    "ref_code": "a5510c2738c08f8....", 
    "amount": 60, 
    "wallet": "JAZZCASH" 
}

Response Parameters

Paramter	Data Type	Description
status	String	Transaction status (success or error)
ref_code	String	Unique reference code for the transaction
amount	Integer	Confirmed payment amount
wallet	String	Payment wallet used (JAZZCASH or EASYPAISA)

Error Response

{ 
    "status": "error", 
    "message": "Error description" 
}

Common Error Messages

Error Message	Description
pid is required field	PID parameter is missing
amount is required field	Amount parameter is missing
order_id is required field	Order ID parameter is missing
We support only 'JAZZCASH', 'EASYPAISA'	Invalid pak_wallet value
account_number is required when pak_wallet is provided	Account number is missing when pak_wallet is specified
Duplicate order_id found	Oder iD already exists in the system
invalid pid	Provided PID is not valid

Important Notes

Account Number Format: The account_number must start with '03'

Key Requirements:

• Each order_idmust be unique across all transactions.

• Only JAZZCASH and EASYPAISA are supported.

• When using Pakistan wallets, both pak_wallet and account_number are mandatory.