Create Collection H2H (Custom Checkout)
Endpoint
POST /cashin/pakistan/order/createH2H
Request Headers
| Name | Required | Example | Description |
|---|---|---|---|
Content-Type | Yes | application/json |
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
bankCode | string enum | Yes | Bank code — JAZZCASH_H2H, EASYPAISA_H2H |
amount | number | Yes | Order amount — 100~49999; up to 2 decimal places (rounded). Trailing zeros after the decimal are omitted in the pre-sign string for float amounts |
notifyUrl | string | Yes | Notification callback URL — Sandbox supports automatic callbacks: odd last digit of phone → success; even → failure |
name | string | Yes | Customer name — More realistic values improve success rate and reduce risk-control flags |
phone | string | Yes | Customer phone — 11-digit Pakistani mobile numbers starting with 03. More realistic numbers improve success rate and reduce risk flags |
email | string | Yes | Customer email — More realistic values improve success rate and reduce risk-control flags |
sign | string | Yes | Signature |
appId | string | Yes | Merchant appId — appId assigned by the platform |
mchOrderNo | string | Yes | Merchant order number |
mchId | integer | Yes | Merchant ID |
timestamp | integer | Yes | Submission time — Unix timestamp in seconds |
txChannel | string | Yes | Transaction channel — Fixed value TX_PAK_001 |
productInfo | string | Yes | Product information |
taxNumber | string | No | ID number (CNIC) — Length: 13 digits |
Request Example
json
{
"mchId": 9099,
"txChannel": "TX_PAK_001",
"appId": "R22e9c0f1x3hycRKd0",
"timestamp": 16624500121,
"mchOrderNo": "order_{% mock 'timestamp' %}",
"bankCode": "JAZZCASH_H2H",
"amount": 5000,
"name": "Timothy Gonzalez",
"phone": "03881999382",
"email": "w.gssdyohqr@chvro.cy",
"productInfo": "xxx-Rechange",
"notifyUrl": "http://wxyiwtonif.sj/vpuu",
"sign": "xxxxxx"
}Response Parameters
| Field | Type | Required | Description |
|---|---|---|---|
status | integer | Yes | Status |
msg | string | Yes | Message |
data | object | Yes | Data |
data.applyTime | integer | Yes | Application time — Timestamp format |
data.amount | number | Yes | Actual paid amount |
data.expireTime | integer | Yes | Expiration time — Timestamp format |
data.mchOrderNo | string | Yes | Merchant order number |
data.platOrderNo | string | Yes | Platform order number |
data.reference | string | Yes | Reference code |