Reset PIN API

Request Method :: POST
Base URL: Will be shared later.
Endpoint: /ppcard/cms/reset_pin
Description: The Reset PIN API enables clients to securely reset a card’s PIN using an encrypted PIN value.The API validates the card reference, device details, and request channel before processing. The response clearly indicates success or failure with appropriate status codes and messages.

Headers

Content-Type: application/JSON
header_secrets: These values must be generated each time while consuming the API (refer to the generation process mentioned in the note above).
client_id:  To be shared during integration by ISU Team

Request Body Parameters

Parameters Parameter description with validations Sample Data type Mandatory/Optional
encryptPin Encrypted PIN. Format example: Clear pin must be 4 digits. Ex:1234. It Should be encrypted Using the Provided Base64 Pin Key. String Mandatory
cardRefId Card reference ID e.g., "1500002017" Long Mandatory
deviceId Device ID e.g., 869879 String Mandatory (if the channel is ANDROID)
latLong Latitude & Longitude 20.34650575630703, 85.80711840832657 String Mandatory
channel Channel of request WEB 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 Your PIN has been successfully reset
1 FAILED Reset Pin Failed