Skip to main content

Edit individual VA customer

PUT
Authentication

Virtual Account APIs use the same access token as the rest of the platform. Obtain it from the Authentication API and send it on every VA call:

Authorization: Bearer <access_token>

Base URLs for each environment are listed under API environments.

note

What this does: Updates an existing Individual customer. This also doubles as "Remittance customer → Virtual customer" conversion — pass a customer code that already exists in the platform and this call promotes/updates it as a VA customer.

Endpoint​

warning

Same payload shape as Create (Create individual VA customer), with one difference: code is now REQUIRED — it must be the existing customer's code (returned by Create/Receipt), both in the URL path and the payload body.

Fields That Can Actually Be Updated​

FieldPayload Key
Gendergender
Mobile NumbermobileNumber
ID TypeidTypeCode
ID NumberidNumber
OccupationoccupationCode
Job TitlejobTitle
Job IndustryjobIndustry
Address Line 1addressLine1
CountrycountryCode
Statestate
Citycity
Pincodepincode
warning

All other fields (name, date of birth, nationality, ID country, issue/expiry dates, etc.) are not editable through this endpoint, even if included in the payload — send the full payload as on Create, but only the fields listed above will actually change.

Payload Diff vs Create​

"code": "1000000812", // was "customerCode": "" on Create — now the existing customer's code, field renamed to "code" on Edit
"docReferenceNumber": "CUS19SCMHK", // re-upload / re-reference documents if any changed
"firstName": "Rakesh", "lastName": "Doe" // updated fields