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 | String This is a unique key. | 7fe1c0de |
| clientId mandatory | String Uniquely identifies the client. During program enrolment each client is provided with a unique client id by Prepaid | 2000 |
| bankId mandatory | Numeric Bank Id is provided by Prepaid Aero during program enrolment to uniquely identify the card issuer. | 7000 |
| entityId mandatory | Numeric Defaults to parent branch i.e., 100 | 100 |
| secureCode mandatory | String Uniquely identifies the client on payload level for performing operations. | AfYtlO5kqdySIjXyNmGg3F |
Body
| Attribute | Description | Example |
|---|---|---|
| ||
| token mandatory | String Token is the Encrypted body of the below request AES-192-CBC bits Encryption | Pl8F5kDZcvADIi ursiAvvbHNuL9Wv 5eaFdorGVFU6FKfIEn V/YskkzJlAov2ZHJW nqGNLOXfBq4SQqw8E p4sK0gCAAkRXATCb1 nSY6s= |
| ||
| messageCode mandatory | Numeric Code to Identify load card request type.Character Limit - 4 | 1080 |
| clientTxnId mandatory | String Unique ID generated by the client for each transaction.Character Limit - 14 | GOUd789hhhjfscs |
| customerId conditional | String Customer ID (entityCIF), which uniquely identifies the cardholder in the client system. It is conditional with mobile number and URN, i.e., either one of them should be present. Character Limit - 20 | 11001188721 |
| urn conditional | String A unique reference number for the generated card. Need to share this in request body of the APIs. It is Conditional with mobile number and Customer ID, i.e., either one of them should be present.Character Limit - 11 | 70000000008 |
| customerMobile conditional | Numeric Mobile number of the cardholder. It is conditional with customer iD and URN, i.e., either one of them should be present. Please append 91 at the beginning of this field.Character Limit - 13 | 919888888888 |
| sorCustomerId optional | StringCustomer ID (entityCIF), which uniquely identifies the cardholder in the client Issuer system. This is not required for MGL. | 7dsfhhabc |
| newcardprofileId optional | NumericNew KYC Profile to be updated.- 150-full CDD - 30-Simple CDD - 300- No CDD | 150 |
| ProfileIdchangedate optional | Numeric Local Date and time stamp when the prof ID change is done YYYYMMDDHHMMSS with time in two (2). | 20161031214559 |
| cardProfileId mandatory | Numeric Present KYC Profile Id.- 150-full CDD - 30-Simple CDD - 300- No CDD | 300 |
| docType optional | String Document Type Of the CardHolder. One Card Holder can have many Documents. This is not required for MGL. | Aadhar , Pancard, VoterId, Driverlicense, Passport, jobcard |
| docCountry optional | String The Country Name On which document is issued. This is not required for MGL. | India ,U.S,Argentina |
| docExpiry optional | Numeric The Expiry Time for Document. In case of Full KYC this is required. This is not required for MGL. | 20231201 |
| docNumber optional | String OVD No need to be passed. like aadhaar number, PAN card number. This is not required for MGL. | 3675 9834 6015 |
| cKycDocNo optional | Numeric This is the cKyc No for the user shared by client to Prepaid system. At least one KYC related OVD detail is mandatory. This is not required for MGL. | 123456 |
| docConsent optional | Boolean The consent of the card holder. In Case of Aadhaar validation of Full KYC user consent is required. This is not required for MGL. | true |
| kycDateStamp optional | Numeric Date Time when KYC is created for customer.at the time of Full KYC it will require.YYYYMMDDHHMMSS is format. | 20161031214559 |
| updateVectors optional | String Pass any for update: emailId, address, city, state, country, zipcode, alternateEmailId. | emailId, mobile, address, city, state, country, zipcode |
| updateDate optional | Numeric The date on which parameters are updated. | 20161031214559 |
| addressline1 optional | String Postal Address of the cardholder. | # 2,Meena Nilaya |
| addressline2 optional | StringPostal Address of the cardholder | 2nd Cross, Tejewswini Nagar |
| addressline3 optional | String Postal Address of the cardholder. | Near Meenakshi Temple |
| cardholderAddress optional | String Postal Address of the cardholder which is mandatory for Full-CDD Customers. | Koramangala, Bangalore |
| cardholderCity optional | String City of the cardholder. | Bangalore |
| cardholderState optional | String State of the cardholder. | Karnataka |
| cardholderCountry optional | String Country of the cardholder. | India |
| cardholderZipCode optional | String Zip Code of the cardholder. | 560020 |
| firstName optional | String First Name of the cardholder. | Sourav |
| lastName optional | String Last Name of the cardholder. | Mishra |
| emailId optional | String Email Address of the cardholder. | [email protected] |
| dateOfBirth optional | Numeric Date of Birth of the Customer in YYYYMMDD format. | 19951201 |
| gender optional | String Gender Of the cardholder . | Male/Female/Transgender |
| alternateEmailId optional | String Alternate email ID of the cardholder. | [email protected] |
| sorDisable optional | Boolean If SOR is disabled SORr integration will not happen | true |
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
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
}