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://your-domain.com/api/v2/request.php

Request Headers

Name	Value
Content-Type	application/json
X-Api-Key	your-provided-api-key

Request Parameters

Parameter	Date Type	Required	Description
pid	String	Required	Your unique Partner ID provided during registration
amount	Integer	Required	Your order amount
order_id	String	Required	Your unique order identifier
pak_wallet	String	Required	Pakistan wallet: "JAZZCASH", "EASYPAISA"
account_number	String	Required	Customer's JazzCash or EasyPaisa account number (must start with '03')
signature	String	Required	SHA256 signature for request validation
ip	String	Required	Customer's IP address
name	String	Required	Customer's full name
email	String	Required	Customer's email address
phone	String	Required	Customer's phone number
latitude	String	Required	Customer's location latitude
longitude	String	Required	Customer's location longitude
customer_id	String	Required	Customer's gameID
redirect_url	String	Required*	URL to redirect user after payment completion. *Required if not configured during registration

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.