The Link Card API or Card Activation API is called by the client to activate/link card in the system link it to a customer.
For multi-wallet scenario, this API will create all the sub wallets configured for the selected product and link it to the newly activated card.
Environment:https://domain/api/issuance/v2/activate
HTTP Method: POST
Request parameters
<WalletHeader />
Body
Note:
Encryption or decryption methodology is AES-192-CBC bits encryption.
Parameter | Description | Example |
---|---|---|
Encrypted | ||
token |
| Pl8F5kDZcvADIiursiA |
Decrypted | ||
messageCode |
| 1080 |
clientTxnId |
| GOUd789hhhjfscs |
isStatusCheckRequest |
| true |
urn |
| 70000000008 |
last4Digits |
| 4664 |
loginId |
| 1 |
loadAmount |
| 100000 |
taxAmount |
| 100 |
feeAmount | Fee amount is the amount which deducted as transaction fee and won't be loaded to the card. It will be implied decimal by 2 digits | 1000 |
sourceAccountType |
| |
cardprofileId |
| 150 |
customerId |
| 000123467790 |
cardholderFirstName |
| Ashish |
cardholderLastName |
| Kumar |
cardholderMobile |
| 919888888888 |
cardholderEmail |
| |
cardholderAddress |
| Koramangala, Bangalore |
cardholderCity |
| Bangalore |
cardholderState |
| Karnataka |
cardholderCountry |
| India |
cardholderZipCode |
| 560020 |
cardholderDateOfBirth |
| 19951201 |
identityProof |
| PAN (optional) |
identityProofNumber |
| Bzmty1234 |
ovdName |
| James Jocob |
isPanValid |
| 1 |
firstName |
| |
lastName |
| |
dateOfBirth |
| |
email |
| |
mobile |
| |
address |
| Near Meenakshi Temple |
city |
| Bangalore |
state |
| Karnataka |
country |
| India |
zipCode |
| 560001 |
productId |
| 303001 |
Sample request
Packet sample (Encrypted)
{
“token”: “h/0YSUdGzgNsMcmfYAvIIPgF3Z80/kMJkW/7l9wG9L+bXt//P/HBG0NsuoPtbn6ugjzNOLl/wQPJFbCKMqQJtSSQs4JVYBohia1TPP1yJULHN+TLIVKFRZsg0GokTPI+ZKpNPcrKrQSa70qV/RtVWMv6CmqRHaG1gQvgAYKjNyOpip7G3Io5IDEF4b2cXOlH4G1hbOtjAHQ/7ZS9KrkmJA==”
Packet sample (Decrypted)
{
"messageCode": "3424",
"clientTxnId": "04d85b52thsfhglcheckActivate047",
"requestDateTime": "20230122161759",
"isStatusCheckRequest": true,
"urn": 70000000008,
"last4Digits": 5109,
"loginId": 1,
"loadAmount": 100000,
"taxAmount": 100,
"feeAmount": 0,
"sourceAccountType": 0,
"cardProfileId": 300,
"customerId": "129324",
"cardHolder": {
"cardProfileId": 300,
"cardholderFirstName": "SandeepKWibmoA",
"cardholderLastName": "Pd",
"cardholderMobile": "600140016908",
"cardholderEmail": "[email protected]",
"cardholderAddress": "Address",
"cardholderCity": "Vijayawada",
"cardholderState": "Karnataka",
"cardholderCountry": "null",
"cardholderZipCode": "534437",
"cardholderDateOfBirth": "22-04-1997",
"identityProof": "",
"identityProofNumber": "",
"employeeId": "abhd12",
"ovdName": "James Jacob",
"isPanValid": "1"
},
"nominee": {
"firstName": "San",
"lastName": null,
"dateOfBirth": null,
"email": null,
"mobile": null,
"address": null,
"city": null,
"state": null,
"country": null,
"zipCode": null
},
"productId": 1
}
Response parameters
Parameter | Description | Example |
---|---|---|
Encrypted | ||
token | Token is the Encrypted body of the below request AES-192-CBC bits Encryption | Pl8F5kDZcvADIiursiAvvbHNuL9Wv5eaFdorGVFU6FKfIEnV/YskkzJlAov2ZHJWnqGNLOXfBq4SQqw8Ep4sK0gCAAkRXATCb1nSY6s= |
Decrypted | ||
messageCode | Code to Identity create card response type | 1011 |
clientTxnId | Value copied from the request | 20150701235959xhstiesqfds |
responseDateTime | Response date time in the format YYYYMMDDHHMMSS with time in 24 hr format | 20161031214559 |
accosaTransactionId | Unique id for a particular transaction generated in Prepaid | 3591893 |
responseCode | Contains the status of the transaction. 201 indicates CREATED. Please refer Appendix for other response codes | 201 |
responseMessage | Response message based on response code will be sent | Card creation successful |
description | Reserved field to send information to client | Card Creation response |
urn | A unique reference number for the generated card/wallet by Prepaid system | 70000000008 |
cardNumber | Encrypted card number | Dj2Y0ikRWp2B9n4271 |
accosaRefNo | Auto generated sequence number. | 4565166 |
clientId | Unique ID for client | 2000 |
API error codes
Error Code | Description |
---|---|
0 | SUCCESS |
1001 | CARD NOT FOUND |
1004 | CARD ALREADY ACTIVATED |
1009 | CARD_CANCELLED_CLOSED_EXPIRED |
1010 | CARD_TEMPORARY_BLOCK |
1012 | CARD_PENDING_CANCELLATION |
1013 | AML MIN LIMIT |
1030 | INVALID_MESSAGE |
1045 | UNABLE_TO_PROCESS_REQUEST |
1052 | SYSTEM ERROR |
1056 | INVALID MESSAGE CODE |
1058 | INVALID_WALLETS |
1093 | INVALID CLIENT TXN ID |
1101 | UNKNOWN_SOURCE_ACCOUNT_TYPE |
1118 | CARD CREDIT BLOCK |
1303 | CUSTOMER DETAILS NOT PRESENT |
1366 | PROGRAM IS INACTIVE |
1367 | PROGRAM NOT FOUND |
1368 | SUBWALLET OR ACCOUNTNO SHOULD BE PRESENT |
1501 | SYSTEM_ERROR_DB |
1504 | SYSTEM_CACHE_FAILURE |
8004 | DUPLICATE EMAIL ID |
HTTP status code
HTTP Status Code | HTTP Status Description |
---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized |
500 | Internal Server Error |
403 | Forbidden |
404 | Not Found |
503 | Service Unavailable |
Sample response
Packet sample (Encrypted)
{
“token”: “h/0YSUdGzgNsMcmfYAvIIPgF3Z80/kMJkW/7l9wG9L+bXt//P/HBG0NsuoPtbn6ugjzNOLl/wQPJFbCKMqQJtSSQs4JVYBohia1TPP1yJULHN+TLIVKFRZsg0GokTPI+ZKpNPcrKrQSa70qV/RtVWMv6CmqRHaG1gQvgAYKjNyOpip7G3Io5IDEF4b2cXOlH4G1hbOtjAHQ/7ZS9KrkmJA==”}
Packet sample (Decrypted)
{
"urn": 70000000008,
"customerId": "00002345677",
"description": "Card Activation",
"responseCode": "00",
"messageCode": 3425,
"clientTxnId": "fiji131bwr123vrvr68",
"clientId": "2000",
"responseDateTime": "20230203114910",
"accosaTransactionId": 441,
"responseMessage": "SUCCESS",
"bankId": 7000,
"accosaRefNo": "40051"
}