Adyen Transfers API

The Transfers API from Adyen — 4 operation(s) for transfers.

Operations 2

POST /transfers Adyen Transfer Funds #
POST /transfers/{transferId}/returns Adyen Return a Transfer #

Documentation

📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/configure-notifications/
📖
Documentation
https://docs.adyen.com/api-explorer/Account/6/overview
📖
Documentation
https://docs.adyen.com/development-resources/webhooks/
📖
Documentation
https://docs.adyen.com/api-explorer/BalanceControl/1/overview
📖
Documentation
https://docs.adyen.com/api-explorer/BinLookup/52/overview
📖
Documentation
https://docs.adyen.com/api-explorer/Checkout/71/overview
📖
Documentation
https://docs.adyen.com/api-explorer/balanceplatform/2/overview
📖
Documentation
https://docs.adyen.com/api-explorer/balanceplatform-webhooks/1/overview
📖
Documentation
https://docs.adyen.com/development-resources/data-protection-api/
📖
Documentation
https://docs.adyen.com/risk-management/disputes-api
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/fund-transfer/
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/collect-verification-details/hosted/
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/legal-entity-management-api/
📖
Documentation
https://docs.adyen.com/api-explorer/Management/3/overview
📖
Documentation
https://docs.adyen.com/api-explorer/management-webhooks/3/overview
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/notifications
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/notifications/
📖
Documentation
https://docs.adyen.com/online-payments/
📖
Documentation
https://docs.adyen.com/online-payments/online-payouts
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/
📖
Documentation
https://docs.adyen.com/online-payments/tokenization
📖
Documentation
https://docs.adyen.com/api-explorer/report-webhooks/1/overview
📖
Documentation
https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/terminal-api-reference/
📖
Documentation
https://docs.adyen.com/development-resources/testing/create-test-cards
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/business-accounts/transactions/transaction-webhooks/
📖
Documentation
https://docs.adyen.com/api-explorer/transfer-webhooks/3/overview
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/payout-to-users/on-demand-payouts
📖
Documentation
https://docs.adyen.com/development-resources/webhooks

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/adyen-transfers-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

adyen-transfers-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: '4'
  x-publicVersion: true
  title: Adyen Transfers API
  description: ">Versions 1 and 2 of the Transfers API are deprecated. If you are just starting your implementation, use the latest version.\n\nThis API provides endpoints that you can use to transfer funds, whether when [paying out to a transfer instrument](https://docs.adyen.com/marketplaces-and-platforms/payout-to-users/on-demand-payouts), [sending funds to third parties](https://docs.adyen.com/marketplaces-and-platforms/business-accounts/send-receive-funds) for users with business bank accounts, or to [request a payout for a grant offer](https://docs.adyen.com/marketplaces-and-platforms/capital). The API also supports use cases for [getting transactions for business bank accounts](https://docs.adyen.com/marketplaces-and-platforms/business-accounts/transactions-api) and getting [grants and its outstanding balances](https://docs.adyen.com/marketplaces-and-platforms/capital#get-balances). .\n\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-H \"Content-Type: application/json\" \\\n-U \"ws@BalancePlatform.YOUR_BALANCE_PLATFORM\":\"YOUR_WS_PASSWORD\" \\\n...\n```\n## Roles and permissions\nTo use the Transfers API, you need an additional role for your API credential. Transfers must also be enabled for the source balance account. Your Adyen contact will set up the roles and permissions for you.\n## Versioning\nThe Transfers 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://balanceplatform-api-test.adyen.com/btl/v4/transfers\n```\n## Going live\nWhen going live, your Adyen contact will provide your API credential for the live environment. You can then use the username and password to send requests to `https://balanceplatform-api-live.adyen.com/btl/v4`.\n\n"
  termsOfService: https://www.adyen.com/legal/terms-and-conditions
  contact:
    name: Adyen Developer Experience team
    url: https://github.com/Adyen/adyen-openapi
servers:
- url: https://balanceplatform-api-test.adyen.com/btl/v4
tags:
- name: Transfers
paths:
  /transfers:
    post:
      tags:
      - Transfers
      summary: Adyen Transfer Funds
      description: '>Versions 1 and 2 of the Transfers API are deprecated. If you are just starting your implementation, use the latest version.


        Starts a request to transfer funds to [balance accounts](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts), [transfer instruments](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments), or third-party bank accounts. Adyen sends the outcome of the transfer request through webhooks.


        To use this endpoint, you need an additional role for your API credential and transfers must be enabled for the source balance account. Your Adyen contact will set these up for you.'
      x-addedInVersion: '2'
      operationId: post-transfers
      x-sortIndex: 1
      x-methodName: transferFunds
      security:
      - clientKey: []
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            examples:
              payout-cross-border:
                $ref: '#/components/examples/post-transfers-payout-cross-border'
              payout-local-transfer-sepa:
                $ref: '#/components/examples/post-transfers-payout-local-transfer-sepa'
              payout-local-transfer-us:
                $ref: '#/components/examples/post-transfers-payout-local-transfer-us'
              payout-to-balance-account:
                $ref: '#/components/examples/post-transfers-payout-to-balance-account'
              payout-to-transfer-instrument:
                $ref: '#/components/examples/post-transfers-payout-to-transfer-instrument'
            schema:
              $ref: '#/components/schemas/TransferInfo'
      parameters:
      - description: Header for authenticating through SCA
        example: SCA realm="Transfer" auth-param1="eyJjaGFsbGVuZ2UiOiJiVlV6ZW5wek0waFNl..."
        name: WWW-Authenticate
        in: header
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                payout-cross-border:
                  $ref: '#/components/examples/post-transfers-payout-cross-border-200'
                payout-local-transfer-sepa:
                  $ref: '#/components/examples/post-transfers-payout-local-transfer-sepa-200'
                payout-local-transfer-us:
                  $ref: '#/components/examples/post-transfers-payout-local-transfer-us-200'
                payout-to-balance-account:
                  $ref: '#/components/examples/post-transfers-payout-to-balance-account-200'
                payout-to-transfer-instrument:
                  $ref: '#/components/examples/post-transfers-payout-to-transfer-instrument-200'
              schema:
                $ref: '#/components/schemas/Transfer'
          description: OK - the request has succeeded.
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transfer'
              examples:
                post-transfers202Example:
                  summary: Default post-transfers 202 response
                  x-microcks-default: true
                  value:
                    accountHolder: example_value
                    amount: 1000
                    balanceAccount: example_value
                    category: bank
                    categoryData: example_value
                    counterparty: example_value
                    creationDate: '2025-03-15T14:30:00Z'
                    description: A sample description for this resource.
                    direction: incoming
                    id: '500123'
                    paymentInstrument: example_value
                    reason: amountLimitExceeded
                    reference: REF-001
                    referenceForBeneficiary: REF-001
                    status: approvalPending
          description: Accepted - the request has been accepted for processing, but the processing has not been completed.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
              examples:
                post-transfers401Example:
                  summary: Default post-transfers 401 response
                  x-microcks-default: true
                  value:
                    errorCode: CODE123
                    errorType: standard
                    message: example_value
                    pspReference: REF-001
                    status: 500
          description: Unauthorized - authentication required.
          headers:
            auth-param1:
              $ref: '#/components/headers/auth-param1'
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestServiceError'
              examples:
                post-transfers403Example:
                  summary: Default post-transfers 403 response
                  x-microcks-default: true
                  value:
                    detail: example_value
                    errorCode: CODE123
                    instance: example_value
                    invalidFields:
                    - example_value
                    requestId: '500123'
                    response: example_value
                    status: 500
                    title: example_value
                    type: standard
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestServiceError'
              examples:
                post-transfers422Example:
                  summary: Default post-transfers 422 response
                  x-microcks-default: true
                  value:
                    detail: example_value
                    errorCode: CODE123
                    instance: example_value
                    invalidFields:
                    - example_value
                    requestId: '500123'
                    response: example_value
                    status: 500
                    title: example_value
                    type: standard
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestServiceError'
              examples:
                post-transfers500Example:
                  summary: Default post-transfers 500 response
                  x-microcks-default: true
                  value:
                    detail: example_value
                    errorCode: CODE123
                    instance: example_value
                    invalidFields:
                    - example_value
                    requestId: '500123'
                    response: example_value
                    status: 500
                    title: example_value
                    type: standard
          description: Internal Server Error - the server could not process the request.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /transfers/{transferId}/returns:
    post:
      tags:
      - Transfers
      summary: Adyen Return a Transfer
      description: Returns previously transferred funds without creating a new `transferId`.
      x-addedInVersion: '3'
      operationId: post-transfers-transferId-returns
      x-sortIndex: 2
      x-methodName: returnTransfer
      security:
      - clientKey: []
      - BasicAuth: []
      - ApiKeyAuth: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReturnTransferRequest'
      parameters:
      - description: The unique identifier of the transfer to be returned.
        name: transferId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReturnTransferResponse'
              examples:
                post-transfers-transferId-returns200Example:
                  summary: Default post-transfers-transferId-returns 200 response
                  x-microcks-default: true
                  value:
                    id: '500123'
                    reference: REF-001
                    status: Authorised
                    transferId: '500123'
          description: OK - the request has succeeded.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestServiceError'
              examples:
                post-transfers-transferId-returns401Example:
                  summary: Default post-transfers-transferId-returns 401 response
                  x-microcks-default: true
                  value:
                    detail: example_value
                    errorCode: CODE123
                    instance: example_value
                    invalidFields:
                    - example_value
                    requestId: '500123'
                    response: example_value
                    status: 500
                    title: example_value
                    type: standard
          description: Unauthorized - authentication required.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestServiceError'
              examples:
                post-transfers-transferId-returns403Example:
                  summary: Default post-transfers-transferId-returns 403 response
                  x-microcks-default: true
                  value:
                    detail: example_value
                    errorCode: CODE123
                    instance: example_value
                    invalidFields:
                    - example_value
                    requestId: '500123'
                    response: example_value
                    status: 500
                    title: example_value
                    type: standard
          description: Forbidden - insufficient permissions to process the request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestServiceError'
              examples:
                post-transfers-transferId-returns422Example:
                  summary: Default post-transfers-transferId-returns 422 response
                  x-microcks-default: true
                  value:
                    detail: example_value
                    errorCode: CODE123
                    instance: example_value
                    invalidFields:
                    - example_value
                    requestId: '500123'
                    response: example_value
                    status: 500
                    title: example_value
                    type: standard
          description: Unprocessable Entity - a request validation error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestServiceError'
              examples:
                post-transfers-transferId-returns500Example:
                  summary: Default post-transfers-transferId-returns 500 response
                  x-microcks-default: true
                  value:
                    detail: example_value
                    errorCode: CODE123
                    instance: example_value
                    invalidFields:
                    - example_value
                    requestId: '500123'
                    response: example_value
                    status: 500
                    title: example_value
                    type: standard
          description: Internal Server Error - the server could not process the request.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  examples:
    post-transfers-payout-cross-border-200:
      summary: Response code - 200 OK
      description: Example response for a transfers request
      value:
        id: 1W1UG35U8A9J5ZLG
        accountHolder:
          description: Your account holder description
          id: AH3227C223222C5GXQXF658WB
          reference: Your account holder reference
        amount:
          value: 110000
          currency: EUR
        balanceAccount:
          description: Your balance account description
          id: BAB8B2C3D4E5F6G7H8D9J6GD4
          reference: Your balance account reference
        category: bank
        categoryData:
          priority: crossBorder
          type: bank
        counterparty:
          bankAccount:
            accountHolder:
              fullName: A. Klaassen
              address:
                city: San Francisco
                country: US
                postalCode: '94678'
                stateOrProvince: CA
                line1: '274'
                line2: Brannan Street
            accountIdentification:
              type: numberAndBic
              accountNumber: '123456789'
              bic: BOFAUS3NXXX
        paymentInstrument:
          description: Your payment instrument description
          id: PI3222G223222G59347DAA265
          reference: Your payment instrument reference
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
        direction: outgoing
        reason: approved
        status: authorised
    post-transfers-payout-local-transfer-us-200:
      summary: Response code - 200 OK
      description: Example response for a transfers request
      value:
        id: 1W1UG35U8A9J5ZLG
        accountHolder:
          description: Your account holder description
          id: AH3227C223222C5GXQXF658WB
          reference: Your account holder reference
        amount:
          value: 110000
          currency: USD
        balanceAccount:
          description: Your balance account description
          id: BAB8B2C3D4E5F6G7H8D9J6GD4
          reference: Your balance account reference
        category: bank
        categoryData:
          priority: regular
          type: bank
        counterparty:
          bankAccount:
            accountHolder:
              fullName: A. Klaassen
            accountIdentification:
              type: usLocal
              accountNumber: '123456789'
              routingNumber: 11000138
        paymentInstrument:
          description: Your payment instrument description
          id: PI3222G223222G59347DAA265
          reference: Your payment instrument reference
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
        direction: outgoing
        reason: approved
        status: authorised
    post-transfers-payout-local-transfer-sepa-200:
      summary: Response code - 200 OK
      description: Example response for a transfers request
      value:
        id: 1W1UG35U8A9J5ZLG
        accountHolder:
          description: Your account holder description
          id: AH3227C223222C5GXQXF658WB
          reference: Your account holder reference
        amount:
          value: 110000
          currency: EUR
        balanceAccount:
          description: Your balance account description
          id: BAB8B2C3D4E5F6G7H8D9J6GD4
          reference: Your balance account reference
        category: bank
        categoryData:
          priority: regular
          type: bank
        counterparty:
          bankAccount:
            accountHolder:
              fullName: A. Klaassen
            accountIdentification:
              type: iban
              iban: NL91ABNA0417164300
        paymentInstrument:
          description: Your payment instrument description
          id: PI3222G223222G59347DAA265
          reference: Your payment instrument reference
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
        direction: outgoing
        reason: approved
        status: authorised
    post-transfers-payout-to-balance-account-200:
      summary: Response code - 200 OK
      description: Example response for a transfers request
      value:
        id: 1W1UG35U8A9J5ZLG
        accountHolder:
          description: Your account holder description
          id: AH3227C223222C5GXQXF658WB
          reference: Your account holder reference
        amount:
          currency: EUR
          value: 10000
        balanceAccount:
          description: Your balance account description
          id: BAB8B2C3D4E5F6G7H8D9J6GD4
          reference: Your balance account reference
        category: internal
        counterparty:
          balanceAccountId: BA32272223222B5LPRFDW7J9G
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
        direction: outgoing
        reason: approved
        status: authorised
    post-transfers-payout-local-transfer-sepa:
      summary: Make a SEPA funds transfer
      description: Example request to make a SEPA funds transfer
      value:
        amount:
          value: 110000
          currency: EUR
        balanceAccountId: BAB8B2C3D4E5F6G7H8D9J6GD4
        category: bank
        counterparty:
          bankAccount:
            accountHolder:
              fullName: A. Klaassen
            accountIdentification:
              type: iban
              iban: NL91ABNA0417164300
        priority: regular
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
    post-transfers-payout-local-transfer-us:
      summary: Make a US local funds transfer
      description: Example request to make a US local funds transfer
      value:
        amount:
          value: 110000
          currency: USD
        balanceAccountId: BAB8B2C3D4E5F6G7H8D9J6GD4
        category: bank
        counterparty:
          bankAccount:
            accountHolder:
              fullName: A. Klaassen
            accountIdentification:
              type: usLocal
              accountNumber: '123456789'
              routingNumber: 11000138
        priority: regular
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
    post-transfers-payout-cross-border:
      summary: Make a cross-border transfer
      description: Example request to make a cross-border transfer
      value:
        amount:
          value: 110000
          currency: EUR
        balanceAccountId: BAB8B2C3D4E5F6G7H8D9J6GD4
        category: bank
        counterparty:
          bankAccount:
            accountHolder:
              fullName: A. Klaassen
              address:
                city: San Francisco
                country: US
                postalCode: '94678'
                stateOrProvince: CA
                line1: '274'
                line2: Brannan Street
            accountIdentification:
              type: numberAndBic
              accountNumber: '123456789'
              bic: BOFAUS3NXXX
        priority: crossBorder
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
    post-transfers-payout-to-balance-account:
      summary: Transfer funds to another balance account
      description: Example request to transfer funds to another balance account
      value:
        amount:
          value: 10000
          currency: EUR
        balanceAccountId: BAB8B2C3D4E5F6G7H8D9J6GD4
        category: internal
        counterparty:
          balanceAccountId: BA32272223222B5LPRFDW7J9G
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
    post-transfers-payout-to-transfer-instrument:
      summary: Pay out to a transfer instrument
      description: Example request to pay out to a transfer instrument
      value:
        amount:
          value: 80000
          currency: EUR
        balanceAccountId: BAB8B2C3D4E5F6G7H8D9J6GD4
        category: bank
        counterparty:
          transferInstrumentId: SE1234567890ABC1234567890
        priority: regular
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
    post-transfers-payout-to-transfer-instrument-200:
      summary: Response code - 200 OK
      description: Example response for a transfers request
      value:
        id: 1W1UG35U8A9J5ZLG
        accountHolder:
          description: Your account holder description
          id: AH3227C223222C5GXQXF658WB
          reference: Your account holder reference
        amount:
          value: 80000
          currency: EUR
        balanceAccount:
          description: Your balance account description
          id: BAB8B2C3D4E5F6G7H8D9J6GD4
          reference: Your balance account reference
        category: bank
        categoryData:
          priority: regular
          type: bank
        counterparty:
          transferInstrumentId: SE1234567890ABC1234567890
        paymentInstrument:
          description: Your payment instrument description
          id: PI3222G223222G59347DAA265
          reference: Your payment instrument reference
        referenceForBeneficiary: Your-reference-sent-to-the-beneficiary
        reference: Your internal reference for the transfer
        description: Your description for the transfer
        direction: outgoing
        reason: approved
        status: authorised
  schemas:
    IbanAccountIdentification:
      additionalProperties: false
      properties:
        iban:
          description: The international bank account number as defined in the [ISO-13616](https://www.iso.org/standard/81090.html) standard.
          type: string
        type:
          default: iban
          description: '**iban**'
          enum:
          - iban
          type: string
      required:
      - type
      - iban
      type: object
    InvalidField:
      properties:
        message:
          description: Description of the validation error.
          type: string
        name:
          description: The field that has an invalid value.
          type: string
        value:
          description: The invalid value.
          type: string
      required:
      - name
      - value
      - message
      type: object
    TransferNotificationValidationFact:
      properties:
        result:
          description: The evaluation result of the validation fact.
          type: string
        type:
          description: The type of the validation fact.
          type: string
      type: object
    RestServiceError:
      properties:
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.
          type: string
        errorCode:
          description: A code that identifies the problem type.
          type: string
        instance:
          description: A unique URI that identifies the specific occurrence of the problem.
          type: string
        invalidFields:
          description: Detailed explanation of each validation error, when applicable.
          items:
            $ref: '#/components/schemas/InvalidField'
          type: array
        requestId:
          description: A unique reference for the request, essentially the same as `pspReference`.
          type: string
        response:
          description: JSON response payload.
          $ref: '#/components/schemas/JSONObject'
        status:
          description: The HTTP status code.
          format: int32
          type: integer
        title:
          description: A short, human-readable summary of the problem type.
          type: string
        type:
          description: A URI that identifies the problem type, pointing to human-readable documentation on this problem type.
          type: string
      required:
      - type
      - errorCode
      - title
      - detail
      - status
      type: object
    NOLocalAccountIdentification:
      additionalProperties: false
      properties:
        accountNumber:
          description: The 11-digit bank account number, without separators or whitespace.
          maxLength: 11
          minLength: 11
          type: string
        type:
          default: noLocal
          description: '**noLocal**'
          enum:
          - noLocal
          type: string
      required:
      - type
      - accountNumber
      type: object
    BankCategoryData:
      additionalProperties: false
      properties:
        priority:
          x-addedInVersion: '4'
          description: 'The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. Required for transfers with `category` **bank**.


            Possible values:


            * **regular**: For normal, low-value transactions.


            * **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.


            * **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.


            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).


            * **crossBorder**: High-value transfer to a recipient in a different country.


            * **internal**: Transfer to an Adyen-issued business bank account (by bank account number/IBAN).'
          enum:
          - crossBorder
          - fast
          - instant
          - internal
          - regular
          - wire
          type: string
        type:
          default: bank
          description: '**bank**'
          enum:
          - bank
          type: string
      type: object
    AdditionalBankIdentification:
      properties:
        code:
          description: The value of the additional bank identification.
          type: string
        type:
          description: "The type of additional bank identification, depending on the country.\n\nPossible values:\n\n * **gbSortCode**: The 6-digit [UK sort code](https://en.wikipedia.org/wiki/Sort_code), without separators or spaces\n * **usRoutingNumber**: The 9-digit [routing number](https://en.wikipedia.org/wiki/ABA_routing_transit_number), without separators or spaces."
          enum:
          - gbSortCode
          - usRoutingNumber
          type: string
      type: object
    Amount:
      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
    SELocalAccountIdentification:
      additionalProperties: false
      properties:
        accountNumber:
          description: The 7- to 10-digit bank account number ([Bankkontonummer](https://sv.wikipedia.org/wiki/Bankkonto)), without the clearing number, separators, or whitespace.
          maxLength: 10
          minLength: 7
          type: string
        clearingNumber:
          description: The 4- to 5-digit clearing number ([Clearingnummer](https://sv.wikipedia.org/wiki/Clearingnummer)), without separators or whitespace.
          maxLength: 5
          minLength: 4
          type: string
        type:
          default: seLocal
          description: '**seLocal**'
          enum:
          - seLocal
          type: string
      required:
      - type
      - accountNumber
      - clearingNumber
      type: object
    CounterpartyInfoV3:
      properties:
        balanceAccountId:
          description: Unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
          type: string
        bankAccount:
          description: Contains information about the bank account.
          $ref: '#/components/schemas/BankAccountV3'
        transferInstrumentId:
          description: Unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments__resParam_id).
          type: string
      type: object
    USLocalAccountIdentification:
      additionalProperties: false
      properties:
        accountNumber:
          description: The bank account number, without separators or whitespace.
          maxLength: 18
          minLength: 2
          type: string
        accountType:
          default: checking
          description: 'The bank account type.


            Possible values: **checking** or **savings**. Defaults to **checking**.'
          enum:
          - checking
          - savings
          type: string
        routingNumber:
          description: The 9-digit [routing number](https://en.wikipedia.org/wiki/ABA_routing_transit_number), without separators or whitespace.
          maxLength: 9
          minLength: 9
          type: string
        ty

# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/openapi/adyen-transfers-api-openapi.yml