UD
Ultra Digital
Get Started
Back to Integrations
🟢 LIVE PGW VERIFIEDMWallet v1.1 Spec

JazzCash Live API v1.1
Complete Integration Guide

Production-tested developer guide for integrating JazzCash MWallet REST API v1.1, Status Inquiry API, HMAC-SHA256 signature generation, and compliance with the new pp_SubMerchantName rule.

Launch Live Tester App Request Integration Setup
Technical Alert: New Parameter "pp_SubMerchantName"

JazzCash requires the parameter pp_SubMerchantName in all transaction requests. Rules: Alphabets only (A-Z, a-z), no spaces, no special characters (e.g. JazzcashTester or AmazonPay). This parameter must be included in HMAC-SHA256 secure hash calculations.

1. Environment Configuration (.env)

Configure your production JazzCash PGW environment variables. Make sure your live return URL is pre-registered in the JazzCash merchant portal.

# REQUIRED: JazzCash PGW Live Merchant Credentials
VITE_JAZZCASH_MERCHANT_ID=YOUR_MERCHANT_ID
VITE_JAZZCASH_PASSWORD=YOUR_PASSWORD
VITE_JAZZCASH_INTEGRITY_SALT=YOUR_INTEGRITY_SALT

# MANDATORY TECHNICAL UPDATE: SubMerchantName (Alphabets only, no spaces)
VITE_JAZZCASH_SUB_MERCHANT_NAME=YourBrandName

# LIVE ENDPOINTS (Production PGW Environment)
VITE_JAZZCASH_REST_API_URL=https://pgw.jazzcash.com.pk/api/payment/DoTransaction
VITE_JAZZCASH_STATUS_INQUIRY_URL=https://pgw.jazzcash.com.pk/ApplicationAPI/API/PaymentInquiry/Inquire
VITE_JAZZCASH_FORM_URL=https://pgw.jazzcash.com.pk/CustomerPortal/transactionmanagement/merchantform
VITE_JAZZCASH_RETURN_URL=https://yourdomain.com/api/result