post https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v3/createCard
The Create Card API to generate a new card and subsequently associate it with a customer account. It leverages the Customer ID parameter to establish the necessary linkage between the newly generated card and the respective customer.
Environment
| Sandbox | https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v3/createCard \ |
| Production | Contact your WIBMO KAM or support. |
Sample request
curl --request POST \
--url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v3/createCard \
--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": "TVI6w+zbfFA9pBE4c3zSjyNutEWuwI3MiQ54cvtADERCi7Uq9GECHHEJWlHqlOrjf6fR4YnbUXV6ubofEfJL7RocA2XPyf169Z2Oe2QPnYetvIjMjub40YkenTlAHDY/U1AfnhQ3eiZCQoET+uv3OPupdzXrVdoARbQEixNqR7R8vBQycrVBrBgDT9h1BOf46RG3q+ELnHc9YzH5PIqz23h3Gn35dVO1NoFWW4UhiJHUdEKv/oLKx2fcH731C4QshhWWlFlIKFRw52BWrRJv5nzhg3t6f8QtBan1ndgJDrBwp2zhCc9RLSLXZufEjeZS"
}
'
Response parameters
| Attribute | Type | Parameter Requirement | Description |
|---|---|---|---|
| messageCode | Numeric (4) | Mandatory | Code to Identity “Create Card” API response |
| clientTxnId | String (100) | Mandatory | Echoed from the request. |
| description | String(100) | Mandatory | Field to send the description of the API. |
| cardDetailsList.urn | Numeric (12) | Mandatory | A unique reference number for the generated card. This urn is used in place of the actual 16-digit card number created for customer identification. |
| cardDetailsList. cardCVV2 | Numeric (12) | Mandatory | Encrypted CVV |
| cardDetailsList. cardNumber | String (50) | Mandatory | Masked Card Number |
| cardDetailsList.cardExpiry | String (100) | Mandatory | Masked expiry of the card |
Sample response (Decrypted)
{
"description": "Card Creation",
"responseCode": "201",
"messageCode": 1011,
"clientTxnId": "CreateCard_20240219101007",
"clientId": "2030",
"responseDateTime": "20240219154550",
"responseMessage": "CARD_CREATED_SUCCESSFULLY",
"bankId": 7030,
"cardDetailsList": [
{
"urn": 70000001328,
"cardNumber": "4550XXXXXXXX2606",
"cardExpiry": "XXXX",
"cardCVV2": " D5LypgiZjzy3oABrMUxA35q2117nnUeeIzVTT0r/OfU="
}
]
}
Error codes
| Error Code | Description |
|---|---|
| 1 | CARD ALREADY CREATED |
| 201 | CARD_CREATED_SUCCESSFULLY |
| 1003 | ERROR CARD CREATION |
| 1031 | INVALID BANK ID |
| 1032 | INVALID CLIENT CHANNEL |
| 1052 | SYSTEM ERROR |
| 1056 | INVALID MESSAGE CODE |
| 1088 | INVALID DATE FORMAT |
| 1093 | INVALID CLIENT TXN ID |
| 1093 | INVALID CLIENT TXN ID |
| 1275 | INVALID CUSTOMER ID |
| 1283 | LOGIN SERVICE INTEGRATION CALL FAILURE |
| 1289 | PROGRAM_NOT_ALLOWED_FOR_PRODUCT |
| 1293 | INVAILD_CARD_STATUS |
| 1320 | REQ DATE TIME IS MANDATORY |
| 1366 | PROGRAM IS INACTIVE |
| 1501 | SYSTEM ERROR |
| 7960 | CARD CREATION NOT SUPPORTED |
| 9343 | CLIENT TXN ID IS MANDATORY |
| 10239 | PRODUCT ID IS MANDATORY |
| 10240 | INVALID FIELD NEW CARD STATUS |
| 10099 | DATABASE ERROR |
| 303178 | REQUEST DATE TIME INVALID LENGTH |
| 303193 | BLANK MESSAGE CODE |