Tokenization Initiate JazzCash
The tokenization flow for JazzCash differs from Easypaisa. For JazzCash, a hosted page (handled by the payment channel) opens first, and the customer enters their details there to proceed with the transaction.
The following parameters are passed in the URL to open the hosted page:
| Parameter | Required | Type | Length | Description |
|---|---|---|---|---|
MerchantId | Yes | String | 7 | A unique ID provided by Simpaisa to represent each merchant |
Amount | Yes | String | — | The amount to charge in PKR |
OrderId | Yes | String | — | Generated by the merchant to track the transaction |
MobileNo | Yes | String | 10 | Customer's mobile number (MSISDN) without country code prefix |
transactionType | Yes | String | — | Fixed value 8 to indicate the tokenization flow |
ReturnUrl | Yes | String | — | The URL where JazzCash redirects the user after authentication on the hosted page |
SubscriptionPeriod | No | String | — | Recurrence interval for auto-billing |
platform | No | String | — | Routes charge and refund IPNs to separate webhook endpoints. Set the value to 3. |
Hosted Page URL
| Environment | Base URL |
|---|---|
| Sandbox | https://sandbox.simpaisa.com |
| Production | https://jazzcash.simpaisa.com |
With platform parameter
{{protocol}}://{{url}}/jc/registrationfull?Amount=X&MobileNo=X&ReturnUrl=X&OrderId=X&MerchantId=X&transactionType=8&platform=3
Without platform parameter
{{protocol}}://{{url}}/jc/registrationfull?Amount=X&MobileNo=X&ReturnUrl=X&OrderId=X&MerchantId=X&transactionType=8
info
The URL above opens a hosted page that must be handled properly so the user can input their payment details.
Once the payment details are entered, the user receives an OTP that must be entered on a second screen to approve the transaction.
Example (sandbox)
With platform parameter
# Open in browser — replace placeholders
https://sandbox.simpaisa.com/jc/registrationfull?Amount=1&MobileNo=3XXXXXXXXX&ReturnUrl=https://merchant.example/callback&OrderId=test-jc&MerchantId=2000XXX&transactionType=8&platform=3
Without platform parameter
# Open in browser — replace placeholders
https://sandbox.simpaisa.com/jc/registrationfull?Amount=1&MobileNo=3XXXXXXXXX&ReturnUrl=https://merchant.example/callback&OrderId=test-jc&MerchantId=2000XXX&transactionType=8
Example (production)
With platform parameter
# Open in browser — replace placeholders
https://jazzcash.simpaisa.com/jc/registrationfull?Amount=1&MobileNo=3XXXXXXXXX&ReturnUrl=https://merchant.example/callback&OrderId=test-jc&MerchantId=2000XXX&transactionType=8&platform=3
Without platform parameter
# Open in browser — replace placeholders
https://jazzcash.simpaisa.com/jc/registrationfull?Amount=1&MobileNo=3XXXXXXXXX&ReturnUrl=https://merchant.example/callback&OrderId=test-jc&MerchantId=2000XXX&transactionType=8