post https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/replaceCard
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 |