Change Card Status API

Request Method :: POST
Base URL: Will be shared later.
Endpoint: /ppcard/cms/change_card_status
Description:This API allows authorized systems or users to update the status of a prepaid card.

Headers

Content-Type: application/JSON
client_secret: To be shared during integration by ISU Team
client_id:  To be shared during integration by ISU Team

Request Body Parameters

Parameters Parameter description with validations Sample Data type Mandatory/Optional
cardRefNumber Card reference number "1500001899" String Mandatory
requestedStatus Requested status.Please refer to the Note for Details of Requested Status "DEACTIVATE" String Mandatory
channel Name of the Channel WEB String Mandatory
latLong Comma separated by Latitude and longitude 19.0759837,72.8776559 String Mandatory
remarks Remarks "Deactivating this card" String Mandatory

Sample Request Body

Response Body Parameters

Parameters Description Data type
statusCode Status Code(0/1) String
statusDesc Status Description of Status String
status SUCCESS/FAILED String

Sample Response Body

SUCCESS:

 

FAILED:

If card is not mapped to the customer.

 

Detailed Status Codes

Status Response Type Description
0 SUCCESS Card Has Been Successfully Deactivated
1 FAILED Card is not mapped to this customer.

Note:

ACTIVATE: Use this status to activate your card, making it ready for use.

DEACTIVATE: Choosing this option will permanently deactivate your card. Once deactivated, it cannot be reactivated and will be hot-listed.

TEMPBLOCK: This status allows you to temporarily block your card. You can activate it again later if needed using "ACTIVATE" key in requestedStatus field.

DAMAGE: Select this status to mark your card as damaged. A damaged card cannot be reactivated and will be hotlisted.

LOST: Use this status to report your card as lost. A lost card cannot be reactivated and will be hotlisted.

STOLEN: Choose this status to report your card as stolen. A stolen card cannot be reactivated and will be hot-listed.