openapi: 3.1.0
servers:
- url: https://cal-test.adyen.com/cal/services/Account/v3
info:
  version: '3'
  x-publicVersion: true
  title: Account API
  description: "This API is used for the classic integration. If you are just starting\
    \ your implementation, refer to our [new integration guide](https://docs.adyen.com/adyen-for-platforms-model)\
    \ instead.\n\nThe Account API provides endpoints for managing account-related\
    \ entities on your platform. These related entities include account holders, accounts,\
    \ bank accounts, shareholders, and verification-related documents. The management\
    \ operations include actions such as creation, retrieval, updating, and deletion\
    \ of them.\n\nFor more information, refer to our [documentation](https://docs.adyen.com/classic-platforms).\n\
    ## Authentication\nYour Adyen contact will provide your API credential and an\
    \ API key. To connect to the API, add an `X-API-Key` header with the API key as\
    \ the value, for example:\n\n ```\ncurl\n-H \"Content-Type: application/json\"\
    \ \\\n-H \"X-API-Key: YOUR_API_KEY\" \\\n...\n```\n\nAlternatively, you can use\
    \ the username and password to connect to the API using basic authentication.\
    \ For example:\n\n```\ncurl\n-U \"ws@MarketPlace.YOUR_PLATFORM_ACCOUNT\":\"YOUR_WS_PASSWORD\"\
    \ \\\n-H \"Content-Type: application/json\" \\\n...\n```\nWhen going live, you\
    \ need to generate new web service user credentials to access the [live endpoints](https://docs.adyen.com/development-resources/live-endpoints).\n\
    \n## Versioning\nThe Account API supports [versioning](https://docs.adyen.com/development-resources/versioning)\
    \ using a version suffix in the endpoint URL. This suffix has the following format:\
    \ \"vXX\", where XX is the version number.\n\nFor example:\n```\nhttps://cal-test.adyen.com/cal/services/Account/v3/createAccountHolder\n\
    ```"
  termsOfService: https://www.adyen.com/legal/terms-and-conditions
  contact:
    name: Adyen Developer Experience team
    url: https://github.com/Adyen/adyen-openapi
tags:
- name: Account holders
- name: Accounts
- name: Verification
paths:
  /closeAccount:
    post:
      tags:
      - Accounts
      summary: Close an account
      description: Closes an account. If an account is closed, you cannot process
        transactions, pay out its funds, or reopen it. If payments are made to a closed
        account, the payments are sent to your liable account.
      operationId: post-closeAccount
      x-sortIndex: 3
      x-methodName: closeAccount
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              closeAccount:
                $ref: '#/components/examples/post-closeAccount-closeAccount'
            schema:
              $ref: '#/components/schemas/CloseAccountRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloseAccountResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloseAccountResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /closeAccountHolder:
    post:
      tags:
      - Account holders
      summary: Close an account holder
      description: Changes the [status of an account holder](https://docs.adyen.com/classic-platforms/account-holders-and-accounts#account-holder-statuses)
        to **Closed**. This state is final. If an account holder is closed, you can't
        process transactions, pay out funds, or reopen it. If payments are made to
        an account of an account holder with a **Closed** [`status`](https://docs.adyen.com/api-explorer/#/Account/latest/post/getAccountHolder__resParam_verification-accountHolder-checks-status),
        the payments are sent to your liable account.
      operationId: post-closeAccountHolder
      x-sortIndex: 7
      x-methodName: closeAccountHolder
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-closeAccountHolder-basic'
            schema:
              $ref: '#/components/schemas/CloseAccountHolderRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloseAccountHolderResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloseAccountHolderResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /createAccount:
    post:
      tags:
      - Accounts
      summary: Create an account
      description: Creates an account under an account holder. An account holder can
        have [multiple accounts](https://docs.adyen.com/classic-platforms/account-holders-and-accounts#create-additional-accounts).
      operationId: post-createAccount
      x-sortIndex: 1
      x-methodName: createAccount
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-createAccount-basic'
            schema:
              $ref: '#/components/schemas/CreateAccountRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateAccountResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateAccountResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /createAccountHolder:
    post:
      tags:
      - Account holders
      summary: Create an account holder
      description: Creates an account holder that [represents the sub-merchant's entity](https://docs.adyen.com/classic-platforms/account-structure#your-platform)
        in your platform. The details that you need to provide in the request depend
        on the sub-merchant's legal entity type. For more information, refer to [Account
        holder and accounts](https://docs.adyen.com/classic-platforms/account-holders-and-accounts#legal-entity-types).
      operationId: post-createAccountHolder
      x-sortIndex: 1
      x-methodName: createAccountHolder
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              business:
                $ref: '#/components/examples/post-createAccountHolder-business'
              individual:
                $ref: '#/components/examples/post-createAccountHolder-individual'
            schema:
              $ref: '#/components/schemas/CreateAccountHolderRequest'
      responses:
        '200':
          content:
            application/json:
              examples:
                business:
                  $ref: '#/components/examples/post-createAccountHolder-business-200'
                individual:
                  $ref: '#/components/examples/post-createAccountHolder-individual-200'
              schema:
                $ref: '#/components/schemas/CreateAccountHolderResponse'
          description: OK - the request has succeeded.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/post-createAccountHolder-generic-401'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              examples:
                business:
                  $ref: '#/components/examples/post-createAccountHolder-business-422'
                individual:
                  $ref: '#/components/examples/post-createAccountHolder-individual-422'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/post-createAccountHolder-generic-500'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /deleteBankAccounts:
    post:
      tags:
      - Verification
      summary: Delete bank accounts
      description: 'Deletes bank accounts associated with an account holder. '
      operationId: post-deleteBankAccounts
      x-sortIndex: 4
      x-methodName: deleteBankAccounts
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-deleteBankAccounts-basic'
            schema:
              $ref: '#/components/schemas/DeleteBankAccountRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /deleteLegalArrangements:
    post:
      tags:
      - Verification
      summary: Delete legal arrangements
      description: Deletes legal arrangements and/or legal arrangement entities associated
        with an account holder.
      operationId: post-deleteLegalArrangements
      x-sortIndex: 6
      x-methodName: deleteLegalArrangements
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              arrangements:
                $ref: '#/components/examples/post-deleteLegalArrangements-arrangements'
              entities:
                $ref: '#/components/examples/post-deleteLegalArrangements-entities'
            schema:
              $ref: '#/components/schemas/DeleteLegalArrangementRequest'
      responses:
        '200':
          content:
            application/json:
              examples:
                arrangements:
                  $ref: '#/components/examples/post-deleteLegalArrangements-arrangements-200'
                entities:
                  $ref: '#/components/examples/post-deleteLegalArrangements-entities-200'
              schema:
                $ref: '#/components/schemas/GenericResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                arrangements:
                  $ref: '#/components/examples/post-deleteLegalArrangements-arrangements-400'
                entities:
                  $ref: '#/components/examples/post-deleteLegalArrangements-entities-400'
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /deleteShareholders:
    post:
      tags:
      - Verification
      summary: Delete shareholders
      description: Deletes shareholders associated with an account holder.
      operationId: post-deleteShareholders
      x-sortIndex: 7
      x-methodName: deleteShareholders
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-deleteShareholders-basic'
            schema:
              $ref: '#/components/schemas/DeleteShareholderRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /deleteSignatories:
    post:
      tags:
      - Verification
      summary: Delete signatories
      description: Deletes signatories associated with an account holder.
      operationId: post-deleteSignatories
      x-sortIndex: 8
      x-methodName: deleteSignatories
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteSignatoriesRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /getAccountHolder:
    post:
      tags:
      - Account holders
      summary: Get an account holder
      description: Returns the details of an account holder.
      operationId: post-getAccountHolder
      x-sortIndex: 2
      x-methodName: getAccountHolder
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              accountCode:
                $ref: '#/components/examples/post-getAccountHolder-accountCode'
              accountHolderCode:
                $ref: '#/components/examples/post-getAccountHolder-accountHolderCode'
            schema:
              $ref: '#/components/schemas/GetAccountHolderRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountHolderResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountHolderResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /getTaxForm:
    post:
      tags:
      - Account holders
      summary: Get a tax form
      description: Generates a tax form for account holders operating in the US. For
        more information, refer to [Providing tax forms](https://docs.adyen.com/classic-platforms/tax-forms).
      operationId: post-getTaxForm
      x-sortIndex: 8
      x-methodName: getTaxForm
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-getTaxForm-basic'
            schema:
              $ref: '#/components/schemas/GetTaxFormRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTaxFormResponse'
          description: OK - the request has succeeded.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /getUploadedDocuments:
    post:
      tags:
      - Verification
      summary: Get documents
      description: 'Returns documents that were previously uploaded for an account
        holder. Adyen uses the documents during the [verification process](https://docs.adyen.com/classic-platforms/verification-process).

        '
      operationId: post-getUploadedDocuments
      x-sortIndex: 2
      x-methodName: getUploadedDocuments
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-getUploadedDocuments-basic'
            schema:
              $ref: '#/components/schemas/GetUploadedDocumentsRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetUploadedDocumentsResponse'
          description: OK - the request has succeeded.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /suspendAccountHolder:
    post:
      tags:
      - Account holders
      summary: Suspend an account holder
      description: Changes the [status of an account holder](https://docs.adyen.com/classic-platforms/account-holders-and-accounts#account-holder-statuses)
        to **Suspended**.
      operationId: post-suspendAccountHolder
      x-sortIndex: 5
      x-methodName: suspendAccountHolder
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-suspendAccountHolder-basic'
            schema:
              $ref: '#/components/schemas/SuspendAccountHolderRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuspendAccountHolderResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuspendAccountHolderResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /unSuspendAccountHolder:
    post:
      tags:
      - Account holders
      summary: Unsuspend an account holder
      description: "Changes the [status of an account holder](https://docs.adyen.com/classic-platforms/account-holders-and-accounts#account-holder-statuses)\
        \ from **Suspended** to **Inactive**. \nAccount holders can have a **Suspended**\
        \ [`status`](https://docs.adyen.com/api-explorer/#/Account/latest/post/getAccountHolder__resParam_verification-accountHolder-checks-status)\
        \ if you suspend them through the [`/suspendAccountHolder`](https://docs.adyen.com/api-explorer/#/Account/v5/post/suspendAccountHolder)\
        \ endpoint or if a verification deadline expires.\n\nYou can only unsuspend\
        \ account holders if they do not have verification checks with a **FAILED**\
        \ [`status`](https://docs.adyen.com/api-explorer/#/Account/latest/post/getAccountHolder__resParam_verification-accountHolder-checks-status)."
      operationId: post-unSuspendAccountHolder
      x-sortIndex: 6
      x-methodName: unSuspendAccountHolder
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-unSuspendAccountHolder-basic'
            schema:
              $ref: '#/components/schemas/UnSuspendAccountHolderRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnSuspendAccountHolderResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnSuspendAccountHolderResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /updateAccount:
    post:
      tags:
      - Accounts
      summary: Update an account
      description: Updates the description or payout schedule of an account.
      operationId: post-updateAccount
      x-sortIndex: 2
      x-methodName: updateAccount
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-updateAccount-basic'
            schema:
              $ref: '#/components/schemas/UpdateAccountRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAccountResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAccountResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /updateAccountHolder:
    post:
      tags:
      - Account holders
      summary: Update an account holder
      description: "Updates the `accountHolderDetails` and `processingTier` of an\
        \ account holder, and adds bank accounts and shareholders.\n\nWhen updating\
        \ `accountHolderDetails`, parameters that are not included in the request\
        \ are left unchanged except for the following object:\n\n* `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.\n\nWhen updating any field in the following objects, you\
        \ must submit all the fields required for validation:\n\n * `address`\n\n\
        * `fullPhoneNumber`\n\n* `bankAccountDetails.BankAccountDetail`\n\n* `businessDetails.shareholders.ShareholderContact`\n\
        \n 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.\n\nTo add a bank account or shareholder,\
        \ provide the bank account or shareholder details without a `bankAccountUUID`\
        \ or a `shareholderCode`.\n\n"
      operationId: post-updateAccountHolder
      x-sortIndex: 3
      x-methodName: updateAccountHolder
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              addShareholders:
                $ref: '#/components/examples/post-updateAccountHolder-addShareholders'
              bankAccountDetails:
                $ref: '#/components/examples/post-updateAccountHolder-bankAccountDetails'
              businessDetails:
                $ref: '#/components/examples/post-updateAccountHolder-businessDetails'
              general:
                $ref: '#/components/examples/post-updateAccountHolder-general'
            schema:
              $ref: '#/components/schemas/UpdateAccountHolderRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAccountHolderResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAccountHolderResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /updateAccountHolderState:
    post:
      tags:
      - Account holders
      summary: Update payout or processing state
      description: Disables or enables the processing or payout state of an account
        holder.
      operationId: post-updateAccountHolderState
      x-sortIndex: 4
      x-methodName: updateAccountHolderState
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-updateAccountHolderState-basic'
            schema:
              $ref: '#/components/schemas/UpdateAccountHolderStateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountHolderStatusResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountHolderStatusResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
  /uploadDocument:
    post:
      tags:
      - Verification
      summary: Upload a document
      description: Uploads a document for an account holder. Adyen uses the documents
        during the [verification process](https://docs.adyen.com/classic-platforms/verification-process).
      operationId: post-uploadDocument
      x-sortIndex: 1
      x-methodName: uploadDocument
      security:
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              basic:
                $ref: '#/components/examples/post-uploadDocument-basic'
            schema:
              $ref: '#/components/schemas/UploadDocumentRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAccountHolderResponse'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAccountHolderResponse'
          description: Accepted - the request has been accepted for processing, but
            the processing has not been completed.
        '400':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-400'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Bad Request - a problem reading or understanding the request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              examples:
                generic:
                  $ref: '#/components/examples/generic-403'
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
          description: Internal Server Error - the server could not process the request.
components:
  schemas:
    Account:
      additionalProperties: false
      properties:
        accountCode:
          description: The code of the account.
          type: string
        beneficiaryAccount:
          description: The beneficiary of the account.
          type: string
        beneficiaryMerchantReference:
          description: The reason that a beneficiary has been set up for this account.
            This may have been supplied during the setup of a beneficiary at the discretion
            of the executing user.
          type: string
        payoutSchedule:
          description: The account's payout schedule.
          $ref: '#/components/schemas/PayoutScheduleResponse'
      type: object
    AccountEvent:
      additionalProperties: false
      properties:
        event:
          description: 'The event.

            >Permitted values: `InactivateAccount`, `RefundNotPaidOutTransfers`.

            For more information, refer to [Verification checks](https://docs.adyen.com/classic-platforms/verification-process).'
          enum:
          - InactivateAccount
          - RefundNotPaidOutTransfers
          type: string
        executionDate:
          description: The date on which the event will take place.
          format: date-time
          type: string
        reason:
          description: The reason why this event has been created.
          type: string
      type: object
    AccountEventWrapper:
      properties:
        AccountEvent:
          $ref: '#/components/schemas/AccountEvent'
    AccountHolderDetails:
      additionalProperties: false
      properties:
        address:
          description: The address of the account holder.
          $ref: '#/components/schemas/ViasAddress'
        bankAccountDetails:
          description: Array of bank accounts associated with the account holder.
            For details about the required `bankAccountDetail` fields, see [Required
            information](https://docs.adyen.com/classic-platforms/verification-process/required-information).
          items:
            $ref: '#/components/schemas/BankAccountDetailWrapper'
          type: array
        businessDetails:
          description: 'Details about the business or nonprofit account holder.

            Required when creating an account holder with `legalEntity` **Business**
            or **NonProfit**.'
          $ref: '#/components/schemas/BusinessDetails'
        email:
          description: The email address of the account holder.
          type: string
        fullPhoneNumber:
          description: 'The phone number of the account holder provided as a single
            string. It will be handled as a landline phone.

            **Examples:** "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"'
          type: string
        individualDetails:
          description: 'Details about the individual account holder.

            Required when creating an account holder with `legalEntity` **Individual**.

            '
          $ref: '#/components/schemas/IndividualDetails'
        lastReviewDate:
          description: Date when you last reviewed the account holder's information,
            in ISO-8601 YYYY-MM-DD format. For example, **2020-01-31**.
          type: string
        merchantCategoryCode:
          description: 'The Merchant Category Code of the account holder.

            > If not specified in the request, this will be derived from the platform
            account (which is configured by Adyen).'
          type: string
        metadata:
          additionalProperties:
            type: string
          description: 'A set of key and value pairs for general use by the account
            holder or merchant.

            The keys do not have specific names and may be used for storing miscellaneous
            data as desired.

            > The values being stored have a maximum length of eighty (80) characters
            and will be truncated if necessary.

            > Note that during an update of metadata, the omission of existing key-value
            pairs will result in the deletion of those key-value pairs.'
          type: object
        phoneNumber:
          description: 'The phone number of the account holder.

            > Required if a `fullPhoneNumber` is not provided.'
          $ref: '#/components/schemas/ViasPhoneNumber'
        principalBusinessAddress:
          description: The principal business address of the account holder.
          $ref: '#/components/schemas/ViasAddress'
        webAddress:
          description: The URL of the website of the account holder.
          type: string
      required:
      - address
      type: object
    AccountHolderStatus:
      additionalProperties: false
      properties:
        events:
          description: A list of events scheduled for the account holder.
          items:
            $ref: '#/components/schemas/AccountEventWrapper'
          type: array
        payoutState:
          description: The payout state of the account holder.
          $ref: '#/components/schemas/AccountPayoutState'
        processingState:
          description: The processing state of the account holder.
          $ref: '#/components/schemas/AccountProcessingState'
        status:
          description: 'The status of the account holder.

            >Permitted values: `Active`, `Inactive`, `Suspended`, `Closed`.'
          enum:
          - Active
          - Closed
          - Inactive
          - Suspended
          type: string
        statusReason:
          description: The reason why the status was assigned to the account holder.
          type: string
      required:
      - status
      type: object
    AccountPayoutState:
      additionalProperties: false
      properties:
        allowPayout:
          description: Indicates whether payouts are allowed. This field is the overarching
            payout status, and is the aggregate of multiple conditions (e.g., KYC
            status, disabled flag, etc). If this field is false, no payouts will be
            permitted for any of the account holder's accounts. If this field is true,
            payouts will be permitted for any of the account holder's accounts.
          type: boolean
        disableReason:
          description: The reason why payouts (to all of the account holder's accounts)
            have been disabled (by the platform). If the `disabled` field is true,
            this field can be used to explain why.
          type: string
        disabled:
          description: Indicates whether payouts have been disabled (by the platform)
            for all of the account holder's accounts. A platform may enable and disable
            this field at their discretion. If this field is true, `allowPayout` will
            be false and no payouts will be permitted for any of the account holder's
            accounts. If this field is false, `allowPayout` may or may not be enabled,
            depending on other factors.
          type: boolean
        payoutLimit:
          description: The maximum amount that payouts are limited to. Only applies
            if payouts are allowed but limited.
          $ref: '#/components/schemas/Amount'
        tierNumber:
          x-addedInVersion: '3'
          description: The payout tier that the account holder occupies.
          format: int32
          type: integer
      type: object
    AccountProcessingState:
      additionalProperties: false
      properties:
        disableReason:
          description: The reason why processing has been disabled.
          type: string
        disabled:
          description: Indicates whether the processing of payments is allowed.
          type: boolean
        processedFrom:
          description: The lower bound of the processing tier (i.e., an account holder
            must have processed at least this amount of money in order to be placed
            into this tier).
          $ref: '#/components/schemas/Amount'
        processedTo:
          description: The upper bound of the processing tier (i.e., an account holder
            must have processed less than this amount of money in order to be placed
            into this tier).
          $ref: '#/components/schemas/Amount'
        tierNumber:
          x-addedInVersion: '3'
          description: The processing tier that the account holder occupies.
          format: int32
          type: integer
      type: object
    AccountWrapper:
      properties:
        Account:
          $ref: '#/components/schemas/Account'
    Amount:
      additionalProperties: false
      properties:
        currency:
          description: The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          maxLength: 3
          minLength: 3
          type: string
        value:
          description: The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
          format: int64
          type: integer
      required:
      - value
      - currency
      type: object
    BankAccountDetail:
      additionalProperties: false
      properties:
        accountNumber:
          description: 'The bank account number (without separators).

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        accountType:
          description: 'The type of bank account.

            Only applicable to bank accounts held in the USA.

            The permitted values are: `checking`, `savings`.


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        bankAccountName:
          description: The name of the bank account.
          type: string
        bankAccountUUID:
          description: 'The unique identifier (UUID) of the Bank Account.

            >If, during an account holder create or update request, this field is
            left blank (but other fields provided), a new Bank Account will be created
            with a procedurally-generated UUID.


            >If, during an account holder create request, a UUID is provided, the
            creation of the Bank Account will fail while the creation of the account
            holder will continue.


            >If, during an account holder update request, a UUID that is not correlated
            with an existing Bank Account is provided, the update of the account holder
            will fail.


            >If, during an account holder update request, a UUID that is correlated
            with an existing Bank Account is provided, the existing Bank Account will
            be updated.

            '
          type: string
        bankBicSwift:
          description: 'The bank identifier code.

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        bankCity:
          description: 'The city in which the bank branch is located.


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        bankCode:
          description: 'The bank code of the banking institution with which the bank
            account is registered.


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        bankName:
          description: 'The name of the banking institution with which the bank account
            is held.


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        branchCode:
          description: 'The branch code of the branch under which the bank account
            is registered. The value to be specified in this parameter depends on
            the country of the bank account:

            * United States - Routing number

            * United Kingdom - Sort code

            * Germany - Bankleitzahl

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        checkCode:
          description: 'The check code of the bank account.


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        countryCode:
          description: 'The two-letter country code in which the bank account is registered.

            >The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. ''NL'').


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        currencyCode:
          description: 'The currency in which the bank account deals.

            >The permitted currency codes are defined in ISO-4217 (e.g. ''EUR'').

            '
          type: string
        iban:
          description: 'The international bank account number.

            >The IBAN standard is defined in ISO-13616.


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        ownerCity:
          description: 'The city of residence of the bank account owner.

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        ownerCountryCode:
          description: 'The country code of the country of residence of the bank account
            owner.

            >The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. ''NL'').


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        ownerDateOfBirth:
          deprecated: true
          description: 'The date of birth of the bank account owner.

            The date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).'
          type: string
        ownerHouseNumberOrName:
          description: 'The house name or number of the residence of the bank account
            owner.

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        ownerName:
          description: 'The name of the bank account owner.

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        ownerNationality:
          description: 'The country code of the country of nationality of the bank
            account owner.

            >The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. ''NL'').


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        ownerPostalCode:
          description: 'The postal code of the residence of the bank account owner.

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        ownerState:
          description: 'The state of residence of the bank account owner.

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        ownerStreet:
          description: 'The street name of the residence of the bank account owner.

            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        primaryAccount:
          description: If set to true, the bank account is a primary account.
          type: boolean
        taxId:
          description: 'The tax ID number.


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
        urlForVerification:
          description: 'The URL to be used for bank account verification.

            This may be generated on bank account creation.


            >Refer to [Required information](https://docs.adyen.com/classic-platforms/verification-process/required-information)
            for details on field requirements.'
          type: string
      type: object
    BankAccountDetailWrapper:
      properties:
        BankAccountDetail:
          $ref: '#/components/schemas/BankAccountDetail'
    BusinessDetails:
      additionalProperties: false
      properties:
        doingBusinessAs:
          description: The registered name of the company (if it differs from the
            legal name of the company).
          type: string
        legalBusinessName:
          description: The legal name of the company.
          type: string
        listedUltimateParentCompany:
          description: Information about the parent public company. Required if the
            account holder is 100% owned by a publicly listed company.
          items:
            $ref: '#/components/schemas/UltimateParentCompanyWrapper'
          type: array
        shareholders:
          description: Array containing information about individuals associated with
            the account holder either through ownership or control. For details about
            how you can identify them, refer to [our verification guide](https://docs.adyen.com/classic-platforms/verification-process#identify-ubos).
          items:
            $ref: '#/components/schemas/ShareholderContactWrapper'
          type: array
        signatories:
          description: 'Signatories associated with the company.

            Each array entry should represent one signatory.'
          items:
            $ref: '#/components/schemas/SignatoryContactWrapper'
          type: array
        taxId:
          description: The tax ID of the company.
          type: string
      type: object
    CloseAccountHolderRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the Account Holder to be closed.
          type: string
      required:
      - accountHolderCode
      type: object
    CloseAccountHolderResponse:
      additionalProperties: false
      properties:
        accountHolderStatus:
          description: The new status of the Account Holder.
          $ref: '#/components/schemas/AccountHolderStatus'
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    CloseAccountRequest:
      additionalProperties: false
      properties:
        accountCode:
          description: The code of account to be closed.
          type: string
      required:
      - accountCode
      type: object
    CloseAccountResponse:
      additionalProperties: false
      properties:
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        status:
          x-addedInVersion: '2'
          description: 'The new status of the account.

            >Permitted values: `Active`, `Inactive`, `Suspended`, `Closed`.'
          enum:
          - Active
          - Closed
          - Inactive
          - Suspended
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    CreateAccountHolderRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: 'Your unique identifier for the prospective account holder.

            The length must be between three (3) and fifty (50) characters long. Only
            letters, digits, and hyphens (-) are allowed.'
          type: string
        accountHolderDetails:
          description: The details of the prospective account holder.
          $ref: '#/components/schemas/AccountHolderDetails'
        createDefaultAccount:
          description: 'If set to **true**, an account with the default options is
            automatically created for the account holder.

            By default, this field is set to **true**.'
          type: boolean
        legalEntity:
          description: 'The legal entity type of the account holder. This determines
            the information that should be provided in the request.


            Possible values: **Business**, **Individual**, or **NonProfit**.


            * If set to **Business** or **NonProfit**, then `accountHolderDetails.businessDetails`
            must be provided, with at least one entry in the `accountHolderDetails.businessDetails.shareholders`
            list.


            * If set to **Individual**, then `accountHolderDetails.individualDetails`
            must be provided.'
          enum:
          - Business
          - Individual
          - NonProfit
          type: string
        processingTier:
          x-addedInVersion: '3'
          description: The starting [processing tier](https://docs.adyen.com/classic-platforms/onboarding-and-verification/precheck-kyc-information)
            for the prospective account holder.
          format: int32
          type: integer
      required:
      - accountHolderCode
      - legalEntity
      - accountHolderDetails
      type: object
    CreateAccountHolderResponse:
      additionalProperties: false
      properties:
        accountCode:
          description: The code of a new account created for the account holder.
          type: string
        accountHolderCode:
          description: The code of the new account holder.
          type: string
        accountHolderDetails:
          description: Details of the new account holder.
          $ref: '#/components/schemas/AccountHolderDetails'
        accountHolderStatus:
          x-addedInVersion: '2'
          description: The status of the new account holder.
          $ref: '#/components/schemas/AccountHolderStatus'
        invalidFields:
          x-addedInVersion: '5'
          description: A list of fields that caused the `/createAccountHolder` request
            to fail.
          items:
            $ref: '#/components/schemas/ErrorFieldTypeWrapper'
          type: array
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
        verification:
          x-addedInVersion: '2'
          description: The details of KYC Verification of the account holder.
          $ref: '#/components/schemas/KYCVerificationResult'
      type: object
    CreateAccountRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of Account Holder under which to create the account.
          type: string
        payoutSchedule:
          description: 'The payout schedule for the account.


            Possible values: `DEFAULT`, `DAILY`, `DAILY_US`, `DAILY_EU`, `DAILY_AU`,
            `DAILY_SG`, `WEEKLY`, `WEEKLY_ON_TUE_FRI_MIDNIGHT`, `BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT`,
            `MONTHLY`, `HOLD`.

            > `HOLD` prevents scheduled payouts, but you can still initiate payouts
            manually.'
          enum:
          - BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT
          - DAILY
          - DAILY_AU
          - DAILY_EU
          - DAILY_SG
          - DAILY_US
          - HOLD
          - MONTHLY
          - WEEKLY
          - WEEKLY_MON_TO_FRI_AU
          - WEEKLY_MON_TO_FRI_EU
          - WEEKLY_MON_TO_FRI_US
          - WEEKLY_ON_TUE_FRI_MIDNIGHT
          - WEEKLY_SUN_TO_THU_AU
          - WEEKLY_SUN_TO_THU_US
          type: string
        payoutScheduleReason:
          description: 'The reason for the payout schedule choice.

            > This field is required when the `payoutSchedule` parameter is set to
            `HOLD`.'
          type: string
      required:
      - accountHolderCode
      type: object
    CreateAccountResponse:
      additionalProperties: false
      properties:
        accountCode:
          description: The code of the new account.
          type: string
        accountHolderCode:
          description: The code of the account holder.
          type: string
        payoutSchedule:
          description: The details of the payout schedule added to the account.
          $ref: '#/components/schemas/PayoutScheduleResponse'
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        status:
          x-addedInVersion: '2'
          description: 'The status of the account.

            >Permitted values: `Active`.'
          enum:
          - Active
          - Closed
          - Inactive
          - Suspended
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    DeleteBankAccountRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the Account Holder from which to delete the Bank
            Account(s).
          type: string
        bankAccountUUIDs:
          description: The code(s) of the Bank Accounts to be deleted.
          items:
            type: string
          type: array
      required:
      - accountHolderCode
      - bankAccountUUIDs
      type: object
    DeleteLegalArrangementRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the account holder.
          type: string
        legalArrangements:
          description: List of legal arrangements.
          items:
            $ref: '#/components/schemas/LegalArrangementRequestWrapper'
          type: array
      required:
      - accountHolderCode
      - legalArrangements
      type: object
    DeleteShareholderRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the Account Holder from which to delete the Shareholders.
          type: string
        shareholderCodes:
          description: The code(s) of the Shareholders to be deleted.
          items:
            type: string
          type: array
      required:
      - accountHolderCode
      - shareholderCodes
      type: object
    DeleteSignatoriesRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the account holder from which to delete the signatories.
          type: string
        signatoryCodes:
          description: Array of codes of the signatories to be deleted.
          items:
            type: string
          type: array
      required:
      - accountHolderCode
      - signatoryCodes
      type: object
    DocumentDetail:
      additionalProperties: false
      properties:
        accountHolderCode:
          x-addedInVersion: '2'
          description: The code of account holder, to which the document applies.
          type: string
        bankAccountUUID:
          x-addedInVersion: '2'
          description: 'The Adyen-generated [`bankAccountUUID`](https://docs.adyen.com/api-explorer/#/Account/latest/post/createAccountHolder__resParam_accountHolderDetails-bankAccountDetails-bankAccountUUID)
            to which the document must be linked. Refer to [Bank account check](https://docs.adyen.com/classic-platforms/verification-checks/bank-account-check#uploading-a-bank-statement)
            for details on when a document should be submitted.

            >Required if the `documentType` is **BANK_STATEMENT**, where a document
            is being submitted in order to verify a bank account.

            '
          type: string
        description:
          description: Description of the document.
          type: string
        documentType:
          description: 'The type of the document. Refer to [Verification checks](https://docs.adyen.com/classic-platforms/verification-checks)
            for details on when each document type should be submitted and for the
            accepted file formats.


            Permitted values:

            * **BANK_STATEMENT**: A file containing a bank statement or other document
            proving ownership of a specific bank account.

            * **COMPANY_REGISTRATION_SCREENING** (Supported from v5 and later): A
            file containing a company registration document.

            * **CONSTITUTIONAL_DOCUMENT**: A file containing information about the
            account holder''s legal arrangement.

            * **PASSPORT**: A file containing the identity page(s) of a passport.

            * **ID_CARD_FRONT**: A file containing only the front of the ID card.
            In order for a document to be usable, both the **ID_CARD_FRONT** and **ID_CARD_BACK**
            must be submitted.

            * **ID_CARD_BACK**: A file containing only the back of the ID card. In
            order for a document to be usable, both the **ID_CARD_FRONT** and **ID_CARD_BACK**
            must be submitted.

            * **DRIVING_LICENCE_FRONT**: A file containing only the front of the driving
            licence. In order for a document to be usable, both the **DRIVING_LICENCE_FRONT**
            and **DRIVING_LICENCE_BACK** must be submitted.

            * **DRIVING_LICENCE_BACK**: A file containing only the back of the driving
            licence. In order for a document to be usable, both the **DRIVING_LICENCE_FRONT**
            and **DRIVING_LICENCE_FRONT** must be submitted.

            '
          enum:
          - BANK_STATEMENT
          - BSN
          - DRIVING_LICENCE
          - DRIVING_LICENCE_BACK
          - DRIVING_LICENCE_FRONT
          - ID_CARD
          - ID_CARD_BACK
          - ID_CARD_FRONT
          - PASSPORT
          - PROOF_OF_RESIDENCY
          - SSN
          type: string
        filename:
          description: Filename of the document.
          type: string
        shareholderCode:
          x-addedInVersion: '2'
          description: 'The Adyen-generated [`shareholderCode`](https://docs.adyen.com/api-explorer/#/Account/latest/post/createAccountHolder__resParam_accountHolderDetails-businessDetails-shareholders-shareholderCode)
            to which the document must be linked. Refer to [Verification checks](https://docs.adyen.com/classic-platforms/verification-checks)
            for details on when a document should be submitted.

            >Required if the account holder has a `legalEntity` of type **Business**
            and the `documentType` is either **PASSPORT**, **ID_CARD_FRONT**, **ID_CARD_BACK**,
            **DRIVING_LICENCE_FRONT**, or **DRIVING_LICENCE_BACK**. '
          type: string
        signatoryCode:
          description: The Adyen-generated [`signatoryCode`](https://docs.adyen.com/api-explorer/#/Account/v6/post/createAccountHolder__resParam_accountHolderDetails-businessDetails-signatories-signatoryCode)
            to which the document must be linked.
          type: string
      required:
      - documentType
      type: object
    DocumentDetailWrapper:
      properties:
        DocumentDetail:
          $ref: '#/components/schemas/DocumentDetail'
    ErrorFieldType:
      additionalProperties: false
      properties:
        errorCode:
          description: The validation error code.
          format: int32
          type: integer
        errorDescription:
          description: A description of the validation error.
          type: string
        fieldType:
          description: The type of error field.
          $ref: '#/components/schemas/FieldType'
      type: object
    ErrorFieldTypeWrapper:
      properties:
        ErrorFieldType:
          $ref: '#/components/schemas/ErrorFieldType'
    FieldType:
      additionalProperties: false
      properties:
        field:
          description: The full name of the property.
          type: string
        fieldName:
          description: The type of the field.
          enum:
          - accountCode
          - accountHolderCode
          - accountHolderDetails
          - accountNumber
          - accountStateType
          - accountStatus
          - accountType
          - address
          - balanceAccount
          - balanceAccountActive
          - balanceAccountCode
          - balanceAccountId
          - bankAccount
          - bankAccountCode
          - bankAccountName
          - bankAccountUUID
          - bankBicSwift
          - bankCity
          - bankCode
          - bankName
          - bankStatement
          - branchCode
          - businessContact
          - cardToken
          - checkCode
          - city
          - companyRegistration
          - constitutionalDocument
          - controller
          - country
          - countryCode
          - currency
          - currencyCode
          - dateOfBirth
          - destinationAccountCode
          - document
          - documentContent
          - documentExpirationDate
          - documentIssuerCountry
          - documentIssuerState
          - documentName
          - documentNumber
          - documentType
          - doingBusinessAs
          - drivingLicence
          - drivingLicenceBack
          - drivingLicenceFront
          - drivingLicense
          - email
          - firstName
          - formType
          - fullPhoneNumber
          - gender
          - hopWebserviceUser
          - houseNumberOrName
          - iban
          - idCard
          - idNumber
          - identityDocument
          - individualDetails
          - infix
          - jobTitle
          - lastName
          - lastReviewDate
          - legalArrangement
          - legalArrangementCode
          - legalArrangementEntity
          - legalArrangementEntityCode
          - legalArrangementLegalForm
          - legalArrangementMember
          - legalArrangementMembers
          - legalArrangementName
          - legalArrangementReference
          - legalArrangementRegistrationNumber
          - legalArrangementTaxNumber
          - legalArrangementType
          - legalBusinessName
          - legalEntity
          - legalEntityType
          - linkedViasVirtualAccount
          - logo
          - merchantAccount
          - merchantCategoryCode
          - merchantHouseNumber
          - merchantReference
          - microDeposit
          - name
          - nationality
          - originalReference
          - ownerCity
          - ownerCountryCode
          - ownerDateOfBirth
          - ownerHouseNumberOrName
          - ownerName
          - ownerPostalCode
          - ownerState
          - ownerStreet
          - passport
          - passportNumber
          - payoutMethod
          - payoutMethodCode
          - payoutSchedule
          - pciSelfAssessment
          - personalData
          - phoneCountryCode
          - phoneNumber
          - postalCode
          - primaryCurrency
          - reason
          - returnUrl
          - schedule
          - shareholder
          - shareholderCode
          - shareholderCodeAndSignatoryCode
          - shareholderCodeOrSignatoryCode
          - shareholderType
          - shareholderTypes
          - shopperInteraction
          - signatory
          - signatoryCode
          - socialSecurityNumber
          - sourceAccountCode
          - splitAccount
          - splitConfigurationUUID
          - splitCurrency
          - splitValue
          - splits
          - stateOrProvince
          - status
          - stockExchange
          - stockNumber
          - stockTicker
          - store
          - storeDetail
          - storeName
          - storeReference
          - street
          - taxId
          - tier
          - tierNumber
          - transferCode
          - ultimateParentCompany
          - ultimateParentCompanyAddressDetails
          - ultimateParentCompanyAddressDetailsCountry
          - ultimateParentCompanyBusinessDetails
          - ultimateParentCompanyBusinessDetailsLegalBusinessName
          - ultimateParentCompanyBusinessDetailsRegistrationNumber
          - ultimateParentCompanyCode
          - ultimateParentCompanyStockExchange
          - ultimateParentCompanyStockNumber
          - ultimateParentCompanyStockNumberOrStockTicker
          - ultimateParentCompanyStockTicker
          - unknown
          - value
          - verificationType
          - virtualAccount
          - visaNumber
          - webAddress
          - year
          type: string
        shareholderCode:
          description: The code of the shareholder that the field belongs to. If empty,
            the field belongs to an account holder.
          type: string
      type: object
    FieldTypeWrapper:
      properties:
        FieldType:
          $ref: '#/components/schemas/FieldType'
    GenericResponse:
      additionalProperties: false
      properties:
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    GetAccountHolderRequest:
      additionalProperties: false
      properties:
        accountCode:
          description: 'The code of the account of which to retrieve the details.

            > Required if no `accountHolderCode` is provided.'
          type: string
        accountHolderCode:
          description: 'The code of the account holder of which to retrieve the details.

            > Required if no `accountCode` is provided.'
          type: string
      type: object
    GetAccountHolderResponse:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the account holder.
          type: string
        accountHolderDetails:
          description: Details of the account holder.
          $ref: '#/components/schemas/AccountHolderDetails'
        accountHolderStatus:
          x-addedInVersion: '2'
          description: The status of the account holder.
          $ref: '#/components/schemas/AccountHolderStatus'
        accounts:
          description: A list of the accounts under the account holder.
          items:
            $ref: '#/components/schemas/AccountWrapper'
          type: array
        legalEntity:
          description: The legal entity of the account holder.
          enum:
          - Business
          - Individual
          - NonProfit
          type: string
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
        verification:
          x-addedInVersion: '2'
          description: The details of KYC Verification of the account holder.
          $ref: '#/components/schemas/KYCVerificationResult'
      type: object
    GetAccountHolderStatusResponse:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the Account Holder.
          type: string
        accountHolderStatus:
          x-addedInVersion: '2'
          description: The status of the Account Holder.
          $ref: '#/components/schemas/AccountHolderStatus'
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    GetTaxFormRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The account holder code you provided when you created the account
            holder.
          type: string
        formType:
          description: Type of the requested tax form. For example, 1099-K.
          type: string
        year:
          description: Applicable tax year in the YYYY format.
          format: int32
          type: integer
      required:
      - accountHolderCode
      - formType
      - year
      type: object
    GetTaxFormResponse:
      additionalProperties: false
      properties:
        content:
          description: The content of the tax form in the Base64 binary format.
          format: byte
          type: string
        contentType:
          description: The content type of the tax form.
          type: string
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    GetUploadedDocumentsRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the Account Holder for which to retrieve the documents.
          type: string
        bankAccountUUID:
          x-addedInVersion: '2'
          description: The code of the Bank Account for which to retrieve the documents.
          type: string
        shareholderCode:
          description: The code of the Shareholder for which to retrieve the documents.
          type: string
      required:
      - accountHolderCode
      type: object
    GetUploadedDocumentsResponse:
      additionalProperties: false
      properties:
        documentDetails:
          description: A list of the documents and their details.
          items:
            $ref: '#/components/schemas/DocumentDetailWrapper'
          type: array
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    IndividualDetails:
      additionalProperties: false
      properties:
        name:
          description: "The name of the individual.\n>Make sure your account holder\
            \ registers using the name shown on their Photo ID. \n Maximum length:\
            \ 80 characters \n Cannot contain numbers. /n Cannot be empty."
          $ref: '#/components/schemas/ViasName'
        personalData:
          description: Personal information of the individual.
          $ref: '#/components/schemas/ViasPersonalData'
      type: object
    KYCBankAccountCheckResult:
      additionalProperties: false
      properties:
        bankAccountUUID:
          description: The unique ID of the bank account to which the check applies.
          type: string
        checks:
          description: A list of the checks and their statuses.
          items:
            $ref: '#/components/schemas/KYCCheckStatusData'
          type: array
      type: object
    KYCCheckResult:
      additionalProperties: false
      properties:
        checks:
          description: A list of the checks and their statuses.
          items:
            $ref: '#/components/schemas/KYCCheckStatusData'
          type: array
      type: object
    KYCCheckStatusData:
      additionalProperties: false
      properties:
        requiredFields:
          description: A list of the fields required for execution of the check.
          items:
            type: string
          type: array
        status:
          description: 'The status of the check.


            Possible values: **AWAITING_DATA** , **DATA_PROVIDED**, **FAILED**, **INVALID_DATA**,
            **PASSED**, **PENDING**, **RETRY_LIMIT_REACHED**.'
          enum:
          - AWAITING_DATA
          - DATA_PROVIDED
          - FAILED
          - INVALID_DATA
          - PASSED
          - PENDING
          - PENDING_REVIEW
          - RETRY_LIMIT_REACHED
          - UNCHECKED
          type: string
        summary:
          description: A summary of the execution of the check.
          $ref: '#/components/schemas/KYCCheckSummary'
        type:
          description: "The type of check.\n\nPossible values:\n\n * **BANK_ACCOUNT_VERIFICATION**:\
            \ Used in v5 and earlier. Replaced by **PAYOUT_METHOD_VERIFICATION** in\
            \ v6 and later.\n\n * **COMPANY_VERIFICATION**\n\n  * **CARD_VERIFICATION**\n\
            \n* **IDENTITY_VERIFICATION**\n\n* **LEGAL_ARRANGEMENT_VERIFICATION**\n\
            \n* **NONPROFIT_VERIFICATION**\n\n * **PASSPORT_VERIFICATION**\n\n* **PAYOUT_METHOD_VERIFICATION**:\
            \ Used in v6 and later.\n\n* **PCI_VERIFICATION**"
          enum:
          - BANK_ACCOUNT_VERIFICATION
          - CARD_VERIFICATION
          - COMPANY_VERIFICATION
          - IDENTITY_VERIFICATION
          - LEGAL_ARRANGEMENT_VERIFICATION
          - NONPROFIT_VERIFICATION
          - PASSPORT_VERIFICATION
          - PAYOUT_METHOD_VERIFICATION
          - PCI_VERIFICATION
          type: string
      required:
      - type
      - status
      type: object
    KYCCheckSummary:
      additionalProperties: false
      properties:
        code:
          description: The code of the check.
          format: int32
          type: integer
        description:
          description: A description of the check.
          type: string
      required:
      - code
      type: object
    KYCShareholderCheckResult:
      additionalProperties: false
      properties:
        checks:
          description: A list of the checks and their statuses.
          items:
            $ref: '#/components/schemas/KYCCheckStatusData'
          type: array
        shareholderCode:
          description: The code of the shareholder to which the check applies.
          type: string
      type: object
    KYCSignatoryCheckResult:
      additionalProperties: false
      properties:
        checks:
          description: A list of the checks and their statuses.
          items:
            $ref: '#/components/schemas/KYCCheckStatusData'
          type: array
        signatoryCode:
          description: The code of the signatory to which the check applies.
          type: string
      type: object
    KYCVerificationResult:
      additionalProperties: false
      properties:
        accountHolder:
          description: The results of the checks on the account holder.
          $ref: '#/components/schemas/KYCCheckResult'
        bankAccounts:
          description: The results of the checks on the bank accounts.
          items:
            $ref: '#/components/schemas/KYCBankAccountCheckResult'
          type: array
        shareholders:
          description: The results of the checks on the shareholders.
          items:
            $ref: '#/components/schemas/KYCShareholderCheckResult'
          type: array
        signatories:
          description: The results of the checks on the signatories.
          items:
            $ref: '#/components/schemas/KYCSignatoryCheckResult'
          type: array
      type: object
    LegalArrangementRequest:
      additionalProperties: false
      properties:
        legalArrangementCode:
          description: The code of the legal arrangement to be deleted. If you also
            send `legalArrangementEntityCodes`, only the entities listed will be deleted.
          type: string
        legalArrangementEntityCodes:
          description: List of legal arrangement entities to be deleted.
          items:
            type: string
          type: array
      required:
      - legalArrangementCode
      type: object
    LegalArrangementRequestWrapper:
      properties:
        LegalArrangementRequest:
          $ref: '#/components/schemas/LegalArrangementRequest'
    PayoutScheduleResponse:
      additionalProperties: false
      properties:
        nextScheduledPayout:
          description: The date of the next scheduled payout.
          format: date-time
          type: string
        schedule:
          description: 'The payout schedule for the account.


            Possible values: `DEFAULT`, `DAILY`, `DAILY_US`, `DAILY_EU`, `DAILY_AU`,
            `DAILY_SG`, `WEEKLY`, `WEEKLY_ON_TUE_FRI_MIDNIGHT`, `BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT`,
            `MONTHLY`, `HOLD`.

            > `HOLD` prevents scheduled payouts, but you can still initiate payouts
            manually.'
          enum:
          - BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT
          - DAILY
          - DAILY_AU
          - DAILY_EU
          - DAILY_SG
          - DAILY_US
          - HOLD
          - MONTHLY
          - WEEKLY
          - WEEKLY_MON_TO_FRI_AU
          - WEEKLY_MON_TO_FRI_EU
          - WEEKLY_MON_TO_FRI_US
          - WEEKLY_ON_TUE_FRI_MIDNIGHT
          - WEEKLY_SUN_TO_THU_AU
          - WEEKLY_SUN_TO_THU_US
          type: string
      type: object
    PersonalDocumentData:
      additionalProperties: false
      properties:
        expirationDate:
          description: "The expiry date of the document, \n in ISO-8601 YYYY-MM-DD\
            \ format. For example, **2000-01-31**."
          type: string
        issuerCountry:
          description: "The country where the document was issued, in the two-character\
            \ \n[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)\
            \ format. For example, **NL**."
          maxLength: 2
          minLength: 2
          type: string
        issuerState:
          description: The state where the document was issued (if applicable).
          type: string
        number:
          description: The number in the document.
          type: string
        type:
          description: 'The type of the document. Possible values: **ID**, **DRIVINGLICENSE**,
            **PASSPORT**, **SOCIALSECURITY**, **VISA**.


            To delete an existing entry for a document `type`, send only the `type`
            field in your request. '
          enum:
          - DRIVINGLICENSE
          - ID
          - PASSPORT
          - SOCIALSECURITY
          - VISA
          type: string
      required:
      - type
      type: object
    PersonalDocumentDataWrapper:
      properties:
        PersonalDocumentData:
          $ref: '#/components/schemas/PersonalDocumentData'
    ServiceError:
      additionalProperties: false
      properties:
        errorCode:
          description: The error code mapped to the error message.
          type: string
        errorType:
          description: The category of the error.
          type: string
        message:
          description: A short explanation of the issue.
          type: string
        pspReference:
          description: The PSP reference of the payment.
          type: string
        status:
          description: The HTTP response status.
          format: int32
          type: integer
      type: object
    ShareholderContact:
      additionalProperties: false
      properties:
        address:
          description: The address of the person.
          $ref: '#/components/schemas/ViasAddress'
        email:
          description: The e-mail address of the person.
          type: string
        fullPhoneNumber:
          description: 'The phone number of the person provided as a single string.  It
            will be handled as a landline phone.

            Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"'
          type: string
        jobTitle:
          description: 'Job title of the person. Required when the `shareholderType`
            is **Controller**.


            Example values: **Chief Executive Officer**, **Chief Financial Officer**,
            **Chief Operating Officer**, **President**, **Vice President**, **Executive
            President**, **Managing Member**, **Partner**, **Treasurer**, **Director**,
            or **Other**.'
          type: string
        name:
          description: The name of the person.
          $ref: '#/components/schemas/ViasName'
        personalData:
          description: Contains information about the person.
          $ref: '#/components/schemas/ViasPersonalData'
        phoneNumber:
          description: The phone number of the person.
          $ref: '#/components/schemas/ViasPhoneNumber'
        shareholderCode:
          description: 'The unique identifier (UUID) of the shareholder entry.

            >**If, during an Account Holder create or update request, this field is
            left blank (but other fields provided), a new Shareholder will be created
            with a procedurally-generated UUID.**


            >**If, during an Account Holder create request, a UUID is provided, the
            creation of Account Holder will fail with a validation Error..**


            >**If, during an Account Holder update request, a UUID that is not correlated
            with an existing Shareholder is provided, the update of the Shareholder
            will fail.**


            >**If, during an Account Holder update request, a UUID that is correlated
            with an existing Shareholder is provided, the existing Shareholder will
            be updated.**

            '
          type: string
        shareholderType:
          description: "Specifies how the person is associated with the account holder.\
            \ \n\nPossible values: \n\n* **Owner**: Individuals who directly or indirectly\
            \ own 25% or more of a company.\n\n* **Controller**: Individuals who are\
            \ members of senior management staff responsible for managing a company\
            \ or organization."
          enum:
          - Controller
          - Owner
          - Signatory
          type: string
        webAddress:
          description: The URL of the person's website.
          type: string
      type: object
    ShareholderContactWrapper:
      properties:
        ShareholderContact:
          $ref: '#/components/schemas/ShareholderContact'
    SignatoryContact:
      additionalProperties: false
      properties:
        address:
          description: The address of the person.
          $ref: '#/components/schemas/ViasAddress'
        email:
          description: The e-mail address of the person.
          type: string
        fullPhoneNumber:
          description: 'The phone number of the person provided as a single string.  It
            will be handled as a landline phone.

            Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"'
          type: string
        jobTitle:
          description: 'Job title of the signatory.


            Example values: **Chief Executive Officer**, **Chief Financial Officer**,
            **Chief Operating Officer**, **President**, **Vice President**, **Executive
            President**, **Managing Member**, **Partner**, **Treasurer**, **Director**,
            or **Other**.'
          type: string
        name:
          description: The name of the person.
          $ref: '#/components/schemas/ViasName'
        personalData:
          description: Contains information about the person.
          $ref: '#/components/schemas/ViasPersonalData'
        phoneNumber:
          description: The phone number of the person.
          $ref: '#/components/schemas/ViasPhoneNumber'
        signatoryCode:
          description: 'The unique identifier (UUID) of the signatory.

            >**If, during an Account Holder create or update request, this field is
            left blank (but other fields provided), a new Signatory will be created
            with a procedurally-generated UUID.**


            >**If, during an Account Holder create request, a UUID is provided, the
            creation of the Signatory will fail while the creation of the Account
            Holder will continue.**


            >**If, during an Account Holder update request, a UUID that is not correlated
            with an existing Signatory is provided, the update of the Signatory will
            fail.**


            >**If, during an Account Holder update request, a UUID that is correlated
            with an existing Signatory is provided, the existing Signatory will be
            updated.**

            '
          type: string
        signatoryReference:
          description: Your reference for the signatory.
          type: string
        webAddress:
          description: The URL of the person's website.
          type: string
      type: object
    SignatoryContactWrapper:
      properties:
        SignatoryContact:
          $ref: '#/components/schemas/SignatoryContact'
    SuspendAccountHolderRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the account holder to be suspended.
          type: string
      required:
      - accountHolderCode
      type: object
    SuspendAccountHolderResponse:
      additionalProperties: false
      properties:
        accountHolderStatus:
          description: The new status of the Account Holder.
          $ref: '#/components/schemas/AccountHolderStatus'
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    UltimateParentCompany:
      additionalProperties: false
      properties:
        address:
          description: Address of the ultimate parent company.
          $ref: '#/components/schemas/ViasAddress'
        businessDetails:
          description: Details about the ultimate parent company's business.
          $ref: '#/components/schemas/UltimateParentCompanyBusinessDetails'
        ultimateParentCompanyCode:
          description: Adyen-generated unique alphanumeric identifier (UUID) for the
            entry, returned in the response when you create an ultimate parent company.
            Required when updating an existing entry in an `/updateAccountHolder`
            request.
          type: string
      type: object
    UltimateParentCompanyBusinessDetails:
      additionalProperties: false
      properties:
        legalBusinessName:
          description: The legal name of the company.
          type: string
        registrationNumber:
          description: The registration number of the company.
          type: string
        stockExchange:
          description: Market Identifier Code (MIC).
          type: string
        stockNumber:
          description: International Securities Identification Number (ISIN).
          type: string
        stockTicker:
          description: Stock Ticker symbol.
          type: string
      type: object
    UltimateParentCompanyWrapper:
      properties:
        UltimateParentCompany:
          $ref: '#/components/schemas/UltimateParentCompany'
    UnSuspendAccountHolderRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the account holder to be reinstated.
          type: string
      required:
      - accountHolderCode
      type: object
    UnSuspendAccountHolderResponse:
      additionalProperties: false
      properties:
        accountHolderStatus:
          description: The new status of the Account Holder.
          $ref: '#/components/schemas/AccountHolderStatus'
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      type: object
    UpdateAccountHolderRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the Account Holder to be updated.
          type: string
        accountHolderDetails:
          description: 'The details to which the Account Holder should be updated.


            Required if a processingTier is not provided.'
          $ref: '#/components/schemas/AccountHolderDetails'
        processingTier:
          x-addedInVersion: '3'
          description: '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.'
          format: int32
          type: integer
      required:
      - accountHolderCode
      type: object
    UpdateAccountHolderResponse:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the account holder.
          type: string
        accountHolderDetails:
          description: Details of the account holder.
          $ref: '#/components/schemas/AccountHolderDetails'
        accountHolderStatus:
          x-addedInVersion: '2'
          description: The new status of the account holder.
          $ref: '#/components/schemas/AccountHolderStatus'
        invalidFields:
          x-addedInVersion: '5'
          description: in case the account holder has not been updated, contains account
            holder fields, that did not pass the validation.
          items:
            $ref: '#/components/schemas/ErrorFieldTypeWrapper'
          type: array
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
        updatedFields:
          description: A list of the fields updated through the request.
          items:
            $ref: '#/components/schemas/FieldTypeWrapper'
          type: array
        verification:
          x-addedInVersion: '2'
          description: The details of KYC Verification of the account holder.
          $ref: '#/components/schemas/KYCVerificationResult'
      type: object
    UpdateAccountHolderStateRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          description: The code of the Account Holder on which to update the state.
          type: string
        disable:
          description: If true, disable the requested state.  If false, enable the
            requested state.
          type: boolean
        reason:
          description: 'The reason that the state is being updated.

            >Required if the state is being disabled.'
          type: string
        stateType:
          description: 'The state to be updated.

            >Permitted values are: `Processing`, `Payout`'
          enum:
          - LimitedPayout
          - LimitedProcessing
          - LimitlessPayout
          - LimitlessProcessing
          - Payout
          - Processing
          type: string
      required:
      - accountHolderCode
      - stateType
      - disable
      type: object
    UpdateAccountRequest:
      additionalProperties: false
      properties:
        accountCode:
          description: The code of the account to update.
          type: string
        payoutSchedule:
          description: The details of the payout schedule to which the account must
            be updated.
          $ref: '#/components/schemas/UpdatePayoutScheduleRequest'
      required:
      - accountCode
      - payoutSchedule
      type: object
    UpdateAccountResponse:
      additionalProperties: false
      properties:
        accountCode:
          description: The code of the account.
          type: string
        payoutSchedule:
          description: The details of the payout schedule to which the account is
            updated.
          $ref: '#/components/schemas/PayoutScheduleResponse'
        pspReference:
          description: The reference of a request. Can be used to uniquely identify
            the request.
          type: string
        resultCode:
          description: The result code.
          type: string
        submittedAsync:
          description: '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.'
          type: boolean
      required:
      - accountCode
      type: object
    UpdatePayoutScheduleRequest:
      additionalProperties: false
      properties:
        action:
          description: 'Direction on how to handle any payouts that have already been
            scheduled.


            Possible values:

            * `CLOSE`: close the existing batch of payouts.

            * `UPDATE`: reschedule the existing batch to the new schedule.

            * `NOTHING` (**default**): allow the payout to proceed.'
          enum:
          - CLOSE
          - NOTHING
          - UPDATE
          type: string
        reason:
          description: 'The reason for the payout schedule update.

            > This field is required when the `schedule` parameter is set to `HOLD`.'
          type: string
        schedule:
          description: 'The new payout schedule for the account.


            Possible values: `DEFAULT`, `DAILY`, `DAILY_US`, `DAILY_EU`, `DAILY_AU`,
            `DAILY_SG`, `WEEKLY`, `WEEKLY_ON_TUE_FRI_MIDNIGHT`, `BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT`,
            `MONTHLY`, `HOLD`.

            > `HOLD` prevents scheduled payouts, but you can still initiate payouts
            manually.'
          enum:
          - BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT
          - DAILY
          - DAILY_AU
          - DAILY_EU
          - DAILY_SG
          - DAILY_US
          - HOLD
          - MONTHLY
          - WEEKLY
          - WEEKLY_MON_TO_FRI_AU
          - WEEKLY_MON_TO_FRI_EU
          - WEEKLY_MON_TO_FRI_US
          - WEEKLY_ON_TUE_FRI_MIDNIGHT
          - WEEKLY_SUN_TO_THU_AU
          - WEEKLY_SUN_TO_THU_US
          type: string
      required:
      - schedule
      type: object
    UploadDocumentRequest:
      additionalProperties: false
      properties:
        accountHolderCode:
          deprecated: true
          description: The code of the account holder, for which the document is submitted.
          type: string
        bankAccountUUID:
          deprecated: true
          description: 'The unique ID of the bank account, for which the document
            is submitted.

            >Required if the document is being submitted in order to verify a bank
            account.'
          type: string
        documentContent:
          description: 'The content of the document, in Base64-encoded string format.


            To learn about document requirements, refer to [Verification checks](https://docs.adyen.com/classic-platforms/verification-checks).'
          format: byte
          type: string
        documentDetail:
          description: Details of the document being submitted.
          $ref: '#/components/schemas/DocumentDetail'
        shareholderCode:
          deprecated: true
          description: 'The code of the shareholder, for which the document is submitted.

            >Required if the document is being submitted in order to verify a shareholder.'
          type: string
      required:
      - documentDetail
      - documentContent
      type: object
    ViasAddress:
      additionalProperties: false
      properties:
        city:
          description: The name of the city. Required if the `houseNumberOrName`,
            `street`, `postalCode`, or `stateOrProvince` are provided.
          type: string
        country:
          description: The two-character country code of the address in ISO-3166-1
            alpha-2 format. For example, **NL**.
          type: string
        houseNumberOrName:
          description: The number or name of the house.
          type: string
        postalCode:
          description: 'The postal code. Required if the `houseNumberOrName`, `street`,
            `city`, or `stateOrProvince` are provided.


            Maximum length:


            * 5 digits for addresses in the US.


            * 10 characters for all other countries.'
          type: string
        stateOrProvince:
          description: "The abbreviation of the state or province. Required if the\
            \ `houseNumberOrName`, `street`, `city`, or `postalCode` are provided.\
            \ \n\nMaximum length:\n\n* 2 characters for addresses in the US or Canada.\n\
            \n* 3 characters for all other countries.\n"
          type: string
        street:
          description: The name of the street. Required if the `houseNumberOrName`,
            `city`, `postalCode`, or `stateOrProvince` are provided.
          type: string
      required:
      - country
      type: object
    ViasName:
      additionalProperties: false
      properties:
        firstName:
          description: The first name.
          maxLength: 80
          type: string
        gender:
          description: 'The gender.

            >The following values are permitted: `MALE`, `FEMALE`, `UNKNOWN`.'
          enum:
          - MALE
          - FEMALE
          - UNKNOWN
          maxLength: 1
          type: string
        infix:
          description: 'The name''s infix, if applicable.

            >A maximum length of twenty (20) characters is imposed.'
          maxLength: 20
          type: string
        lastName:
          description: The last name.
          maxLength: 80
          type: string
      type: object
    ViasPersonalData:
      additionalProperties: false
      properties:
        dateOfBirth:
          description: The person's date of birth, in ISO-8601 YYYY-MM-DD format.
            For example, **2000-01-31**.
          type: string
        documentData:
          x-addedInVersion: '3'
          description: Array that contains information about the person's identification
            document. You can submit only one entry per document type.
          items:
            $ref: '#/components/schemas/PersonalDocumentDataWrapper'
          type: array
        idNumber:
          deprecated: true
          x-deprecatedInVersion: '3'
          x-deprecatedMessage: Use `individualDetails.personalData.documentData.number`
            instead.
          description: An ID number of the person.
          type: string
        nationality:
          description: 'The nationality of the person represented by a two-character
            country code,  in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
            format. For example, **NL**.

            '
          maxLength: 2
          minLength: 2
          type: string
      type: object
    ViasPhoneNumber:
      additionalProperties: false
      properties:
        phoneCountryCode:
          description: 'The two-character country code of the phone number.

            >The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. ''NL'').'
          type: string
        phoneNumber:
          description: 'The phone number.

            >The inclusion of the phone number country code is not necessary.'
          type: string
        phoneType:
          description: 'The type of the phone number.

            >The following values are permitted: `Landline`, `Mobile`, `SIP`, `Fax`.'
          enum:
          - Fax
          - Landline
          - Mobile
          - SIP
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: X-API-Key
      type: apiKey
    BasicAuth:
      scheme: basic
      type: http
  examples:
    generic-400:
      summary: Response code 400. Bad Request.
      value:
        status: 400
        errorCode: '702'
        message: 'Unexpected input: I'
        errorType: validation
    generic-403:
      summary: Response code 403. Forbidden.
      value:
        status: 403
        errorCode: '10_003'
        message: Failed to authorize user
        errorType: security
    post-closeAccount-closeAccount:
      summary: Close an account
      value:
        accountCode: CODE_OF_ACCOUNT
    post-closeAccountHolder-basic:
      summary: Close an account holder
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
    post-createAccount-basic:
      summary: Add an account to an account holder
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
    post-createAccountHolder-business:
      summary: Create a business account holder
      value:
        accountHolderCode: GENERATE_CODE
        accountHolderDetails:
          businessDetails:
            doingBusinessAs: Real Good Restaurant
            legalBusinessName: Real Good Restaurant Inc.
            shareholders:
            - ShareholderContact:
                name:
                  firstName: John
                  lastName: Carpenter
          email: test@adyen.com
          webAddress: https://www.your-website.com
        legalEntity: Business
    post-createAccountHolder-business-200:
      summary: Response code 200. Success.
      value:
        invalidFields: []
        pspReference: '8816080397613514'
        accountCode: '8816080397613522'
        accountHolderCode: GENERATE_CODE
        accountHolderDetails:
          address:
            country: US
          bankAccountDetails: []
          email: tim@green.com
          individualDetails:
            name:
              firstName: Tim
              lastName: Green
          merchantCategoryCode: '7999'
          payoutMethods: []
          webAddress: null
        accountHolderStatus:
          status: Active
          processingState:
            disabled: false
            processedFrom:
              currency: USD
              value: 0
            processedTo:
              currency: USD
              value: 9999
            tierNumber: 0
          payoutState:
            allowPayout: false
            disabled: false
          events: []
        legalEntity: Individual
        verification:
          accountHolder:
            checks:
            - type: IDENTITY_VERIFICATION
              status: AWAITING_DATA
              requiredFields:
              - AccountHolderDetails.IndividualDetails.PersonalData.personalData
              - AccountHolderDetails.Address.city
              - AccountHolderDetails.Address.houseNumberOrName
              - AccountHolderDetails.Address.postalCode
              - AccountHolderDetails.Address.street
              - AccountHolderDetails.IndividualDetails.PersonalData.idNumber
              - AccountHolderDetails.PhoneNumber.phoneNumber
            - type: PAYOUT_METHOD_VERIFICATION
              status: AWAITING_DATA
              requiredFields:
              - AccountHolderDetails.BankAccountDetails.bankAccount
    post-createAccountHolder-business-422:
      summary: Response code 422. Unprocessable Entity.
      value:
        invalidFields:
        - errorCode: 23
          errorDescription: Account holder code does not exists or invalid
          fieldType:
            field: accountHolderCode
            fieldName: accountHolderCode
        pspReference: '8816080407386622'
    post-createAccountHolder-generic-401:
      summary: Response code 401. Unauthorized.
      value:
        status: 401
        errorCode: '000'
        message: HTTP Status Response - Unauthorized
        errorType: security
    post-createAccountHolder-generic-500:
      summary: Response code 500. Internal Server Error.
      value:
        status: 500
        errorCode: '701'
        message: Internal Error in createAccountHolder 991608040809302G
        errorType: internal
    post-createAccountHolder-individual:
      summary: Create an individual account holder
      value:
        accountHolderCode: GENERATE_CODE
        accountHolderDetails:
          email: tim@green.com
          individualDetails:
            name:
              firstName: Tim
              lastName: Green
          webAddress: https://www.your-website.com
        legalEntity: Individual
    post-createAccountHolder-individual-200:
      summary: Response code 200. Success.
      value:
        invalidFields: []
        pspReference: '8516080413108716'
        accountCode: '8516080413108724'
        accountHolderCode: GENERATE_CODE
        accountHolderDetails:
          address:
            country: US
          bankAccountDetails: []
          email: tim@green.com
          individualDetails:
            name:
              firstName: Tim
              lastName: Green
          merchantCategoryCode: '7999'
          payoutMethods: []
          webAddress: null
        accountHolderStatus:
          status: Active
          processingState:
            disabled: false
            processedFrom:
              currency: USD
              value: 0
            processedTo:
              currency: USD
              value: 9999
            tierNumber: 0
          payoutState:
            allowPayout: false
            disabled: false
          events: []
        legalEntity: Individual
        verification:
          accountHolder:
            checks:
            - type: IDENTITY_VERIFICATION
              status: AWAITING_DATA
              requiredFields:
              - AccountHolderDetails.Address.city
              - AccountHolderDetails.Address.houseNumberOrName
              - AccountHolderDetails.Address.postalCode
              - AccountHolderDetails.Address.street
              - AccountHolderDetails.IndividualDetails.PersonalData.idNumber
              - AccountHolderDetails.PhoneNumber.phoneNumber
              - AccountHolderDetails.IndividualDetails.PersonalData.personalData
            - type: PAYOUT_METHOD_VERIFICATION
              status: AWAITING_DATA
              requiredFields:
              - AccountHolderDetails.BankAccountDetails.bankAccount
    post-createAccountHolder-individual-422:
      summary: Response code 422. Unprocessable Entity.
      value:
        invalidFields:
        - errorCode: 21
          errorDescription: Account description ' SpecialCharactersIncluded' is not
            valid
          fieldType:
            field: description
            fieldName: description
        pspReference: '8816080421120908'
    post-deleteBankAccounts-basic:
      summary: Delete bank accounts
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        bankAccountUUIDs:
        - eeb6ed22-3bae-483c-83b9-bc2097a75d40
    post-deleteLegalArrangements-arrangements:
      summary: Delete legal arrangements
      description: Example request for deleting legal arrangements
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        legalArrangements:
        - legalArrangementCode: cdf92f5a-a114-4ce6-8f19-c3f6ec83141c
    post-deleteLegalArrangements-arrangements-200:
      summary: Legal arrangement deleted
      value:
        invalidFields: []
        pspReference: '8816080397613514'
    post-deleteLegalArrangements-arrangements-400:
      summary: Response code 400. Bad Request.
      value:
        invalidFields:
        - errorCode: 34
          errorDescription: An invalid legalArrangementCode code is provided for value
            'cdf92f5a-a114-4ce6-8f19-c3f6ec83141c'
          fieldType:
            field: AccountHolderDetails.LegalArrangements.legalArrangementCode
            fieldName: legalArrangementCode
        pspReference: '9916613322577326'
    post-deleteLegalArrangements-entities:
      summary: Delete legal arrangement entities
      description: Example request for deleting legal arrangement entities
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        legalArrangements:
        - legalArrangementCode: cdf92f5a-a114-4ce6-8f19-c3f6ec83141c
          legalArrangementEntityCodes:
          - 755881d3-d6b0-4b34-8ace-1caceb8add63
    post-deleteLegalArrangements-entities-200:
      summary: Legal arrangement entities deleted
      value:
        invalidFields: []
        pspReference: '8816080397613514'
    post-deleteLegalArrangements-entities-400:
      summary: Response code 400. Bad Request.
      value:
        invalidFields:
        - errorCode: 34
          errorDescription: An invalid legalArrangementEntityCode code is provided
            for value 'c92bb932-4867-4cef-bf9d-4ecde37745cf'
          fieldType:
            field: AccountHolderDetails.LegalArrangements.LegalArrangementsEntities.legalArrangementEntityCode
            fieldName: legalArrangementEntityCode
        pspReference: '9916613324987358'
    post-deleteShareholders-basic:
      summary: Delete shareholders
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        shareholderCodes:
        - 9188218c-576e-4cbe-8e86-72722f453920
    post-getAccountHolder-accountCode:
      summary: Get an account holder
      value:
        accountCode: CODE_OF_ACCOUNT
    post-getAccountHolder-accountHolderCode:
      summary: Get an account holder for the account
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
    post-getTaxForm-basic:
      summary: Get a tax form
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        formType: 1099-K
        year: 2020
    post-getUploadedDocuments-basic:
      summary: Get uploaded documents
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        bankAccountUUID: EXAMPLE_UUID
    post-suspendAccountHolder-basic:
      summary: Suspend an account holder
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
    post-unSuspendAccountHolder-basic:
      summary: Unsuspend an account holder
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
    post-updateAccount-basic:
      summary: Set a payout schedule
      value:
        accountCode: CODE_OF_ACCOUNT
        payoutSchedule:
          schedule: WEEKLY
          action: CLOSE
    post-updateAccountHolder-addShareholders:
      summary: Add shareholders
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        accountHolderDetails:
          bankAccountDetails: []
          businessDetails:
            legalBusinessName: legalBusinessName
            shareholders:
            - ShareholderContact:
                email: testEmail@gmail.com
                personalData:
                  idNumber: '12345'
            taxId: taxid
    post-updateAccountHolder-bankAccountDetails:
      summary: Update bank account details
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        accountHolderDetails:
          email: tim@green.com
          individualDetails:
            name:
              firstName: Tim
              lastName: Green
          bankAccountDetails:
          - BankAccountDetail:
              accountNumber: '1678116852'
              branchCode: '053101273'
              countryCode: US
              currencyCode: USD
              ownerName: Tim Green
              ownerHouseNumberOrName: '100'
              ownerStreet: Main Street
              ownerPostalCode: 02894
              ownerCity: Springfield
              ownerState: AZ
              ownerCountryCode: US
        createDefaultAccount: 'true'
        legalEntity: Individual
    post-updateAccountHolder-businessDetails:
      summary: Update business details
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        accountHolderDetails:
          bankAccountDetails: []
          businessDetails:
            doingBusinessAs: Test company B.V.
            legalBusinessName: Test company
            shareholders:
            - ShareholderContact:
                address:
                  city: Amsterdam
                  country: NL
                  houseNumberOrName: '1'
                  postalCode: 1111AA
                  stateOrProvince: NH
                  street: Teststreet
                email: testShareholder@adyen.com
                name:
                  firstName: TestFirstName
                  lastName: TestLastName
            taxId: BV123456789
          email: test@adyen.com
          phoneNumber:
            phoneCountryCode: NL
            phoneNumber: 0612345678
            phoneType: Mobile
          webAddress: http://www.accountholderwebsite.com
    post-updateAccountHolder-general:
      summary: Update account holder details
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        accountHolderDetails:
          address:
            city: Amsterdam
            country: NL
            postalCode: '12345'
            stateOrProvince: NH
            street: Teststreet 1
          bankAccountDetails: []
          email: test@adyen.com
          individualDetails:
            name:
              firstName: First name
              lastName: Last Name
            personalData:
              dateOfBirth: '1970-01-01'
              idNumber: '1234567890'
              nationality: NL
          merchantCategoryCode: '7999'
          phoneNumber:
            phoneCountryCode: NL
            phoneNumber: 0612345678
            phoneType: Mobile
          webAddress: http://www.accountholderwebsite.com
    post-updateAccountHolderState-basic:
      summary: Update account holder state
      value:
        accountHolderCode: CODE_OF_ACCOUNT_HOLDER
        disable: true
        reason: test reason payout
        stateType: Payout
    post-uploadDocument-basic:
      summary: Upload a document
      value:
        documentContent: dGVzdCBkb2N1bWVudCBjb250ZW50
        documentDetail:
          accountHolderCode: CODE_OF_ACCOUNT_HOLDER
          documentType: PASSPORT
          filename: passport.png
          description: test passport description