The Update Profile API will update a cardholder or wallet holder’ s profile basis the input details shared. Profile parameters that can be updated are:
- KYC status (Ex. Simple CDD to Full CDD). Note: Although system allows down-grading of KYC Profile, the client must have a clear compliance policy around it .
- Email ID
- Mobile No. Although system allows upgrading of mobile number, the client must have a clear compliance policy around it.
- Customer Name & Address
Client can share Customer’s Customer ID (entityCIF) or Mobile Number or URN as customer identifier basis which Wallet-holder’s profile will be updated.
Environment: https://domain/mob1/api/onboarding/v1/updateProfile
HTTP Method: PATCH
Note:Domain will be shared once this move to respective environment).
Request parameters
Header
Parameter | Description | Example |
|---|---|---|
x-api-key mandatory |
| 7fe1c0de |
clientId |
| 2000 |
bankId |
| 7000 |
entityId |
| 100 |
secureCode |
| AfYtlO5kqdySIjXyNmGg3F |
Body
Sample request
Packet sample (Encrypted)
{
“token”: “h/0YSUdGzgNsMcmfYAvIIPgF3Z80/kMJkW/7l9wG9L+bXt//P/HBG0NsuoPtbn6ugjzNOLl/wQPJFbCKMqQJtSSQs4JVYBohia1TPP1yJULHN+TLIVKFRZsg0GokTPI+ZKpNPcrKrQSa70qV/RtVWMv6CmqRHaG1gQvgAYKjNyOpip7G3Io5IDEF4b2cXOlH4G1hbOtjAHQ/7ZS9KrkmJA==”
} Packet sample (Decrypted)
{
"messageCode": "1280",
"productId": "9",
"clientTxnId": "thhye88697as14353323422", "requestDateTime": "2022061314719", "firstName": "Jacob",
"cardProfileId": "300",
"lastName": "James",
"email": "[email protected]",
"urn": "7000000008",
"address": "MGRaod, India ",
"addressline1": "#3,dasMeena Nilayat", "addressline2": "2nd ddCrosss, Tejewswini agar", "addressline3": "Near Meenakshi Temple ", "zipCode": "560022",
"country": "India",
"city": "Bangalore",
"state": "Karnataka", "dateOfBirth": "11-07-1995", "gender": "Male", "sorCustomerId": "7dsfhhabc", "docList": [
{
"docType": "Pancard", "docCountry": "India", "docNumber": "ABCDE1234A"
}, {
}, {
}, {
"docType": "VoterId", "docCountry": "Argentina", "docNumber": "YCV0189823"
"docType": "Driverlicense", "docCountry": "U.S",
"docNumber": "DL66 20211234567"
"docType": "Passport",
"docCountry": "India",
"docNumber": "A1234567" }
],
"kycDateStamp": "20161031214559",
"newcardProfileId": "150",
"profileIdChangeDate": "20161031214559",
"updateVectors": "emailId,address,city,state,country,zipcode,alternateEmailId", "updateDate": "20220616214559",
"alternateEmailId":"[email protected]"
}Only with mandatory parameters
{
"messageCode": "1280",
"productId": "9",
"clientTxnId": "sandeepbharasrq1zazz3a2422", "requestDateTime": "2022061314719", "firstName": "Sandeep",
"cardProfileId": "150",
"urn": "70000000008",
"dateOfBirth": "11-07-1995"
}Response parameters
Parameter | Description | Sample value |
|---|---|---|
Encrypted | ||
token | Token is the Encrypted body of the below request AES-192-CBC bits Encryption | Pl8F5kDZcvADIiursiAvv |
Decrypted | ||
messageCode | Code to Identify load response type | 1081 |
clientTxnId | Value copied from the request | GOUd789hhhjfscs |
responseDateTime | Response date time in the format YYYYMMDDHHMMSS with time in 24 hr format | 20161031214559 |
urn | A unique reference number for the generated card by Prepaid system | 70000000008 |
customerId | Customer Id(entityCIF), which uniquely identifies the cardholder in the client system. Conditional with mobile number and Urn | 11001188721 |
accosaTransactionId | Unique ID for a particular transaction generated in Prepaid | 3591893 |
responseCode | Contains the status of the transaction. 00 indicates success. Please refer Appendix for other response codes | 0 |
responseMessage | Response message based on response code will be sent | Success |
description | Reserved field to send information to client |
|
cardProfileId | Card profile ID can be any of the following:
| 150 |
accosaRefNo | Auto generated sequence number | 123212 |
clientId | Unique ID for the client | 2000 |
bankId | Bank Id is provided by Prepaid Aero during program enrolment to uniquely identify the card issuer. | 7000 |
API error code
| Error Code | Description |
|---|---|
| 00 | SUCCESS |
| 1034 | INVALID_MOBILE_NUMBER |
| 1088 | INVALID_DATE_FORMAT |
| 1090 | CARD_PROFILEID_MANDATORY |
| 1091 | INVALID_CARDPROFILE_ID |
| 1092 | INVALID_EMAIL_ADDRESS |
| 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 |
| 1290 | FIRSTNAME_CANNOT_BE_BLANK |
| 1300 | DOC_TYPE_CANNOT_BE_BLANK |
| 1305 | AML_NOT_CONFIGURED_FOR_PRODUCT |
| 1306 | PROFILE_NOTFOUND |
| 1309 | CARDPROFILE_MISTMATCH |
HTTP status code
| HTTP Status Code | HTTP Status Description |
|---|---|
| 200 | OK |
| 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)
{
"customerId": "62508ram44910", "responseCode": "00",
"messageCode": 1281,
"clientTxnId": "12345ramn610012", "clientId": "2000",
"responseDateTime": "20230804181306", "accosaTransactionId": 3117, "responseMessage": "SUCCESS",
"bankId": 7000,
"cardProfileId": 30
}