Skip to main content

Tokenization — Delink

Remove a saved sourceId (SP token) so no further direct charges can be made against the customer's wallet account. The customer must complete the tokenization flow again to re-enable recurring charges.

Applies to: Easypaisa · JazzCash


Endpoint

MethodPOST
Path/v2/wallets/transaction/delink
Sandboxhttps://sandbox.simpaisa.com/v2/wallets/transaction/delink
Productionhttps://payin.simpaisa.com/v2/wallets/transaction/delink

Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
modeYespayin
regionYesPK
operatorIdYes100007 (Easypaisa) or 100008 (JazzCash)
versionYes3.0

Request Body

ParameterTypeRequiredLengthDescription
merchantIdStringYes7Simpaisa-assigned merchant ID
operatorIdStringYes06100007 or 100008
sourceIdStringYesSP token to revoke

Response Body

ParameterDescription
statusResponse code — success means token is revoked
messageHuman-readable status
operatorIdPayment channel ID
merchantIdYour merchant ID
sourceIdEcho of the revoked SP token
info

After a successful Delink, Direct Charge calls against that sourceId will fail. The customer must go through Initiate and Verify / Finalize again.


CURL

curl --location 'https://sandbox.simpaisa.com/v2/wallets/transaction/delink' \
--header 'Content-Type: application/json' \
--header 'mode: payin' \
--header 'region: PK' \
--header 'operatorId: 100007' \
--header 'version: 3.0' \
--data '{
"merchantId": "xxxx",
"operatorId": "100007",
"sourceId": "sp_xxxxxxxxxxxxxxxx"
}'

Samples

{
"merchantId": "xxxx",
"operatorId": "100007",
"sourceId": "sp_xxxxxxxxxxxxxxxx"
}