The Create/Wallet API will create a virtual prepaid card or a wallet basis the customer details shared in the API. The client will also share the KYC status of the customer along with the corresponding document type and number.
Before creating the card/wallet, this API will also check if the customer ID (entityCIF) and mobile number shared by the client are unique within the Client program. It will throw an error in case if it already exists.
Environment: https://domain/mob1/api/issuance/v1/createCard
HTTP Method: POST
Note:
The domain will be shared once this move to respective environment.
Request parameters
Body
Sample request
Packet sample (Encrypted)
{
“token”: “h/0YSUdGzgNsMcmfYAvIIPgF3Z80/kMJkW/7l9wG9L+bXt//P/HBG0NsuoPtbn6ugjzNOLl/wQPJFb
CKMqQJtSSQs4JVYBohia1TPP1yJULHN+TLIVKFRZsg0GokTPI+ZKpNPcrKrQSa70qV/RtVWMv6Cmq RHaG1gQvgAYKjNyOpip7G3Io5IDEF4b2cXOlH4G1hbOtjAHQ/7ZS9KrkmJA==”
}
Packet sample (Decrypted)
{
"messageCode": "1010",
"productId": "1",
"clientTxnId": "wibffgjkfdfgffg7f321", "requestDateTime": "2023050914729", "firstName": "SandeepKvP", "lastName": "S",
"mobile": "919888888888", "customerId": "625778hj4fff", "dateOfBirth": "11-07-1993",
"cardProfileId": "30", "sourceAccountType": 11, "docList": [
{
"docType": "Pancard", "docCountry": "India", "docExpiry": "20231201",
"docNumber": "ABCDE1234A" },
{
"docType": "VoterId", "docCountry": "Argentina", "docExpiry": "20231201", "docNumber": "YCV0189823"
},
{
"docType": "Aadhar",
"docCountry": "India,U.S,Argentina", "docExpiry": "20231201", "docNumber": "3849 9070 1992", "cKycDocNo": "123456", "docConsent": "true"
}, {
}, {
"docType": "Passport", "docCountry": "India", "docExpiry": "20231201", "docNumber": "A1234567"
"docType": "Driverlicense", "docCountry": "U.S",
"docExpiry": "20231201", "docNumber": "DL14 20110012345"
} ],
"newCardStatus": "Active",
"loadAmount": "0",
"eventid": 303001
}
Response parameters
Parameter | Description | Example |
---|---|---|
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 |
customerId | Customer Id(entityCIF), which uniquely identifies the cardholder in the client system. | 9712938648 |
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 |
cardExpiry | Expiry of the card in format MMYY | 0X21 |
cardCVV2 | Encrypted CVV for the card | Si1Z3ikRWp2B9n4271vn |
cardProfileId | Card Profile Id shared with the client for the product | 150 |
loadAmount | Load amount for which card has been activated. It is in implied decimals by two digits | 50000 |
availableBalance | Card available balance (implied decimals) | 50000 |
availableCashLimit | Available Cash Limit on the card (implied decimals) | 0 |
accosaRefNo | Auto generated sequence number. | 4565166 |
loginProfileId | A user profile is created for the customer. Customer will be authenticated using this ID while logging into any customer portal provided by WIBMO prepaid (optional feature). Not required for MGL. | 541 |
clientId | Unique ID for the client | 2000 |
SubwalletDetails. subwallet_id | Subwallet id of the subwallet | Mob497d9a_1 |
SubwalletDetails. default_wallet | Whether this subwallet is default subwallet or not.
| 0/1 |
SubwalletDetails. available_balance | Total available balance of the subwallet | 20000 |
SubwalletDetails. account_number | Account number of the subwallet | 9150101002858 |
SubwalletDetails. account_status | Account status of the subwallet | 9 – pre-active |
SubwalletDetails. subwallet_name | Subwallet name of the subwallet | “MGL gpr wallet” |
SubwalletDetails. ledger_balance | Ledger balance linked to the subwallet | 10000 |
API error codes
Error Code | Description |
---|---|
00 | SUCCESS |
10 | CARD_ALREADY_CREATED |
1030 | INVALID_MESSAGE |
1033 | ERROR_CARD_CREATION |
1034 | INVALID_MOBILE_NUMBER |
1050 | INVALID_PRODUCT |
1055 | MALFORMED_REQUEST |
1058 | INVALID_WALLETS |
1088 | INVALID_DATE_FORMAT |
1091 | INVALID_CARDPROFILE_ID |
1237 | DUPLICATE_MOBILE_NUMBER_WITH_MULTIPLE_ACCOUNT |
1238 | INVALID_VOTERID_NUMBER |
1239 | INVALID_PASSPORT_NUMBER |
1240 | INVALID_ADHAR_NUMBER |
1241 | INVALID_DRIVING_LICENCE_NUMBER |
1242 | INVALID_PAN_NUMBER |
1245 | CUSTOMER_ID_CAN_NOT_BE_EMPTY |
1283 | LOGIN_SERVICE_INTEGRATION_CALL_FAILURE |
1289 | PROGRAM_NOT_ALLOWED_FOR_PRODUCT |
1290 | FIRSTNAME_CANNOT_BE_BLANK |
1291 | LASTNAME_CANNOT_BE_BLANK |
1292 | CARD_STATUS_CANNOT_BE_BLANK |
1293 | INVAILD_CARD_STATUS |
1295 | PRDUCT_ID_CANNOT_BE_BLANK |
1296 | CARDPROFILE_ID_CANNOT_BE_BLANK |
1297 | MOBILE_NUMBER_CANNOT_BE_BLANK |
1298 | INVALID_SRC_ACCT_TYPE |
1300 | DOC_TYPE_CANNOT_BE_BLANK |
1301 | DUPLICATE_MOBILE_NUMBER |
1305 | AML_NOT_CONFIGURED_FOR_PRODUCT |
1308 | INVALID_EVENT_TYPE_FOR_CARD_CREATION |
1317 | DATE_OF_BIRTH_IS MANDATORY |
1320 | REQUEST_DATETIME_IS_MANDATORY |
8004 | DUPLICATE EMAIL ID |
HTTP status code
HTTP Status Code | HTTP Status Description |
---|---|
201 | Created |
404 | Not Found |
500 | Internal Server Error |
403 | Forbidden |
400 | Bad Request |
401 | Unauthorized |
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": 70000000128,
"customerId": "62508mob34908", "description": "Card Creation", "responseCode": "201",
"messageCode": 1011,
"clientTxnId": "Sreekumar0000ram119",
“responseDateTime”: "20230803120640", "clientId": "2000",
"accosaTransactionId": 2995,
"responseMessage": "CARD_CREATED_SUCCESSFULLY", "bankId": 7000,
"accosaRefNo": "41394",
"cardNumber": "5427800000046711",
"cardExpiry": "0828",
"cardCVV2": "047",
"cardProfileId": 300,
"loadAmount": 0,
"availableBalance": 0,
"availableCashLimit": 0,
"loginProfId": 0,
"subwalletListDetails": [
{
"subwallet_id": "2008daa1640_1",
"default_wallet": 1, "available_balance": "0", "account_number": "700003005498", "account_status": "0", "subwallet_name": "GPR Single Wallet", "ledger_balance": "0"
}