Skip to main content

Update Contact Info

PATCH 
/v2/customer-persons/:customerId/contact-info

This API enables B2B operators to securely and efficiently update a customer's email address or mobile number on their behalf, focusing on data integrity and robust error handling to prevent unauthorized access.

Optional Customer Data Verification Flow:

For brands that require a customer data verification step, the client should have independently initiated and submitted the verification process successfully. The resulting verificationId must be passed to this API to correlate the contact information update with the completed verification.

  • Initiate a customer data verification process on the front end by specifying flow=WALLET_UPDATE and selecting the specific attribute to change, such as email address or mobile number.
  • Submit a customer data verification attempt tied to the existing process, using the value sent through the secure notification channel to confirm the chosen attribute.
  • Provide the verificationId returned from the verification process as an optional field in this request to securely link the contact information update to the completed verification.

The key considerations when updating the contact info are as follows:

  • Single Contact Policy: Each user profile can have only one email address and one mobile number at any given time.
  • Primary Designation: The specified email and mobile number are treated as the primary contact details.
  • Verification Requirement: Only verified contact information can be updated in the user’s profile; unverified details are not allowed.
  • Uniqueness: Each email and mobile number must be unique across accounts, preventing duplicate registrations.
  • Reassignment of Old Contact: When a contact detail is updated, the previous one is marked as removed and cannot be used by other users until it is totally removed. A request to the operations team is needed to totally remove the attribute, making it available for future registrations.

Request​

Responses​

OK