> ## 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.

# Crear Wire Out

Inicia un **Wire Out** para transferir fondos desde tu cuenta de Localpayment a tu propia cuenta bancaria externa.

> 📌 **Wire Out vs. Payout**
>
> * Un **Wire Out** es una **liquidación / retiro**: los fondos se mueven desde tu cuenta de Localpayment a **tu propia cuenta bancaria externa**. El beneficiario definido en el objeto `to` **debe ser tú**, el mismo titular de la cuenta de origen, nunca un tercero.
> * Un **Payout** es un **desembolso a un destinatario final** (normalmente tu cliente). Si necesitas enviar fondos a un tercero, utiliza en su lugar el endpoint [Crear Payout](https://docs.localpayment.com/es/reference/create-a-payout.md).

Para iniciar un Wire Out, proporciona lo siguiente:

* **Datos bancarios de destino (tu propia cuenta bancaria externa):** `name` del banco, `swift`, `address` del banco, `accountName`, `accountNumber` y `beneficiaryAddress`. El titular de la cuenta **debe coincidir contigo** como propietario de la cuenta de origen.
* **Cuenta de Localpayment de origen:** el `accountNumber` de la cuenta de Localpayment desde la cual se debitarán los fondos.
* **Detalles de la transferencia:** `amount`, `currency`, `country`, `transactionType` establecido en `"WireOut"`, tu `externalId` y un `comment` opcional.

Si la operación es exitosa, Localpayment devuelve un `internalId` que puedes utilizar para dar seguimiento a la transferencia bancaria. Puedes monitorear su estado desde `RECEIVED` hasta `Completed` (fondos acreditados en tu cuenta bancaria de destino) o `Rejected`.


## OpenAPI

````yaml openapi/es/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: Crear Wire Out
      operationId: wire-out
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                to:
                  type: object
                  description: >-
                    Cuenta bancaria de destino para el Wire Out. **El
                    beneficiario debe ser tú**, el mismo titular de la cuenta de
                    origen. Wire Out es una liquidación a tu propia cuenta
                    bancaria externa, no un payout a un tercero. Utiliza [Crear
                    Payout](/es/reference/create-payout) si el destinatario es
                    tu cliente.
                  properties:
                    name:
                      type: string
                      description: >-
                        Nombre del banco de destino donde mantiene la cuenta
                        externa.
                    swift:
                      type: string
                      description: Código SWIFT/BIC del banco de destino.
                    address:
                      type: string
                      description: Dirección del banco de destino.
                    accountName:
                      type: string
                      description: Nombre del titular de la cuenta en el banco de destino.
                    accountNumber:
                      type: string
                      description: >-
                        Número de cuenta en el banco de destino donde se
                        acreditarán los fondos. Para wire outs con stablecoins
                        (USDC / USDT), ingresa la dirección de la billetera de
                        destino.
                    routingNumber:
                      type: string
                      description: >-
                        Número de ruta (o sort code) del banco de destino.
                        Opcional y puede variar según el país.
                    beneficiaryAddress:
                      type: string
                      description: Tu dirección como beneficiario en el banco de destino.
                  required:
                    - name
                    - swift
                    - address
                    - accountName
                    - accountNumber
                    - beneficiaryAddress
                amount:
                  type: number
                  description: Importe de la transacción.
                comment:
                  type: string
                  description: Un comentario o nota asociada a la transacción.
                country:
                  type: string
                  description: >-
                    [País del documento](/es/reference/country-codes). ISO
                    3166-1 alfa-3. Para Wire Outs de stablecoins (USDC / USDT),
                    utiliza `GLO` o el código de país ISO alfa-3 que corresponde
                    a la billetera de destino.
                currency:
                  type: string
                  description: >-
                    [Códigos de moneda](/es/reference/currency-codes). Se
                    admiten las stablecoins **USDC** y **USDT**.
                externalId:
                  type: string
                  description: >-
                    Un identificador único generado por tu sistema para rastrear
                    la transacción (alfanumérico y con guiones). Recomendamos
                    usar UUID4 para garantizar su unicidad.
                accountNumber:
                  type: string
                  description: Número de cuenta de Localpayment.
                transactionType:
                  type: string
                  description: Tipo de transacción que se está procesando.
              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: El tipo de transacción que se está procesando.
                  externalId:
                    type: string
                    description: >-
                      Un identificador único generado por tu sistema para
                      rastrear la transacción (alfanumérico y con guiones).
                      Recomendamos usar UUID4 para garantizar su unicidad.
                  internalId:
                    type: string
                    description: Identificador de transacción de 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 del documento](/es/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 moneda](/es/reference/currency-codes).'
                  clientCode:
                    type: string
                    description: >-
                      Un identificador único asignado al cliente dentro del
                      sistema Localpayment.
                  creationDate:
                    type: string
                    description: >-
                      La fecha y hora en que se creó la transacción, en formato
                      ISO 8601.
                  errors:
                    type: array
                    description: >-
                      Un conjunto de objetos de error, en caso de que se haya
                      producido algún error durante la transacción.
                    items:
                      type: object
                  status:
                    type: object
                    title: status
                    description: Estado de la operación.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          estado](/es/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: >-
                          [Descripción del
                          estado](/es/reference/transaction-status-error-codes).
                      detail:
                        type: string
                        description: Información de estado adicional.
                  accountNumber:
                    type: string
                    description: Número de cuenta de Localpayment.
                  amount:
                    type: number
                    description: Importe de la transacción.
                  fees:
                    type: object
                    description: Detalles sobre las tarifas que se apliquen.
                    properties:
                      description:
                        type: string
                        description: Descripción de la comisión aplicada a la transacción.
                      currency:
                        type: string
                        description: '[Códigos de moneda](/es/reference/currency-codes).'
                      amount:
                        type: number
                        description: Importe de la transacción.
                      account:
                        type: string
                        description: El número de cuenta al que se aplica la comisión.
                  localTaxes:
                    type: array
                    description: Información sobre impuestos locales.
                    items:
                      type: object
                  withHoldings:
                    type: array
                    description: Información sobre retenciones.
                    items:
                      type: object
                  comment:
                    type: string
                    description: Un comentario o nota asociada a la transacción.
                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: Solicitud incorrecta.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    description: >-
                      Un conjunto de objetos de error, en caso de que se haya
                      producido algún error durante la transacción.
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Código de error.
                        detail:
                          type: string
                          description: Detalle del error.
                  status:
                    type: object
                    title: status
                    description: Estado de la operación.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          estado](/es/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: >-
                          [Descripción del
                          estado](/es/reference/transaction-status-error-codes).
                      detail:
                        type: string
                        description: Información de estado adicional.
                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: No autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                  code:
                    type: string
                    description: Código de estado.
                  messages:
                    type: array
                    description: Lista de mensajes.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase de token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensaje con información adicional.
                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.