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

# Wire Out

Localpayment te permite retirar fondos de tu cuenta de Localpayment y depositarlos en tu propia cuenta bancaria externa mediante la integración de la API y la interfaz del Business Portal. Esta guía abarca el flujo de trabajo completo de transferencia bancaria para la liquidación de fondos, detallando el proceso de autorización, la implementación de la API y el seguimiento del estado.

> [!NOTE]
>
> **Wire Out vs. Payout**
>
> Un **Wire Out** es una **liquidación/retiro**: los fondos se transfieren de tu cuenta de Localpayment a **tu propia cuenta bancaria externa**, nunca a la de un tercero.
>
> Un **Payout** es un **desembolso a un destinatario final** (normalmente tu cliente). Si necesitas enviar fondos a un tercero, usa el endpoint [Crear Payout](https://docs.localpayment.com/es/reference/create-a-payout.md).

## Antes de comenzar

Asegúrate de tener:

> [card] [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md)
>
> Credenciales API válidas y token de acceso para la autenticación.

> [card] [Configuración de la cuenta](https://docs.localpayment.com/es/docs/make-your-first-test-payment.md)
>
> Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

> [card] [Lista blanca de IP](https://docs.localpayment.com/es/docs/dashboard-whitelist-your-ips.md)
>
> Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

> [card] [Endpoint del webhook](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura una URL de webhook para recibir notificaciones de pago.

### Requisitos adicionales para Wire Outs:

* **Saldo disponible** suficiente en tu cuenta de Localpayment. Consúltalo en el [Informe de balance](https://docs.localpayment.com/es/docs/balance-report.md) o estima los fondos próximos con el [Informe de saldo proyectado](https://docs.localpayment.com/es/docs/projected-balance-report.md).
* Rol de usuario con **permisos suficientes** para la autorización de Wire Out (consulta la documentación sobre roles y permisos).
* **Datos de la cuenta bancaria externa** (código SWIFT, número de cuenta, información del beneficiario).

***

## Guía de implementación

Localpayment ofrece dos métodos para procesar transferencias bancarias: integración mediante API para el procesamiento automatizado y Business Portal para operaciones manuales.

> [card] [Procesamiento de Wire Out a través de API](#process-wire-out-via-api)
>
> Inicia Wire Out de forma programática mediante la API REST para flujos de
> liquidación automatizados e integración de sistemas.

> [card] [Procesamiento de transferencias bancarias del Business Portal](https://docs.localpayment.com/es/docs/dashboard-wire-out.md)
>
> Procesa manualmente las instrucciones de Wire Out a través del Business Portal de Localpayment
> con una interfaz visual y orientación paso a paso.

***

## Paso 1: Procesar Wire Out a través del API

Para iniciar una transacción de Wire Out a través de la API, envía una solicitud `POST` al endpoint de [Wire Out](https://docs.localpayment.com/es/reference/wire-out.md).

### Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

| Parámetro | Descripción | Requerido |
| - | - | - |
| `transactionType` | Debe estar configurado en "WireOut". | ✅ |
| `externalId` | Tu ID de referencia único para la transacción | ✅ |
| `country` | Código de país en formato ISO donde se procesará el pago. | ✅ |
| `currency` | Moneda correspondiente al importe de la transacción. | ✅ |
| `amount` | Importe que se debitará de tu cuenta | ✅ |
| `accountNumber` | Tu número de cuenta de Localpayment | ✅ |
| `to` | Objeto de la cuenta bancaria de destino. **El beneficiario debe ser tú**, el mismo titular de la cuenta de origen, no un tercero. | ✅ |
| `to.name` | Nombre del banco de destino | ✅ |
| `to.swift` | Código SWIFT/BIC del banco de destino | ✅ |
| `to.address` | Dirección del banco de destino | ✅ |
| `to.accountName` | Nombre del titular de la cuenta en el banco de destino. | ✅ |
| `to.accountNumber` | Número de cuenta en el banco de destino. | ✅ |
| `to.routingNumber` | Número de ruta / código de clasificación (varía según el país, por ejemplo, transferencias a EE. UU.) | ❌ |
| `to.beneficiaryAddress` | Tu dirección como beneficiario en el banco de destino. | ✅ |
| `comment` | Nota opcional sobre la transacción | ❌ |

### Ejemplo de solicitud

> [tab] Estándar (fiat)
>
> ```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>   --url https://api.stage.localpayment.com/api/account/wire-out \
>   --header 'Authorization: Bearer <your_access_token>' \
>   --header 'accept: application/json' \
>   --header 'content-type: application/json' \
>   --data '{
>     "transactionType": "WireOut",
>     "externalId": "c048aaea-5916-4dfe-add9-e3a720c42a08",
>     "country": "ARG",
>     "currency": "ARS",
>     "amount": 1000,
>     "accountNumber": "{{accountNumber}}",
>     "to": {
>       "name": "BBVA Arg.",
>       "swift": "BCSARG",
>       "address": "Centro 123",
>       "accountName": "John Doe",
>       "accountNumber": "3220001805117354710015",
>       "beneficiaryAddress": "Av. Corrientes 1234"
>     },
>     "comment": "Settlement"
>   }'
> ```

> [tab] Moneda estable (USDC / USDT)
>
> ```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>   --url https://api.stage.localpayment.com/api/account/wire-out \
>   --header 'Authorization: Bearer <your_access_token>' \
>   --header 'accept: application/json' \
>   --header 'content-type: application/json' \
>   --data '{
>     "transactionType": "WireOut",
>     "externalId": "a3f7c912-4e85-4b2d-9c0f-6d1e8a2b5f47",
>     "country": "GLO",
>     "currency": "USDC",
>     "amount": 100,
>     "accountNumber": "{{accountNumber}}",
>     "to": {
>       "name": "Banco Galicia",
>       "swift": "GALVARAR",
>       "address": "123 Blockchain Ave",
>       "accountName": "Jane Doe",
>       "accountNumber": "{{walletAddress}}",
>       "routingNumber": "routingNumber",
>       "beneficiaryAddress": "123 Blockchain Ave"
>     },
>     "comment": "Stablecoin settlement"
>   }'
> ```
>
> > [!NOTE]
> >
> > Para transferencias de stablecoins, configura `currency` como `"USDC"` o `"USDT"`. Para `country`, usa `"GLO"` o el código de país ISO alfa-3 que corresponda a la billetera de destino. El campo `to.accountNumber` debe contener la dirección de la billetera de destino.

Consulta todos los [parámetros disponibles](https://docs.localpayment.com/es/reference/wire-out.md) en la solicitud.

***

## Paso 2: Gestionar la respuesta

### Respuesta exitosa

Un Wire Out iniciado con éxito devuelve los detalles de la transacción con el estado inicial:

> [tab] Estándar (fiat)
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>     "transactionType": "WireOut",
>     "externalId": "c048aaea-5916-4dfe-add9-e3a720c42a08",
>     "internalId": "c0e5ec40-b5b6-49aa-8c2d-b1ba01080100",
>     "country": "ARG",
>     "currency": "ARS",
>     "clientCode": "0001",
>     "creationDate": "2025-09-29T18:41:49.940+00:00",
>     "errors": [],
>     "status": {
>         "code": "100",
>         "description": "RECEIVED",
>         "detail": "WIRE OUT"
>     },
>     "accountNumber": "{{accountNumber}}",
>     "amount": 1000.0,
>     "fees": {
>         "description": "Fee",
>         "currency": "ARS",
>         "amount": 30.0,
>         "account": "{{accountNumber}}"
>     },
>     "localTaxes": [],
>     "withHoldings": [],
>     "comment": "Settlement"
> }
> ```

> [tab] Moneda estable (USDC / USDT)
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>     "internalId": "53f2fcb7-0cf0-40f4-8416-2d00e91786a1",
>     "externalId": "a3f7c912-4e85-4b2d-9c0f-6d1e8a2b5f47",
>     "clientCode": "0001",
>     "country": "GLO",
>     "errors": [],
>     "accountNumber": "{{accountNumber}}",
>     "code": "102",
>     "comment": "Stablecoin settlement",
>     "creationDate": "2026-01-15T15:18:43.121+00:00",
>     "localTaxes": [],
>     "status": {
>         "code": "102",
>         "description": "Received",
>         "detail": "Authorized"
>     },
>     "transactionType": "WireOut",
>     "currency": "USDC",
>     "fees": {
>         "account": "{{accountNumber}}",
>         "amount": 0,
>         "currency": "USDC",
>         "description": "Fee"
>     },
>     "withHoldings": [],
>     "amount": 100,
>     "transactionFlow": "wireInAutomatic"
> }
> ```

### Campos de respuesta clave

| Parámetro | Descripción | Caso de uso |
| - | - | - |
| `externalId` | Tu referencia para la transacción original. | Conciliación y seguimiento. |
| `internalId` | Identificador único de reembolso de Localpayment. | Fines de apoyo y auditoría. |
| `status.code` | Código de estado de la transacción actual. | Monitoreo del estado. |
| `creationDate` | Cuando se creó la transacción. | Registro de auditoría e informes. |

### Respuesta de error

Cuando falla una solicitud de Wire Out, recibirás información detallada sobre el error:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
    "status": {
        "code": "300",
        "description": "REJECTED",
        "detail": "[to.address must not be empty]"
    },
    "timestamp": "2025-09-29 18:52:05.640378596",
    "errors": [
        {
            "code": "300",
            "detail": "to.address must not be empty"
        }
    ]
}
```

***

## Paso 3: Seguimiento del estado de un Wire Out

Tras iniciar un Wire Out, supervisa su progreso mediante estos métodos:

> [card] [Webhooks (recomendado)](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

> [card] [Endpoint de la API de estado](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

> [card] [Vista del Business Portal](https://docs.localpayment.com/es/docs/dashboard-overview.md)
>
> Interfaz visual para el seguimiento de transacciones. Ideal para la supervisión manual y el análisis detallado de las transacciones.

### Códigos de estado comunes para Wire Outs

| Código | Estado | Descripción |
| - | - | - |
| `100` | `PendingAuth` | Transacción creada, pendiente de autorización. |
| `101` | `PendingDebit` | Transacción en proceso tras la validación de Localpayment. |
| `102` | `Received` | Transacción autorizada |
| `200` | `Completed` | Los fondos se transfirieron correctamente al banco de destino. |
| `404` | `Rejected` | El código del proveedor no coincide con el número de cuenta. |
| `511` | `Rejected` | Cantidad cero especificada en la solicitud |
| `716` | `Rejected` | Rechazado por el administrador durante la autorización. |
| `717` | `RejectedByBank` | Transacción rechazada por el banco de destino. |

> [!NOTE]
>
> **Notificaciones de finalización**
>
> Recibirás notificaciones por correo electrónico cuando las transacciones alcancen los estados `Completed` o `Rejected`, independientemente de si se iniciaron a través de la API o del Business Portal. Para las transacciones de Wire Out con criptomonedas (USDC/USDT), la devolución de llamada del webhook `Completed` también incluye el hash de la transacción de la cadena de bloques (campo `hash`) para que puedas verificar el pago de forma independiente en un explorador de bloques. Este campo no se aplica al Wire Out fiduciario; consulta [Webhooks](https://docs.localpayment.com/es/docs/webhooks.md) para ver un ejemplo completo de la carga útil.

***

## Procesamiento de transferencias bancarias del Business Portal

Las transacciones de transferencia bancaria también se pueden procesar a través de la interfaz del portal comercial de Localpayment. Este método proporciona un flujo de trabajo visual para gestionar las transferencias de fondos y es particularmente útil para:

* Liquidaciones únicas\*\* que no requieren automatización mediante API.
* Supervisión administrativa\*\* con flujos de trabajo de autorización visual.
* **Transferencias rápidas de fondos** sin recursos para el desarrollo.

Para obtener instrucciones detalladas sobre cómo procesar transacciones de transferencia bancaria a través del Business Portal, incluyendo guías paso a paso y tutoriales de la interfaz, consulta la [Guía de Transferencia Bancaria del Business Portal](https://docs.localpayment.com/es/docs/dashboard-wire-out.md).

***

## Probando tu integración

### Escenarios de prueba

Verifica que tu integración gestione estos escenarios:

1. **Wire Out exitosa**: Procesar la transferencia con parámetros válidos y saldo suficiente.
2. **Fondos insuficientes**: Se intentó realizar una transferencia que excedía el saldo de la cuenta.
3. **Datos bancarios no válidos**: Prueba con códigos SWIFT o números de cuenta incorrectos.
4. **Flujo de trabajo de autorización**: Verificar el estado de la autorización pendiente y el proceso de aprobación.

***

## Próximos pasos

> [card] [Ver estado de la transacción](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Verifica el estado actual de las transacciones de transferencia bancaria utilizando la API de
> estado de transacciones.

> [card] [Configurar webhooks](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura webhooks para recibir notificaciones en tiempo real sobre los cambios de estado de Wire Out.


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