Sign in

v1

latestOpenAPI 3.1.02026-07-201774202.6 KB
Account holders

Update an account holder

Updates the accountHolderDetails and processingTier of an account holder, and adds bank accounts and shareholders.

When updating accountHolderDetails, parameters that are not included in the request are left unchanged except for the following object:

  • metadata: Updating the metadata replaces the entire object. This means that to update an existing key-value pair, you must provide the changes, as well as other existing key-value pairs.

When updating any field in the following objects, you must submit all the fields required for validation:

  • address

  • fullPhoneNumber

  • bankAccountDetails.BankAccountDetail

  • businessDetails.shareholders.ShareholderContact

For example, to update the address.postalCode, you must also submit the address.country, .city, .street, .postalCode, and possibly .stateOrProvince so that the address can be validated.

To add a bank account or shareholder, provide the bank account or shareholder details without a bankAccountUUID or a shareholderCode.

post/updateAccountHolder

Request body

accountHolderCodestring required

The code of the Account Holder to be updated.

processingTierinteger

The processing tier to which the Account Holder should be updated.

The processing tier can not be lowered through this request.

Required if accountHolderDetails are not provided.

Response

OK - the request has succeeded.

accountHolderCodestring

The code of the account holder.

pspReferencestring

The reference of a request. Can be used to uniquely identify the request.

resultCodestring

The result code.

submittedAsyncboolean

Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied:

  • true: The request is queued and will be executed when the providing service is available in the order in which the requests are received.
  • false: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.