Update Customer Details

Overview

The Update Customer Details endpoint allows you to modify an existing customer's contact information such as email address and phone number.

This endpoint is typically used:

• After wallet creation when contact details weren't initially captured
• When customers change their email or phone number
• To correct errors in customer contact information
• To update incomplete customer profiles

Prerequisites

• Existing wallet with valid account number
• At least one field to update (email or phone number)

---

Endpoint

POST /waas/Onboarding/updateCustomerDetails

---

Request Parameters

Required Headers

Header	Value
Authorization	Bearer <access_token>
Ocp-Apim-Subscription-Key	Your access subscription key
Content-Type	application/json

Request Body Fields

Field	Type	Required	Description
requestId	string	Yes	Unique client-side reference for tracking
accountNo	string	Yes	Customer's wallet/account number (10 digits)
email	string	Conditional*	Customer's email address (valid email format)
phoneNumber	string	Conditional*	Customer's phone number (including country code)

* Conditional = At least one of email or phoneNumber must be provided. Both can be updated in a single request.

Update Behavior

• If only email is provided, only the email is updated
• If only phoneNumber is provided, only the phone number is updated
• If both are provided, both are updated simultaneously
• If neither is provided, the request will fail

---

Response

Success Response

{
  "succeeded": true,
  "code": "200",
  "message": "successful request",
  "data": {},
  "pageMeta": {},
  "errors": {}
}

Verification

Always verify that the update was successful by checking succeeded: true in the response.

---

Error Handling

Common Errors

Code	Message	Cause	Resolution
400	Bad Request	Missing both email and phone	Provide at least one field
400	Bad Request	Invalid email format	Check email syntax
400	Bad Request	Invalid phone format	Include country code
31	Invalid account number	Account doesn't exist	Verify account number
404	Not Found	Wallet not found	Check if wallet exists

Next Steps

• Implement Wallet Funding to enable transactions
• Set up Wallet Enquiry to retrieve updated details
• Configure notifications for contact detail changes

---