> ## Documentation Index
> Fetch the complete documentation index at: https://developers.portao3.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirm a transfer request

> Confirms a transfer request: the money moves between the wallet and the organization's main wallet.

The business policies are evaluated again on confirmation. The requester can confirm only when they approve the transfer (`APPROVE`, also when no policy matches) and must have the wallet shared with them as `OWNER` or `USER`; organization admins can confirm whatever the policies decide. A request waiting for approval is confirmed automatically once approved — it can't be confirmed by hand. Every required transaction custom field must have a value. See [Business policies and approvals](https://developers.portao3.com.br/guides/policies-and-approvals.md#organization-admins) for what an organization admin's confirmation skips.

The request becomes `CONFIRMED` once the money moves. A request for a future day becomes `SCHEDULED` instead, and the answer includes the schedule: the money moves on `scheduledAt`, and cancelling the request cancels it. When the bank refuses the transfer — for example, for insufficient funds — the request becomes `FAILED` with the reason in `failureReason`, and the error is returned. A `FAILED` request can't be retried: create another one — after an error from an unreachable bank, only once the wallets' balances show the money didn't move.


## OpenAPI

````yaml /api-reference/banking.openapi.json post /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transfer-requests/{transferRequestId}/confirm
openapi: 3.0.3
info:
  title: Banking
  version: 1.0.0
  description: >-
    Portão 3 banking API. Every endpoint requires a bearer token in the
    Authorization header (Authorization: Bearer <token>) unless its page states
    otherwise; see the Authentication guide. That requirement is not repeated
    per endpoint. Generated by tools/openapi from code (routes + security) and
    the hand-written spec (request/response bodies). Banking attaches a zod
    validationSchema at the route; request bodies are resolved from it (object +
    array roots). Responses have no presenter layer, so they stay tier=unknown.
    Confidence tiers: generated:typed=262 copied:manual=1 unknown=35.
servers:
  - url: https://api.banking.v2.portao3.com.br/
    description: production
  - url: https://api.banking.dev.3pers.com.br/
    description: development
security: []
tags:
  - name: Accounts
  - name: Account Limits
  - name: Wallets
  - name: Transaction Limits
  - name: Transfers
  - name: Cards
  - name: Card Limits
  - name: Cards 3DS
  - name: Pix Payments
  - name: PIX Keys (DICT)
  - name: PIX Charges
  - name: PIX Automatic
  - name: PIX Initiation (Open Finance)
  - name: PIX Infractions (MED)
  - name: Boleto Payments
  - name: Boleto Charges
  - name: TED
  - name: Transactions
  - name: Cashback
  - name: Currency Codes
  - name: Reversals
paths:
  /realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transfer-requests/{transferRequestId}/confirm:
    post:
      tags:
        - Transfers
      summary: Confirm a transfer request
      description: >-
        Confirms a transfer request: the money moves between the wallet and the
        organization's main wallet.
      operationId: >-
        postRealmsByRealmIdOrganizationsByOrganizationIdAccountsByAccountIdWalletsByWalletIdTransferRequestsByTransferRequestIdConfirm
      parameters:
        - name: realmId
          in: path
          required: true
          description: |-
            ID of your realm.

            Format: `UUID`
          schema:
            type: string
            format: uuid
          example: f495ff0c-ab54-4f99-8e92-ca8682e4de9b
        - name: organizationId
          in: path
          required: true
          description: |-
            ID of the organization the wallet belongs to.

            Format: `UUID`
          schema:
            type: string
            format: uuid
          example: c4bd3f21-dfbd-44e8-8055-68ba15bed410
        - name: accountId
          in: path
          required: true
          description: ID of the organization's account (24 hexadecimal characters).
          schema:
            type: string
            pattern: ^[0-9a-fA-F]{24}$
          example: 66f2a1c7b4d3e80012c9a0b4
        - name: walletId
          in: path
          required: true
          description: >-
            ID of the wallet the transfer request belongs to (24 hexadecimal
            characters).
          schema:
            type: string
            pattern: ^[0-9a-fA-F]{24}$
          example: 66f2a3d1b4d3e80012c9a0d2
        - name: transferRequestId
          in: path
          required: true
          description: ID of the transfer request (24 hexadecimal characters).
          schema:
            type: string
            pattern: ^[0-9a-fA-F]{24}$
          example: 6720d4f1b4d3e80012c9a2e7
        - name: x-environment
          in: header
          required: false
          description: >-
            Environment of the wallet: `LIVE` (production) or `TEST` (sandbox).
            When you omit it, the request runs in `TEST`; any other value is
            rejected.
          schema:
            type: string
            enum:
              - LIVE
              - TEST
          example: LIVE
      responses:
        '201':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: ID of the transfer request.
                    example: 6720d4f1b4d3e80012c9a2e7
                  realmId:
                    type: string
                    description: ID of the realm.
                    example: f495ff0c-ab54-4f99-8e92-ca8682e4de9b
                    format: uuid
                  organizationId:
                    type: string
                    description: ID of the organization.
                    example: c4bd3f21-dfbd-44e8-8055-68ba15bed410
                    format: uuid
                  accountId:
                    type: string
                    description: ID of the account both wallets belong to.
                    example: 66f2a1c7b4d3e80012c9a0b4
                  walletId:
                    type: string
                    description: >-
                      ID of the wallet that receives the money — or sends it
                      back, when `amount` is negative.
                    example: 66f2a3d1b4d3e80012c9a0d2
                  walletName:
                    type: string
                    description: >-
                      Name of that wallet when the request was created. Absent
                      when the wallet had no name.
                    example: Marketing
                  defaultWalletId:
                    type: string
                    description: >-
                      ID of the organization's main wallet when the request was
                      created: the other side of the transfer. Absent only on a
                      few requests from the first version of transfer requests,
                      which carry `originWalletId` instead.
                    example: 66f2a1d0b4d3e80012c9a0b9
                  environment:
                    type: string
                    enum:
                      - LIVE
                      - TEST
                    description: >-
                      Environment of the request: `LIVE` (production) or `TEST`
                      (sandbox).
                    example: LIVE
                  destinationCategory:
                    type: string
                    enum:
                      - FLEX_NATIONAL
                      - FLEX_INTERNATIONAL
                      - FOOD
                      - GAS
                      - MOBILITY
                      - TOLL
                      - FLEX_NATIONAL_WITHOUT_WITHDRAWALS
                      - ADS
                      - SAAS
                      - HOTEL
                      - AIRLINES
                      - TRAVEL
                      - BLOCKED
                      - CASHBACK
                    description: >-
                      Balance category of `walletId` the transfer moves: where
                      the money lands when `amount` is positive, and where it is
                      taken from when `amount` is negative. The main wallet
                      always uses `FLEX_INTERNATIONAL`.
                    example: FLEX_NATIONAL
                  amount:
                    type: number
                    description: >-
                      Amount in cents, never zero. Positive moves money from the
                      organization's main wallet into `walletId`; negative sends
                      it from `walletId` back to the main wallet.
                    example: 250000
                  txnCurrency:
                    type: string
                    description: >-
                      Currency of the amount, as an ISO 4217 numeric code: `986`
                      (Brazilian real).
                    example: '986'
                  description:
                    type: string
                    description: Description of the transfer. Absent when none was given.
                    example: Verba de eventos — novembro
                  requester:
                    type: object
                    properties:
                      userId:
                        type: string
                        description: >-
                          ID of the user who created the request. Absent only on
                          a few requests from the first version of transfer
                          requests, which carry `id` instead.
                        example: e3553bc1-5e20-4e17-b22a-a796fda0aa99
                        format: uuid
                      name:
                        type: string
                        description: >-
                          Name of the user, as it was when they created the
                          request. Absent only on a few requests from the first
                          version of transfer requests.
                        example: Mariana Costa
                      email:
                        type: string
                        description: >-
                          E-mail of the user, as it was when they created the
                          request.
                        example: mariana.costa@acme.com.br
                      id:
                        type: string
                        description: >-
                          ID of the user, on a few requests from the first
                          version of transfer requests only.
                        example: e3553bc1-5e20-4e17-b22a-a796fda0aa99
                        format: uuid
                    required:
                      - email
                    description: Who created the request.
                  status:
                    type: string
                    enum:
                      - PENDING_APPROVAL
                      - REQUESTED
                      - CONFIRMED
                      - CANCELLED
                      - EXPIRED
                      - FAILED
                      - SCHEDULED
                      - DENIED
                    description: >-
                      Status of the request:

                      - `REQUESTED` — created; it can still be edited, sent for
                      approval or confirmed.

                      - `PENDING_APPROVAL` — waiting for the approvers the
                      business policy names.

                      - `CONFIRMED` — the money moved.

                      - `SCHEDULED` — confirmed for a future day; the money
                      moves on `scheduledAt`.

                      - `CANCELLED` — cancelled before the money moved.

                      - `EXPIRED` — the approval deadline passed before it was
                      approved.

                      - `FAILED` — the transfer was refused, for the reason in
                      `failureReason`.

                      - `DENIED` — only on a few requests from the first version
                      of transfer requests.
                    example: CONFIRMED
                  policyRequestId:
                    type: string
                    description: >-
                      ID of the approval request opened when the request was
                      sent for approval, or of the automatic approval that
                      confirmed it. Absent otherwise.
                    example: 4d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a
                  autoResolutionRequestedAt:
                    type: string
                    description: >-
                      When a confirmation first asked for the automatic approval
                      of the matching business policy. Absent when no
                      confirmation needed it.
                    example: '2026-11-02T13:12:05.000Z'
                    format: date-time
                  scheduledAt:
                    type: string
                    description: >-
                      Day the transfer is scheduled for. Absent when it
                      transfers as soon as it is confirmed.
                    example: '2026-11-10T00:00:00.000Z'
                    format: date-time
                  scheduledTimeZone:
                    type: string
                    description: >-
                      Time zone `scheduledAt` was read in — `America/Sao_Paulo`,
                      the only one supported. Present only with `scheduledAt`.
                    example: America/Sao_Paulo
                  scheduleId:
                    type: string
                    description: >-
                      ID of the schedule created when a request for a future day
                      was confirmed. Cancel the request to cancel it.
                    example: 8c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f
                    format: uuid
                  approvalExpiresAt:
                    type: string
                    description: >-
                      Deadline for the approval: 21:00 (São Paulo time) of the
                      day the transfer is for, and at least one hour after the
                      request was sent for approval. Present once it was sent
                      for approval.
                    example: '2026-11-03T00:00:00.000Z'
                    format: date-time
                  confirmedAt:
                    type: string
                    description: When the money moved.
                    example: '2026-11-02T13:12:07.000Z'
                    format: date-time
                  canceledAt:
                    type: string
                    description: When the request was cancelled.
                    example: '2026-11-02T15:40:00.000Z'
                    format: date-time
                  failureReason:
                    type: string
                    description: >-
                      Why the transfer failed, as an error code — for example
                      `INSUFFICIENT_FUNDS`, `ACCOUNT_BLOCKED` or
                      `BANKING_PROVIDER_UNAVAILABLE`. Only on `FAILED` requests.
                    example: INSUFFICIENT_FUNDS
                  customFields:
                    type: object
                    additionalProperties: {}
                    description: >-
                      Values of the organization's transaction custom fields,
                      keyed by each field's `slug`. Absent when the request has
                      none.


                      ---


                      Example: `{"cost-center":"CC-1020"}`
                    example:
                      cost-center: CC-1020
                  createdAt:
                    type: string
                    description: When the request was created.
                    example: '2026-11-02T13:10:22.000Z'
                    format: date-time
                  updatedAt:
                    type: string
                    description: When the request last changed.
                    example: '2026-11-02T13:10:22.000Z'
                    format: date-time
                  decision:
                    type: object
                    additionalProperties: {}
                    description: >-
                      Decision recorded on a few requests from the first version
                      of transfer requests.
                  deniedAt:
                    type: string
                    description: >-
                      When the request was denied, on a few requests from the
                      first version of transfer requests.
                    example: '2025-11-20T18:05:00.000Z'
                    format: date-time
                  originAccountId:
                    type: string
                    description: >-
                      Account the money came from, on a few requests from the
                      first version of transfer requests.
                    example: 66f2a1c7b4d3e80012c9a0b4
                  originWalletId:
                    type: string
                    description: >-
                      Wallet the money came from, on a few requests from the
                      first version of transfer requests.
                    example: 66f2a1d0b4d3e80012c9a0b9
                  sourceCategory:
                    type: string
                    enum:
                      - FLEX_NATIONAL
                      - FLEX_INTERNATIONAL
                      - FOOD
                      - GAS
                      - MOBILITY
                      - TOLL
                      - FLEX_NATIONAL_WITHOUT_WITHDRAWALS
                      - ADS
                      - SAAS
                      - HOTEL
                      - AIRLINES
                      - TRAVEL
                      - BLOCKED
                      - CASHBACK
                    description: >-
                      Balance category the money came from, on a few requests
                      from the first version of transfer requests.
                    example: FLEX_INTERNATIONAL
                  policy:
                    description: >-
                      The business policy evaluated on this confirmation, and
                      what it decided. `null` when the request was confirmed
                      after its approval, and when an organization admin
                      confirmed it while the policies couldn't be evaluated.
                    type: object
                    properties:
                      actions:
                        type: object
                        properties:
                          autoAction:
                            type: string
                            enum:
                              - APPROVE
                              - DENY
                              - NONE
                            description: >-
                              `APPROVE` — the transfer can be confirmed right
                              away; `DENY` — it is refused; `NONE` — it needs
                              approval from `approvals`. When no policy matches,
                              this is `APPROVE` and no other field of the policy
                              is present.
                            example: NONE
                          hierarchy:
                            type: boolean
                            description: >-
                              Whether the approvers decide one after the other,
                              in the order of `approvals`, instead of all at
                              once.
                            example: false
                          moveBalance:
                            type: object
                            properties:
                              addBalance:
                                type: boolean
                                description: >-
                                  Whether the policy adds the missing balance to
                                  the wallet before the transfer.
                                example: true
                              fromAccountId:
                                type: string
                                description: >-
                                  Account the top-up comes from. Present when
                                  `addBalance` is `true`.
                                example: 66f2a1c7b4d3e80012c9a0b4
                              fromWalletId:
                                type: string
                                description: >-
                                  Wallet the top-up comes from. Present when
                                  `addBalance` is `true`.
                                example: 66f2a1d0b4d3e80012c9a0b9
                            required:
                              - addBalance
                            description: >-
                              Whether the policy tops up the wallet before the
                              transfer.
                          approvals:
                            type: array
                            items:
                              type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - USER
                                    - GROUP
                                  description: >-
                                    `USER` for a user, `GROUP` for a group of
                                    users.
                                  example: USER
                                id:
                                  type: string
                                  description: ID of the user or of the group.
                                  example: 0b6f2c1e-8d4a-4f3b-9a7e-5c2d1e0f9a8b
                                name:
                                  type: string
                                  description: >-
                                    Name of the user or of the group. Absent
                                    when it can't be read at that moment.
                                  example: Rafael Lima
                              required:
                                - type
                                - id
                              description: An approver named by a business policy.
                            description: >-
                              Who must approve the transfer. Present when
                              `autoAction` is `NONE`.
                        required:
                          - autoAction
                        description: What the policy decides.
                      id:
                        type: string
                        description: ID of the policy.
                        example: 3f2e1d0c-9b8a-4c7d-8e6f-5a4b3c2d1e0f
                      realmId:
                        type: string
                        description: ID of the realm.
                        example: f495ff0c-ab54-4f99-8e92-ca8682e4de9b
                        format: uuid
                      organizationId:
                        type: string
                        description: ID of the organization.
                        example: c4bd3f21-dfbd-44e8-8055-68ba15bed410
                        format: uuid
                      context:
                        type: string
                        description: >-
                          Kind of operation the policy governs: `PAYMENT` for
                          transfers and payments.
                        example: PAYMENT
                      name:
                        type: string
                        description: Name of the policy.
                        example: Transferências acima de R$ 1.000
                      description:
                        type: string
                        description: Description of the policy.
                        example: >-
                          Pede aprovação do financeiro para transferências acima
                          de R$ 1.000.
                      order:
                        type: number
                        description: >-
                          Position of the policy in the organization's
                          evaluation order; the first that matches wins.
                        example: 1
                      status:
                        type: string
                        description: Status of the policy.
                        example: ACTIVE
                      conditions:
                        type: object
                        properties:
                          logic:
                            type: string
                            enum:
                              - AND
                              - OR
                            description: >-
                              `AND` — every group must match; `OR` — any one is
                              enough.
                            example: AND
                          groups:
                            type: array
                            items:
                              type: object
                              properties:
                                logic:
                                  type: string
                                  enum:
                                    - AND
                                    - OR
                                  description: >-
                                    `AND` — every condition must match; `OR` —
                                    any one is enough.
                                  example: AND
                                dependsOn:
                                  type: array
                                  items:
                                    type: string
                                  description: |-
                                    Other groups this group depends on.

                                    ---

                                    Example: `[]`
                                  example: []
                                items:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      operator:
                                        type: string
                                        description: >-
                                          How the field is compared, such as
                                          `GREATER_THAN` or `EQUALS`.
                                        example: GREATER_THAN
                                      field:
                                        type: string
                                        description: >-
                                          Field of the transfer the condition
                                          reads.
                                        example: amount
                                      maskType:
                                        type: string
                                        description: >-
                                          Format the value is compared in, when
                                          the field needs one.
                                        example: CURRENCY
                                      dynamicFieldValue:
                                        type: string
                                        description: >-
                                          Another field whose value is compared
                                          instead of `value`.
                                        example: customFields.cost-center
                                      value:
                                        description: Value the field is compared with.
                                        example: 100000
                                    required:
                                      - operator
                                      - field
                                    description: One condition of a business policy.
                                  description: The conditions of the group.
                              required:
                                - logic
                                - items
                              description: A group of conditions of a business policy.
                            description: >-
                              The groups of conditions. With none, the policy
                              matches every transfer.
                        required:
                          - logic
                          - groups
                        description: The conditions the policy matches.
                      createdAt:
                        type: string
                        description: When the policy was created.
                        example: '2026-09-15T14:00:00.000Z'
                        format: date-time
                      updatedAt:
                        type: string
                        description: When the policy last changed.
                        example: '2026-10-01T09:30:00.000Z'
                        format: date-time
                    required:
                      - actions
                    title: Policy evaluation
                    nullable: true
                  schedule:
                    type: object
                    properties:
                      id:
                        type: string
                        description: >-
                          ID of the schedule — the transfer request's
                          `scheduleId`.
                        example: 8c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f
                        format: uuid
                      amount:
                        type: number
                        description: Amount in cents.
                        example: 250000
                      scheduledAt:
                        type: string
                        description: When the transfer runs.
                        example: '2026-11-10T00:00:00.000Z'
                        format: date-time
                      type:
                        type: string
                        description: 'Kind of schedule: `P2P_TRANSFER`.'
                        example: P2P_TRANSFER
                      status:
                        type: string
                        description: 'Status of the schedule: `SCHEDULED` until it runs.'
                        example: SCHEDULED
                      description:
                        description: Description of the transfer.
                        example: Verba de eventos — novembro
                        type: string
                      realm:
                        type: string
                        description: ID of the realm.
                        example: f495ff0c-ab54-4f99-8e92-ca8682e4de9b
                        format: uuid
                      organization:
                        type: string
                        description: ID of the organization.
                        example: c4bd3f21-dfbd-44e8-8055-68ba15bed410
                        format: uuid
                      account:
                        type: string
                        description: ID of the account.
                        example: 66f2a1c7b4d3e80012c9a0b4
                      wallet:
                        type: string
                        description: ID of the wallet that pays.
                        example: 66f2a1d0b4d3e80012c9a0b9
                      category:
                        type: string
                        enum:
                          - FLEX_NATIONAL
                          - FLEX_INTERNATIONAL
                          - FOOD
                          - GAS
                          - MOBILITY
                          - TOLL
                          - FLEX_NATIONAL_WITHOUT_WITHDRAWALS
                          - ADS
                          - SAAS
                          - HOTEL
                          - AIRLINES
                          - TRAVEL
                          - BLOCKED
                          - CASHBACK
                        description: Balance category debited.
                        example: FLEX_INTERNATIONAL
                      retryCount:
                        type: number
                        nullable: true
                        description: >-
                          How many times running it was retried. Absent, or
                          `null`, before it runs.
                        example: 0
                      createdAt:
                        type: string
                        description: When the schedule was created.
                        example: '2026-11-02T13:12:07.000Z'
                        format: date-time
                      updatedAt:
                        type: string
                        description: When it last changed.
                        example: '2026-11-02T13:12:07.000Z'
                        format: date-time
                      createdBy:
                        type: string
                        description: Who created it.
                        example: e3553bc1-5e20-4e17-b22a-a796fda0aa99
                      updatedBy:
                        type: string
                        description: Who last changed it.
                        example: e3553bc1-5e20-4e17-b22a-a796fda0aa99
                      cancelledBy:
                        type: string
                        description: Who cancelled it. Absent unless cancelled.
                        example: e3553bc1-5e20-4e17-b22a-a796fda0aa99
                      cancelledAt:
                        type: string
                        description: When it was cancelled. Absent unless cancelled.
                        example: '2026-11-05T10:00:00.000Z'
                        format: date-time
                      p2pTransfer:
                        type: object
                        properties:
                          id:
                            type: string
                            description: ID of the scheduled transfer.
                            example: 1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d
                            format: uuid
                          transactionSchedule:
                            type: string
                            description: ID of its schedule.
                            example: 8c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f
                            format: uuid
                          payee:
                            type: object
                            properties:
                              realm:
                                type: string
                                description: ID of the realm.
                                example: f495ff0c-ab54-4f99-8e92-ca8682e4de9b
                                format: uuid
                              organization:
                                type: string
                                description: ID of the organization.
                                example: c4bd3f21-dfbd-44e8-8055-68ba15bed410
                                format: uuid
                              account:
                                type: string
                                description: ID of the account.
                                example: 66f2a1c7b4d3e80012c9a0b4
                              wallet:
                                type: string
                                description: ID of the wallet that receives the money.
                                example: 66f2a3d1b4d3e80012c9a0d2
                              category:
                                type: string
                                enum:
                                  - FLEX_NATIONAL
                                  - FLEX_INTERNATIONAL
                                  - FOOD
                                  - GAS
                                  - MOBILITY
                                  - TOLL
                                  - FLEX_NATIONAL_WITHOUT_WITHDRAWALS
                                  - ADS
                                  - SAAS
                                  - HOTEL
                                  - AIRLINES
                                  - TRAVEL
                                  - BLOCKED
                                  - CASHBACK
                                description: Balance category credited.
                                example: FLEX_NATIONAL
                            required:
                              - realm
                              - organization
                              - account
                              - wallet
                              - category
                            description: The wallet the transfer pays.
                        required:
                          - id
                          - transactionSchedule
                          - payee
                        description: The transfer the schedule runs.
                    required:
                      - id
                      - amount
                      - scheduledAt
                      - type
                      - status
                      - description
                      - realm
                      - organization
                      - account
                      - wallet
                      - createdAt
                      - updatedAt
                      - createdBy
                      - updatedBy
                      - p2pTransfer
                    description: >-
                      The schedule created when the request is for a future day
                      (status `SCHEDULED`). Absent when the money moved now.
                required:
                  - accountId
                  - amount
                  - createdAt
                  - destinationCategory
                  - environment
                  - id
                  - organizationId
                  - policy
                  - realmId
                  - requester
                  - status
                  - updatedAt
                  - walletId
                description: A transfer request just confirmed.
        '403':
          description: >-
            `TRANSFER_REQUEST_FORBIDDEN` — You are neither the requester nor an
            admin of the organization, or the request is waiting for approval.


            `FORBIDDEN_WALLET` — You are the requester but the wallet is no
            longer shared with you as `OWNER` or `USER`.


            `TRANSFER_REQUEST_REQUIRES_APPROVAL` — A business policy requires
            approval: send the request for approval instead.


            `TRANSFER_REQUEST_POLICY_DENIED` — A business policy refuses the
            transfer.
          content:
            application/json:
              schema:
                type: object
                properties:
                  traceId:
                    type: string
                    description: >-
                      Identifier of the request that failed. Quote it when
                      contacting support.
                    example: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                  code:
                    type: string
                    enum:
                      - TRANSFER_REQUEST_FORBIDDEN
                      - FORBIDDEN_WALLET
                      - TRANSFER_REQUEST_REQUIRES_APPROVAL
                      - TRANSFER_REQUEST_POLICY_DENIED
                    description: >-
                      Stable, machine-readable error code. Branch on this, never
                      on `message`.
                  origin:
                    type: string
                    enum:
                      - BANKING
                    description: Service that produced the error.
                  message:
                    type: string
                    description: >-
                      Human-readable explanation. Its wording may change without
                      notice.
                required:
                  - traceId
                  - code
                  - origin
                  - message
              example:
                traceId: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                code: TRANSFER_REQUEST_FORBIDDEN
                origin: BANKING
                message: You are not allowed to act on this transfer request
        '404':
          description: >-
            `ACCOUNT_NOT_FOUND` — No account with this ID exists in the
            organization.


            `WALLET_NOT_FOUND` — No wallet with this ID exists in the account
            and environment.


            `TRANSFER_REQUEST_NOT_FOUND` — The wallet has no transfer request
            with this ID.
          content:
            application/json:
              schema:
                type: object
                properties:
                  traceId:
                    type: string
                    description: >-
                      Identifier of the request that failed. Quote it when
                      contacting support.
                    example: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                  code:
                    type: string
                    enum:
                      - ACCOUNT_NOT_FOUND
                      - WALLET_NOT_FOUND
                      - TRANSFER_REQUEST_NOT_FOUND
                    description: >-
                      Stable, machine-readable error code. Branch on this, never
                      on `message`.
                  origin:
                    type: string
                    enum:
                      - BANKING
                    description: Service that produced the error.
                  message:
                    type: string
                    description: >-
                      Human-readable explanation. Its wording may change without
                      notice.
                required:
                  - traceId
                  - code
                  - origin
                  - message
              example:
                traceId: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                code: ACCOUNT_NOT_FOUND
                origin: BANKING
                message: Account not found
        '409':
          description: >-
            `TRANSFER_REQUEST_NOT_CONFIRMABLE` — The request was already
            confirmed, cancelled or failed, or is being confirmed at this
            moment.


            `TRANSFER_REQUEST_EXPIRED` — The approval deadline passed; the
            request is now `EXPIRED`.


            `MOVE_BALANCE_IN_PROGRESS` — The policy's top-up of the wallet is
            still running. Retry shortly.


            `MOVE_BALANCE_PARAMETERS_CHANGED` — Cancel the request and create
            another.
          content:
            application/json:
              schema:
                type: object
                properties:
                  traceId:
                    type: string
                    description: >-
                      Identifier of the request that failed. Quote it when
                      contacting support.
                    example: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                  code:
                    type: string
                    enum:
                      - TRANSFER_REQUEST_NOT_CONFIRMABLE
                      - TRANSFER_REQUEST_EXPIRED
                      - MOVE_BALANCE_IN_PROGRESS
                      - MOVE_BALANCE_PARAMETERS_CHANGED
                    description: >-
                      Stable, machine-readable error code. Branch on this, never
                      on `message`.
                  origin:
                    type: string
                    enum:
                      - BANKING
                    description: Service that produced the error.
                  message:
                    type: string
                    description: >-
                      Human-readable explanation. Its wording may change without
                      notice.
                required:
                  - traceId
                  - code
                  - origin
                  - message
              example:
                traceId: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                code: TRANSFER_REQUEST_NOT_CONFIRMABLE
                origin: BANKING
                message: Transfer request is not in a confirmable state
        '422':
          description: >-
            `BAD_REQUEST` — A path parameter is not a valid ID; `fields` lists
            each one.


            `CUSTOM_FIELD_IS_REQUIRED` — A required transaction custom field has
            no value; `fields` names it.


            `INSUFFICIENT_FUNDS` — The paying wallet's balance doesn't cover the
            amount. The request is now `FAILED`.


            `ACCOUNT_BLOCKED` — One of the wallets can't move money at the bank.
            The request is now `FAILED`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  traceId:
                    type: string
                    description: >-
                      Identifier of the request that failed. Quote it when
                      contacting support.
                    example: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                  code:
                    type: string
                    enum:
                      - BAD_REQUEST
                      - CUSTOM_FIELD_IS_REQUIRED
                      - INSUFFICIENT_FUNDS
                      - ACCOUNT_BLOCKED
                    description: >-
                      Stable, machine-readable error code. Branch on this, never
                      on `message`.
                  origin:
                    type: string
                    enum:
                      - BANKING
                    description: Service that produced the error.
                  message:
                    type: string
                    description: >-
                      Human-readable explanation. Its wording may change without
                      notice.
                  fields:
                    type: array
                    description: >-
                      One entry per invalid request field (validation errors
                      only).
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          description: >-
                            Path of the invalid field, e.g. `label` or
                            `values[0].value`.
                          example: label
                        message:
                          type: string
                          description: Why the field was rejected.
                          example: label is required
                        code:
                          type: string
                          description: >-
                            `<FIELD>_<REASON>` — e.g. `LABEL_REQUIRED`,
                            `TYPE_ONE_OF`, `VALUES_VALUE_TYPE_ERROR`.
                          example: LABEL_REQUIRED
                        values:
                          type: array
                          items:
                            type: string
                          description: >-
                            The accepted values, when the field is an
                            enumeration.
                      required:
                        - field
                        - message
                        - code
                required:
                  - traceId
                  - code
                  - origin
                  - message
              example:
                traceId: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                code: BAD_REQUEST
                origin: BANKING
                message: >-
                  Bad Request: Your request is invalid or incomplete. Please
                  make sure you are requesting with the right fields.
                fields:
                  - field: organizationId
                    message: Invalid UUID
                    code: ORGANIZATIONID_UUID
        '503':
          description: >-
            `POLICY_EVALUATION_UNAVAILABLE` — The business policies couldn't be
            evaluated, or their automatic approval didn't answer. The transfer
            wasn't made; retry later.


            `MOVE_BALANCE_FAILED` — The policy's top-up of the wallet failed, so
            the transfer wasn't made. Retry later; if it keeps failing, contact
            support with the `traceId`.


            `BANKING_PROVIDER_UNAVAILABLE` — The bank stopped answering during
            the transfer; the status is the bank's own (`500`, `502`, `503` or
            `504`). The request is now `FAILED` — check both wallets' balances
            before creating another, since the bank may have moved the money.
          content:
            application/json:
              schema:
                type: object
                properties:
                  traceId:
                    type: string
                    description: >-
                      Identifier of the request that failed. Quote it when
                      contacting support.
                    example: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                  code:
                    type: string
                    enum:
                      - POLICY_EVALUATION_UNAVAILABLE
                      - MOVE_BALANCE_FAILED
                      - BANKING_PROVIDER_UNAVAILABLE
                    description: >-
                      Stable, machine-readable error code. Branch on this, never
                      on `message`.
                  origin:
                    type: string
                    enum:
                      - BANKING
                    description: Service that produced the error.
                  message:
                    type: string
                    description: >-
                      Human-readable explanation. Its wording may change without
                      notice.
                required:
                  - traceId
                  - code
                  - origin
                  - message
              example:
                traceId: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                code: POLICY_EVALUATION_UNAVAILABLE
                origin: BANKING
                message: The policy evaluation service is unavailable — please retry

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.