Set or Reset PIN API

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

The Set/Reset PIN API is used to set or reset the PIN for the card.

Environment


Sandbox	https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v2/fundTransfer
Production	Contact your WIBMO KAM or support.

Sample request

curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/resetPin \
     --header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
     --header 'bankId: 6060' \
     --header 'clientId: 1060' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "lO+YNouaBSM4g7C+33YxbAIOg5SL053shNBmew7bP2Vwbqa245hIpaJJgaO8Vu2czuOXDo7D4e2S58697mvuapEOXTxZtpV4hLyx56i5kFh6In9X68vnfeDCa1gFBWgFWlHqQTIzIXPo6zHsRcz3QhNIQnI3tDW93vU71zNg1MIglZ9z9htSFF0YbMcfedxgAPgYZlGEI8HUFY9mlChpvBa2c4myBQ3Xr9O2KymfZyRvS0HpbBKL/Cdyxsr8B+rEiaDQb9nITaUA2Kka45xB7w=="
}
'

Response parameters (Decrypted)

This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:

Parameter	Type	Parameter Requirement	Description
messageCode	numeric(4)	Mandatory	Code to Identify Reset pin response type.
clientTxnId	string(100)	Mandatory	Value echoed from the request
urn	numeric(11)	Mandatory	Value echoed from the request
accosaRefNo	numeric(20)	Mandatory	Auto-generated sequence number.
responseDateTime	numeric(14)	Mandatory	Response date time in the format YYYYMMDDHHMMSS with time in 24-hour format
customerId	string(20)	Mandatory	Customer ID which uniquely identifies the cardholder in the client system.
accosaTransactionId	numeric(10)	Mandatory	Unique ID for a particular transaction/request generated in Prepaid
responseCode	string(4)	Mandatory	Represents the status of the transaction.
responseMessage	string(100)	Optional	Response message based on the response code.
description	string(100)	Optional	Reserved field to send information to the client.
bankId	numeric(4)	Mandatory	Value echoed from the request header
clientId	String(15)	Mandatory	Value echoed from header

Sample response (Decrypted)

{ 
    "urn": 70000000008, 
    "customerId": "IN00001201001868", 
    "description": "Reset Pin", 
    "responseCode": "00", 
    "messageCode": "1121", 
    "clientTxnId": "201507271458370149gM90jY0", 
    "clientId": "2000", 
    "responseDateTime": "20160715025837", 
    "accosaTransactionId": 1031, 
    "responseMessage": "Success", 
    "accosaRefNo": "6007283", 
    "bankId": 7000 
}

Error codes

Error Code	Description
00	SUCCESS
1001	CARD NOT FOUND
1016	ERROR RESET PIN
1031	INVALID BANK ID
1032	INVALID CLIENT CHANNEL
1049	INVALID SECURE CODE
1054	DUPLICATE REQUEST
1056	INVALID MESSAGE CODE
1081	OPERATION NOT ALLOWED
1083	URN AND LAST 4 DIGITS MISMATCH
1084	URN AND CUSTOMER ID MISMATCH
1085	REQUESTOR UNAUTHORIZED FOR URN OR PRODUCT
1088	INVALID REQUEST DATE format
1093	INVALID CLIENT TXN ID
1099	INVALID_PIN
1116	CARD AML PROFILE MISSING
1302	INVALID_CUSTOMER
1303	CUSTOMER DETAILS NOT PRESENT
1304	MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED
1342	UNIQUE_IDENTIFIER_REQUIRED_URN_OR_CUSTOMERID
1366	PROGRAM NOT FOUND
1366	PROGRAM IS INACTIVE
1367	PROGRAM_INACTIVE
1367	PROGRAM NOT FOUND
1500	SYSTEM ERROR
1501	SYSTEM ERROR
1502	SYSTEM ERROR
5003	CLIENT_NOT_CONFIGURED_UNDER_BANK_ID
9301	PIN_MISSING

Request parameters