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

# Criar Wire Out

Inicie um Wire Out para transferir fundos da sua conta Localpayment para a sua conta bancária externa.

> 📌 **Wire Out vs. Payout**
>
> * Um **Wire Out** é uma **liquidação / saque**: os fundos saem da sua conta Localpayment para a **sua própria conta bancária externa**. O beneficiário definido no objeto `to` **deve ser você**, o mesmo titular da conta de origem, nunca um terceiro.
> * Um **Payout** é um **desembolso para um destinatário final** (normalmente o seu cliente). Se você precisa enviar fundos a um terceiro, use o endpoint [Criar Payout](https://docs.localpayment.com/pt-br/reference/create-a-payout.md).

Para iniciar um Wire Out, informe:

* **Dados bancários de destino (sua própria conta bancária externa):** `name` do banco, `swift`, `address` do banco, `accountName`, `accountNumber` e `beneficiaryAddress`. O titular da conta **deve corresponder a você** como proprietário da conta de origem.
* **Conta Localpayment de origem:** o `accountNumber` da conta Localpayment da qual os fundos serão debitados.
* **Dados da transferência:** `amount`, `currency`, `country`, `transactionType` definido como `"WireOut"`, o seu `externalId` e um `comment` opcional.

Em caso de sucesso, a Localpayment retorna um `internalId` que você pode usar para acompanhar a transferência bancária. Você pode monitorar o status dela desde `RECEIVED` até `Completed` (fundos creditados na sua conta bancária de destino) ou `Rejected`.


## OpenAPI

````yaml openapi/pt-br/localpayment.json POST /api/account/wire-out
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/account/wire-out:
    post:
      summary: Criar Wire Out
      operationId: wire-out
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acesso Bearer para autenticação. Este token é obtido nos
            endpoints [Obter token de acesso](/pt-br/reference/get-token) ou
            [Renovar token de acesso](/pt-br/reference/refresh-token).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                to:
                  type: object
                  description: >-
                    Conta bancária de destino do Wire Out. **O beneficiário deve
                    ser você**, o mesmo titular da conta de origem. O Wire Out é
                    uma liquidação para a sua própria conta bancária externa,
                    não um payout para terceiros. Use [Create
                    Payout](/pt-br/reference/create-payout) se o destinatário
                    for seu cliente.
                  properties:
                    name:
                      type: string
                      description: >-
                        Nome do banco de destino onde você mantém a conta
                        externa.
                    swift:
                      type: string
                      description: Código SWIFT/BIC do banco de destino.
                    address:
                      type: string
                      description: Endereço do banco de destino.
                    accountName:
                      type: string
                      description: Nome do titular da conta no banco de destino.
                    accountNumber:
                      type: string
                      description: >-
                        Número da conta no banco de destino em que os fundos
                        serão creditados. Para transferências de saída em
                        stablecoin (USDC / USDT), informe o endereço da carteira
                        de destino.
                    routingNumber:
                      type: string
                      description: >-
                        Routing number (ou sort code) do banco de destino.
                        Opcional e pode variar conforme o país.
                    beneficiaryAddress:
                      type: string
                      description: Seu endereço como beneficiário no banco de destino.
                  required:
                    - name
                    - swift
                    - address
                    - accountName
                    - accountNumber
                    - beneficiaryAddress
                amount:
                  type: number
                  description: Valor da transação.
                comment:
                  type: string
                  description: Um comentário ou nota relacionada à transação.
                country:
                  type: string
                  description: >-
                    [País do documento](/pt-br/reference/country-codes). ISO
                    3166-1 alfa-3. Para transferências de stablecoins (USDC /
                    USDT), use `GLO` ou o código de país ISO alfa-3 que
                    corresponde à carteira de destino.
                currency:
                  type: string
                  description: >-
                    [Códigos de moeda](/pt-br/reference/currency-codes). As
                    stablecoins **USDC** e **USDT** são suportadas.
                externalId:
                  type: string
                  description: >-
                    Um identificador único gerado pelo seu sistema para rastrear
                    a transação (alfanumérico e com hífens). Recomendamos o uso
                    do UUID4 para garantir a unicidade.
                accountNumber:
                  type: string
                  description: Número da conta Localpayment.
                transactionType:
                  type: string
                  description: Tipo de transação que está sendo processada.
              required:
                - to
                - amount
                - country
                - currency
                - externalId
                - accountNumber
                - transactionType
              x-examples:
                Example 1:
                  to:
                    name: BBVA Arg.
                    swift: BCSARG
                    address: YourAccountNumber
                    accountName: YourAccountName
                    accountNumber: YourAccountNumber
                    routingNumber: routingNumber
                    beneficiaryAddress: beneficiaryAddress
                  amount: 1000
                  comment: WireOut_External
                  country: ARG
                  currency: ARS
                  externalId: '{{externalId}}'
                  accountNumber: '{{accountNumber}}'
                  transactionType: WireOut
                Stablecoin (USDC):
                  to:
                    name: Banco Galicia
                    swift: GALVARAR
                    address: 123 Blockchain Ave
                    accountName: Jane Doe
                    accountNumber: '{{walletAddress}}'
                    routingNumber: routingNumber
                    beneficiaryAddress: 123 Blockchain Ave
                  amount: 100
                  comment: Stablecoin settlement
                  country: GLO
                  currency: USDC
                  externalId: a3f7c912-4e85-4b2d-9c0f-6d1e8a2b5f47
                  accountNumber: '{{accountNumber}}'
                  transactionType: WireOut
            examples:
              Wire Out Example:
                value:
                  to:
                    name: BBVA Arg.
                    swift: BCSARG
                    address: YourAccountNumber
                    accountName: YourAccountName
                    accountNumber: YourAccountNumber
                    routingNumber: routingNumber
                    beneficiaryAddress: beneficiaryAddress
                  amount: 1000
                  comment: WireOut_External
                  country: ARG
                  currency: ARS
                  externalId: '{{externalId}}'
                  accountNumber: '{{accountNumber}}'
                  transactionType: WireOut
              Wire Out Stablecoin (USDC):
                value:
                  to:
                    name: Banco Galicia
                    swift: GALVARAR
                    address: 123 Blockchain Ave
                    accountName: Jane Doe
                    accountNumber: '{{walletAddress}}'
                    routingNumber: routingNumber
                    beneficiaryAddress: 123 Blockchain Ave
                  amount: 100
                  comment: Stablecoin settlement
                  country: GLO
                  currency: USDC
                  externalId: a3f7c912-4e85-4b2d-9c0f-6d1e8a2b5f47
                  accountNumber: '{{accountNumber}}'
                  transactionType: WireOut
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactionType:
                    type: string
                    description: O tipo de transação que está sendo processada.
                  externalId:
                    type: string
                    description: >-
                      Um identificador único gerado pelo seu sistema para
                      rastrear a transação (alfanumérico e com hífens).
                      Recomendamos o uso do UUID4 para garantir a unicidade.
                  internalId:
                    type: string
                    description: Identificador de transação da Localpayment.
                  country:
                    type: string
                    enum:
                      - ARG
                      - BOL
                      - BRA
                      - CHL
                      - COL
                      - CRI
                      - DOM
                      - ECU
                      - SLV
                      - GTM
                      - HND
                      - MEX
                      - PAN
                      - PRY
                      - PER
                      - URY
                      - GLO
                    description: >-
                      [País do documento](/pt-br/reference/country-codes). ISO
                      3166-1 alfa-3.
                  currency:
                    type: string
                    enum:
                      - ARS
                      - BOB
                      - BRL
                      - CLP
                      - COP
                      - CRC
                      - DOP
                      - USD
                      - GTQ
                      - MXN
                      - PYG
                      - PEN
                      - UYU
                      - USDC
                      - USDT
                    description: '[Códigos de moeda](/pt-br/reference/currency-codes).'
                  clientCode:
                    type: string
                    description: >-
                      Um identificador único atribuído ao cliente dentro do
                      sistema Localpayment.
                  creationDate:
                    type: string
                    description: >-
                      A data e a hora em que a transação foi criada, no formato
                      ISO 8601.
                  errors:
                    type: array
                    description: >-
                      Uma matriz de objetos de erro, caso tenha ocorrido algum
                      erro durante a transação.
                    items:
                      type: object
                  status:
                    type: object
                    title: status
                    description: Status da operação.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          status](/pt-br/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: >-
                          [Descrição do
                          status](/pt-br/reference/transaction-status-error-codes).
                      detail:
                        type: string
                        description: Informações adicionais sobre o status.
                  accountNumber:
                    type: string
                    description: Número da conta Localpayment.
                  amount:
                    type: number
                    description: Valor da transação.
                  fees:
                    type: object
                    description: Detalhes sobre quaisquer taxas cobradas.
                    properties:
                      description:
                        type: string
                        description: Descrição da taxa aplicada à transação.
                      currency:
                        type: string
                        description: '[Códigos de moeda](/pt-br/reference/currency-codes).'
                      amount:
                        type: number
                        description: Valor da transação.
                      account:
                        type: string
                        description: O número da conta à qual a taxa será aplicada.
                  localTaxes:
                    type: array
                    description: Informações sobre impostos locais.
                    items:
                      type: object
                  withHoldings:
                    type: array
                    description: Informações sobre retenções na fonte.
                    items:
                      type: object
                  comment:
                    type: string
                    description: Um comentário ou nota relacionada à transação.
                x-examples:
                  Example 1:
                    transactionType: WireOut
                    externalId: ''
                    internalId: c0e5ec40-b5b6-49aa-8c2d-b1ba01080100
                    country: ARG
                    currency: ARS
                    clientCode: '0001'
                    creationDate: '2024-02-29T18:41:49.940+00:00'
                    errors: []
                    status:
                      code: '100'
                      description: RECEIVED
                      detail: WIRE OUT
                    accountNumber: '{{accountNumber}}'
                    amount: 965
                    fees:
                      description: Fee
                      currency: ARS
                      amount: 35
                      account: '{{accountNumber}}'
                    localTaxes: []
                    withHoldings: []
                    comment: WireOut_External
                  Stablecoin (USDC):
                    transactionType: WireOut
                    externalId: a3f7c912-4e85-4b2d-9c0f-6d1e8a2b5f47
                    internalId: 53f2fcb7-0cf0-40f4-8416-2d00e91786a1
                    country: GLO
                    currency: USDC
                    clientCode: '0001'
                    creationDate: '2026-01-15T15:18:43.121+00:00'
                    errors: []
                    status:
                      code: '102'
                      description: Received
                      detail: Authorized
                    accountNumber: '{{accountNumber}}'
                    amount: 100
                    fees:
                      description: Fee
                      currency: USDC
                      amount: 0
                      account: '{{accountNumber}}'
                    localTaxes: []
                    withHoldings: []
                    comment: Stablecoin settlement
              examples:
                100 - Wire Out Example Response:
                  value:
                    transactionType: WireOut
                    externalId: 7532a2f4-f467-4baa-ba02-3c4b20a19f3e
                    internalId: c0e4ec40-b5b6-19aa-8c2d-b1ba05080100
                    country: ARG
                    currency: ARS
                    clientCode: '0001'
                    creationDate: '2024-12-29T18:41:49.940+00:00'
                    errors: []
                    status:
                      code: '100'
                      description: RECEIVED
                      detail: WIRE OUT
                    accountNumber: '{{accountNumber}}'
                    amount: 965
                    fees:
                      description: Fee
                      currency: ARS
                      amount: 35
                      account: '{{accountNumber}}'
                    localTaxes: []
                    withHoldings: []
                    comment: WireOut_External
                102 - Wire Out Stablecoin Response:
                  value:
                    transactionType: WireOut
                    externalId: a3f7c912-4e85-4b2d-9c0f-6d1e8a2b5f47
                    internalId: 53f2fcb7-0cf0-40f4-8416-2d00e91786a1
                    country: GLO
                    currency: USDC
                    clientCode: '0001'
                    creationDate: '2026-01-15T15:18:43.121+00:00'
                    errors: []
                    status:
                      code: '102'
                      description: Received
                      detail: Authorized
                    accountNumber: '{{accountNumber}}'
                    amount: 100
                    fees:
                      description: Fee
                      currency: USDC
                      amount: 0
                      account: '{{accountNumber}}'
                    localTaxes: []
                    withHoldings: []
                    comment: Stablecoin settlement
        '400':
          description: Solicitação inválida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    description: >-
                      Uma matriz de objetos de erro, caso tenha ocorrido algum
                      erro durante a transação.
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Código de erro.
                        detail:
                          type: string
                          description: Detalhe do erro.
                  status:
                    type: object
                    title: status
                    description: Status da operação.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          status](/pt-br/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: >-
                          [Descrição do
                          status](/pt-br/reference/transaction-status-error-codes).
                      detail:
                        type: string
                        description: Informações adicionais sobre o status.
                x-examples:
                  Example 1:
                    errors:
                      - code: '825'
                        detail: System error to generate transaction
                    status:
                      code: '825'
                      description: REJECTED
                      detail: System error to generate transaction
              examples:
                825 - System error to generate transaction.:
                  value:
                    errors:
                      - code: '825'
                        detail: System error to generate transaction
                    status:
                      code: '825'
                      description: REJECTED
                      detail: System error to generate transaction
        '401':
          description: Não autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Informações adicionais sobre a resposta.
                  code:
                    type: string
                    description: Código de status.
                  messages:
                    type: array
                    description: Lista de mensagens.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Classe Token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensagem com informações adicionais.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

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