Card Replacement API

The Card Replacement API facilitates the replacement of the existing card with the new non-perso (instakit card). The old and new card URNs will be required to perform the card replacement. The new card will be activated and linked to the user’s wallet/account.

📘
Note:
The old card will be permanently blocked if not already.

Environment


Sandbox	<https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/replaceCard>
Production	Contact your WIBMO KAM or support.

Sample request

curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/replaceCard \
     --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'

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)	Conditional	API Unique IDentifier.
clientTxnId	String (100)	Conditional	Echoed from the request.
newUrn	Numeric (11)	Mandatory	New activated card’s URN.

Sample response (Decrypted)

{
	"responseCode": "00",
	"messageCode": 1211,
	"clientTxnId": "test8fhjkj878j1",
	"clientId": "2030",
	"responseDateTime": "20240206170243",
	"accosaTransactionId": 11671,
	"responseMessage": "SUCCESS",
	"bankId": 7030,
	"newUrn": 70000001244
}

Error codes

Error Code	Description
00	SUCCESS
1001	CARD NOT FOUND
1004	CARD ALREADY ACTIVATED
1011	CARD PERMANENT BLOCK
1031	INVALID BANK ID
1032	INVALID CLIENT CHANNEL
1049	INVALID SECURE CODE
1052	SYSTEM ERROR
1053	REQUEST NOT FOUND
1056	INVALID MESSAGE CODE
1081	OPERATION NOT ALLOWED
1088	INVALID DATE format
1093	INVALID CLIENT TXN ID
1133	Card is already expired. Please try with different card
1134	Card cannot be activated as Minimum Usage validity is 6 months for this Product.
1283	LOGIN SERVICE INTEGRATION CALL FAILURE
1295	PRDUCT_ID_CANNOT_BE_BLANK
1303	CUSTOMER DETAILS NOT PRESENT
1320	REQUEST_DATETIME_IS_MANDATORY
1342	Unique IDENTIFIER REQUIRED LIKE URN OR CUSTOMERID
1346	URN IS MANDATORY
1359	INVALID LOAD AMOUNT
1376	INVALID UNLOAD AMOUNT
1398	ACCOUNTNO SHOULD BE PRESENT
1500	SYSTEM ERROR
1502	SYSTEM ERROR
3008	OLD URN IS MANDATORY
3009	NEW URN IS MANDATORY
3010	CARDHOLDER ALREADY EXIST FOR NEW URN
3011	OLD URN IS ALREADY PERMANENTLY BLOCKED
5003	BANK ID NOT WITH CLIENT
6905	INVALID ACCOUNT_NUMBER_IN_REQUEST
7953	ACCOUNT NOT ACTIVE
9343	CLIENT TXN ID IS MANDATORY
10177	CARD NOT FOUND
303178	Request Date Time Length should not be more than 14 characters

Note:

Request parameters