A Cancel Token message is a request to cancel/deactivate an already generated Token. Please request the context URL from Interswitch.

 

8.1 Bulk Token Batch Cancel Request (Sent from Third-party)
The following describes the important element required to be sent for a Cancel Token request.

The following describes the important element required to be sent for a Cancel Token request.

S/N	Data Element (DE)		Description
1	referenceId	Mandatory	Original referenceId used in bulk token generation call. E.g. 324555
2	frontEndPartner	Mandatory	Front End Partner ID sent in bulk token generation call

 

Sample Request

DELETE {context}/ pwm/bulk/tokens Content-Type: application/json [Other HTTP headers]… transactionRef  12343434 frontEndPartner  IFIS

8.2 Bulk Token Batch Cancel Response (Sent from Interswitch)
The following describes the important data element required for a Cancel Token response.

S/N	Data Element (DE)	Description
1	code	Response code of the operation e.g. 00
2	Description	Response message of the operation e.g Success

 

Successful Response

HTTP Status Code:  200   { “code”: “00”, “description”: “Successfully queued to be cancelled” }

 

Unsuccessful Response

HTTP Status Code: 401   { “errors”: [ { “code”: “E50”, “message”: “referenceId cannot be empty.” } ], “error”: { “code”: “E50”, “message”: ” referenceId cannot be empty.” } }     HTTP Status Code:  401   { “errors”: [ { “code”: “10904”, “message”: “No record of batch with provided reference Id – 324555 for the front end partner – 455” } ], “error”: { “code”: “10904”, “message”: “No record of batch with provided reference Id – 324555 for the front end partner – 455” } }