Update Profile API

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

Body

Attribute

Description

Example

Encrypted

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=

Decrypted

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

Parameter

Description

Sample value

Encrypted

token

Token is the Encrypted body of the below request AES-192-CBC bits Encryption

 Pl8F5kDZcvADIiursiAvv
bHNuL9Wv5eaFdorGVFU6F
KfIEnV/YskkzJlAov2ZHJ
WnqGNLOXfBq4SQqw8Ep4
sK0gCAAkRXATCb1nSY6s=

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 - Full CDD
  • 30 – Simple CDD
  • 300- No CDD

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 CodeDescription
00SUCCESS
1034INVALID_MOBILE_NUMBER
1088INVALID_DATE_FORMAT
1090CARD_PROFILEID_MANDATORY
1091INVALID_CARDPROFILE_ID
1092INVALID_EMAIL_ADDRESS
1231DATA_NOT_FOUND
1237DUPLICATE_MOBILE_NUMBER_WITH_MULTIPLE_ACCOUNT
1238INVALID_VOTERID_NUMBER
1239INVALID_PASSPORT_NUMBER
1240INVALID_ADHAR_NUMBER
1241INVALID_DRIVING_LICENCE_NUMBER
1242INVALID_PAN_NUMBER
1245CUSTOMER_ID_CAN_NOT_BE_EMPTY
1290FIRSTNAME_CANNOT_BE_BLANK
1300DOC_TYPE_CANNOT_BE_BLANK
1305AML_NOT_CONFIGURED_FOR_PRODUCT
1306PROFILE_NOTFOUND
1309CARDPROFILE_MISTMATCH

HTTP status code

HTTP Status CodeHTTP Status Description
200OK
404Not Found
500Internal Server Error
403Forbidden
400Bad Request
401Unauthorized
503Service 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
}