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 (E.g. Min KYC to Full KYC).
  • Email ID
  • Mobile number
  • Customer name and address

📘

Note:

It is not recommended to update the customer mobile number if you are using it as an user identifier.

You can share customer’s customer ID, mobile number or URN as customer identifier basis which wallet-holder’s profile will be updated.

Environment

Sample request
curl --request PATCH \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/updateprofile \
     --header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
     --header 'bankId: 6060' \
     --header 'clientId: 1060' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "cUVoolx+taCEhY4sg8p6N1AK4Y7FQvwqGRPuxvGhwqx1N0DBEh/qDiwzpyKDJd9qnLe13DOcDjLWXM0evUWUd+kcMrKUcySsDjAjHOruiD/XrMXW5eIuuSY5LqXAtXJmXWu/DkhuJS3MJ4TF9M0Cnqvoxk40gU3Iu8vN0dHEIn1m0oH1YUHLO7l1fm/+C8ZfeNlvo16ba9x3pPFbjMBnoWQ+Gf+abLHrqOrR1W4EUEjFMacnbDSiCoolCi1W9RdlsBk38BRxAXJsHVhpL569irIHMArl0nJMfrKuJzEPrCOsTue2P1W++jyt2+dd6DRZywyGzau9jlVyIqQj8UzI+UWrIob59dRYtKzeUtX0L6CBVU42riQppeIVoX0SnqsKNz3XFZDgDUYuc4qz4L55Rp8SDcN/N/KOuMiqu8kxF6G91NEo3S4VFyEwks51Bm5jhqCeELiUfcGwy1XN9rfVWtiwnZCYwOR3k3AqRwhoT4k="
}
'
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:

ParameterTypeParameter RequirementDescription
messageCodenumeric(4)MandatoryAPI Unique IDentifier.
clientTxnIdstring(100)MandatoryValue echoed from the request
urnnumeric(11)OptionalA unique reference number for the card(urn)
descriptionstring(100)OptionalReserved field to send information to client
cardProfileIdnumeric(2)Mandatory150 - Full KYC, 30 – Min KYC, 300- Shortfall KYC
Sample response (Decrypted)
{
    "customerId": "62508ram44910",
    "responseCode": "00",
    "messageCode": 1281,
    "clientTxnId": "12345ramn610012",
    "clientId": "2000",
    "responseDateTime": "20230804181306",
    "accosaTransactionId": 3117,
    "responseMessage": "SUCCESS",
    "bankId": 7000,
    "cardProfileId": 30
}
API response codes (Decrypted)
Error CodeDescription
00SUCCESS
1001CARD NOT FOUND
1034INVALID_MOBILE_NUMBER
1050INVALID PRODUCT
1054DUPLICATE REQUEST
1088INVALID REQUEST 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
1304MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED
1305AML_NOT_CONFIGURED_FOR_PRODUCT
1306PROFILE_NOTFOUND
1309CARDPROFILE_MISTMATCH
8007EXISTING CARDHOLDER PROFILE MATCHES WITH NEW CARDHOLDER PROFILE
77101INVALID DATA TYPE FOR FIELD MESSAGECODE
85114INVALID DATA TYPE FOR FIELD URN

Request parameters

Language
URL
Click Try It! to start a request and see the response here!