Tokenization
Save a customer's wallet credentials as a source ID (SP token) and charge them on a schedule without re-authentication. Tokenization is available on Easypaisa and JazzCash only.
Tokenization Flow
Tokenization makes scheduled payments more robust and gives merchants more control over package design and recurring charges. The sourceId (SP token) maps to the customer's wallet account details in encrypted form, enabling future charges per your defined schedule.
APIs
| Step | API | Easypaisa | JazzCash |
|---|---|---|---|
| 1. Start tokenization | Initiate | REST Initiate (transactionType = 8) | Hosted page (GET URL) |
| 2. Verify / complete | Verify or Finalize | REST Verify with OTP | Finalize after redirect |
| 3. Recurring charge | Direct Charge | ✅ | ✅ |
| 4. Remove token | Delink | ✅ | ✅ |
Transaction Type
| Value | Meaning |
|---|---|
8 | Tokenization / recurring consent |
SourceId (SP Token)
After successful tokenization, the Verify or Finalize response includes a sourceId:
"sourceId": "sp_xxxxxxxxxxxxxxxx"
Store this securely. Use it for:
- Direct Charge — charge the customer without OTP
- Delink — revoke the saved credentials
warning
Direct Charge cannot run without a valid sourceId. The customer must complete the initial tokenization consent flow first.
Wallet Comparison
| Easypaisa | JazzCash | |
|---|---|---|
operatorId | 100007 | 100008 |
| Initial flow | REST Initiate → Verify (OTP + MPIN) | Hosted page → OTP → Finalize |
amount | Required | Uses amount on hosted page |
| Finalize API | Not required | Required after redirect |
Related Guides
| Guide | Description |
|---|---|
| Initiate | Start Easypaisa tokenization |
| Verify | Complete Easypaisa tokenization |
| Finalize | Complete JazzCash tokenization |
| Direct Charge | Charge a saved wallet |
| Delink | Remove saved credentials |