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 |