Skip to main content

Edit business 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 Business customer, or converts an existing Remittance customer into a Virtual customer — same as the Individual edit flow (Edit individual VA customer), one level up.

Endpoint​

warning

Same payload shape as Create (Create business VA customer), with these differences: code is now REQUIRED (existing customer's code, returned by Create/Receipt — note the field is named customerCode in the Create payload but code here, confirmed by IT) ownerDetailList becomes OPTIONAL on Edit — send null if the ownership structure hasn't changed, or the full array to replace it

Fields That Can Actually Be Updated​

FieldPayload Key
Mobile NumbermobileNumber
Nature Of BusinessnatureOfBusinessCode
Emailemail
Address Line 1addressLine1
CountrycountryCode
Statestate
Citycity
Pincodepincode
warning

All other fields (trade name, legal status, business relationship, ID details, ownerDetailList, etc.) are not updatable through this endpoint, even if included in the payload — only the fields listed above will actually change.

Payload Diff vs Create​

"code": "1000000857", // was "customerCode": "" on Create — field renamed to "code" on Edit
"noIssueDate": true, "noIdExpiry": true, // flags flipped true...
"idIssuedBy": "", "issueDate": "", "idExpiryDate": "", // ...so these become empty, not omitted
"ownerDetailList": null // unchanged owners — send null instead of the array