post https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v1/enroll
The Register Customer API is used to register new customers and facilitating the creation of digital wallets in the Hexa Platform. This API will do the following:
- Register the customer.
- Perform onboarding check (whenever applicable or opted by the Issuer).
Environment
Sandbox | https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v1/enroll |
Production | Contact your WIBMO KAM or support. |
Sample request
curl --request POST \
--url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v1/enroll \
--header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
--header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
--header 'accept: application/json' \
--header 'bankId: 6060' \
--header 'clientId: 1060' \
--header 'content-type: application/json' \
--header 'entityId: 100' \
--header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
--header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
--data '
{
"token": "e3ln1sSCTF9rgy9AjN5QNAkJruloChEdm7C39FVnfczb5gfIGv"
}
'
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 response type identifier |
clientTxnId | String (100) | Conditional | Echoed from the request. |
formFactor.uniqueNumber | Numeric (16) | Conditional | Masked dummy card number unique to each customer. |
formFactor.urn | Numeric (20) | Conditional | Unique reference number for the customer |
formFactor.securityCode | Numeric (3) | Conditional | A unique security code for the dummy card. |
formFactor.uniqueNumberExpiry | Numeric (4) | Conditional | Expiry of the dummy card (MMYY) |
formFactor.accountDetails.accountNumber | Numeric (15) | Mandatory | Unique wallet ID for a sub-wallet. |
formFactor.accountDetails.accountNumberExpiry | Numeric (4) | Mandatory | Expiry for the wallet. |
Sample response (Decrypted)
{
"customerId": "000000000081",
"responseCode": "00",
"messageCode": 3511,
"clientTxnId": "ram12344ram900",
"clientId": "1060",
"responseDateTime": "20240214184521",
"accosaTransactionId": 43300,
"responseMessage": "CUSTOMER REGISTERED SUCCESSFULLY",
"bankId": 6060,
"accosaRefNo": "13987",
"formFactor": {
"uniqueNumber": "817491 XXXXXX 4794",
"urn": 826564,
"securityCode": "",
"uniqueNumberExpiry": "0226",
"accountDetails": [
{
"accountNumber": "702000003050941",
"accountNumberExpiry": "0225"
}
]
}
}
API response codes
Error Code | Description |
---|---|
00 | CUSTOMER REGISTERED SUCCESSFULLY |
1045 | UNABLE TO PROCESS REQUEST CAUSE OF UNKNOWN FIELD: <FieldName> |
1054 | DUPLICATE REQUEST |
1055 | MALFORMED_REQUEST |
1088 | INVALID REQUEST DATE format |
1231 | DATA_NOT_FOUND |
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 |
1273 | INVALID MOBILE NUMBER |
1283 | LOGIN_SERVICE_INTEGRATION_CALL_FAILURE |
1289 | PROGRAM_NOT_ALLOWED_FOR_PRODUCT |
1290 | FIRSTNAME_CANNOT_BE_BLANK |
1291 | LASTNAME_CANNOT_BE_BLANK |
1295 | PRDUCT_ID_CANNOT_BE_BLANK |
1297 | MOBILE_NUMBER_CANNOT_BE_BLANK |
1300 | DOC_TYPE_CANNOT_BE_BLANK |
1305 | AML_NOT_CONFIGURED_FOR_PRODUCT |
1312 | INVALID_DOC_TYPE |
1315 | INVALID_GENDER |
8004 | DUPLICATE EMAIL ID |
8017 | INVALID CITY |
8019 | INVALID STATE |
8021 | INVALID COUNTRY |
8024 | INVALID INITIAL LOAD |
8026 | INVALID DATE OF BIRTH FORMAT |
9310 | CARDHOLDER LAST NAME IS MANDATORY |
9328 | CARDHOLDER FIRST NAME IS MANDATORY |
9333 | KYC EXPIRY NOT CONFIGURED FOR PRODUCT |
9334 | CUSTOMER ONBOARDING IN PROGRESS |
9335 | RISK CATEGORY IS MANDATORY |
9338 | CUSTOMER ALREADY REGISTERED |
9343 | CLIENT TXN ID IS MANDATORY |
10031 | MOBILE NO NOT PRESENT |
10042 | INVALID EMAIL LENGTH |
10043 | MOBILE NO INVALID LENGTH |
10048 | INVALID EMAIL FORMAT |
70012 | DUPLICATE PAN NUMBER WITH MULTIPLE ACCOUNT |
70013 | DUPLICATE VOTER NUMBER WITH MULTIPLE ACCOUNT |
303180 | RISK CATEGORY LENGTH SHOULD NOT BE MORE THAN 20 CHARACTERS |
303181 | PRODUCTID LENGTH SHOULD NOT BE MORE THAN 5 CHARACTERS |
303182 | INITIAL LOAD AMOUNT CURRENCY LENGTH SHOULD NOT BE MORE THAN 3 CHARACTERS |
303183 | KYC PROFILE VALUE SHOULD NOT BE MORE THAN 1000 |
303184 | INVALID INITIAL LOAD VALUE LENGTH |
303185 | RISK SCORE CANNOT BE MORE THAN 1000 |
303186 | FIRST NAME LENGTH SHOULD NOT BE MORE THAN 50 CHARACTERS |
303187 | MIDDLE NAME LENGTH SHOULD NOT BE MORE THAN 50 CHARACTERS |
303188 | LAST NAME LENGTH SHOULD NOT BE MORE THAN 50 CHARACTERS |
303189 | ADDRESS LINE 1 SHOULD NOT EXCEED 50 CHARACTERS |
303190 | ADDRESS LINE 2 SHOULD NOT EXCEED 50 CHARACTERS |