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

# Notificación de Wire In

Notifica a Localpayment de una transferencia bancaria entrante mediante nuestra API para liquidar el saldo de tu cuenta. Esta guía te explica cómo iniciar una notificación, gestionar las respuestas de la API y hacer seguimiento del estado de la transacción.

Para transacciones en moneda fiduciaria (por ejemplo, USD, ARS, MXN), debes notificarnos la transferencia entrante. Esto puede hacerse a través de:

* **[Integración de API](https://docs.localpayment.com/es/reference/wire-in.md)**: Recomendada para notificaciones automatizadas y programáticas.
* **[Localpayment Business Portal](https://docs.localpayment.com/es/docs/dashboard-create-a-wire-in.md)**:  Usa la interfaz web para notificar manualmente transacciones individuales.

> [!WARNING]
>
> **Importante**
>
> El proceso de notificación de Wire In no se utiliza para **Stablecoins**. En su lugar, sigue el [flujo de Wire In para Stablecoins](https://docs.localpayment.com/es/docs/wire-in-overview).

Esta guía cubre el flujo de trabajo de la API de principio a fin, desde la notificación hasta la liquidación final.

***

## Antes de comenzar

Antes de notificar un Wire In, asegúrate de contar con:

* **Comprobante de la transferencia**: Prueba de la transferencia externa.
* **Credenciales de API válidas**: Con los permisos de autorización adecuados.
* **Detalles completos de la transacción**: Toda la información requerida de la transacción.

***

## Endpoint de la API

Para notificar una liquidación, envía una solicitud `POST ` al endpoint [Crear Wire In](https://docs.localpayment.com/reference/wire-in.md).

### Endpoint

```http theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
POST https://api.stage.localpayment.com/api/account/wire-in
```

### Autenticación

Incluye tu token de acceso en el encabezado Authorization:

```http theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
Authorization: Bearer <your_access_token>
```

### Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

| Parámetro | Tipo | Descripción | Requerido |
| - | - | - | - |
| `transactionType` | string | Debe establecerse en "WireIn" | ✅ |
| `currency` | string | Código de moneda (p. ej., "ARS", "USD") | ✅ |
| `country` | string | Código de país (p. ej., "ARG", "USA") | ✅ |
| `amount` | number | Cantidad de la transferencia | ✅ |
| `accountNumber` | string | Tu número de cuenta de Localpayment | ✅ |
| `to` | object | Datos bancarios del destinatario | ✅ |
| `from` | object | Datos bancarios del remitente | ✅ |

### Ejemplo de solicitud (Argentina)

```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-in \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 123' \
  --header 'Content-Type: multipart/form-data' \
  --form 'request={\"transactionType\":\"WireIn\",\"currency\":\"BOB\",\"country\":\"BOL\",\"amount\":100,\"comment\":\"Comment\",\"externalId\":\"a11h7890-78ju-098j-hu78-124ftn8lo0io\",\"accountNumber\":\"{{accountNumber}}\",\"to\":{\"name\":\"Bankname\",\"swift\":\"BCBHDOSD\",\"address\":\"BankAddress\",\"accountNumber\":\"1310825187\",\"accountName\":\"BeneficiaryBankName\",\"beneficiaryAddress\":\"BeneficiaryAddress\"},\"from\":{\"name\":\"OrderingBankName\",\"swift\":\"BICAARBS\",\"address\":\"OrderingBankAddress\",\"accountNumber\":\"123456789\",\"routingNumber\":null,\"accountName\":\"accountName\",\"beneficiaryAddress\":\"BeneficiaryAddress\",\"intermediaryBankName\":null,\"intermediaryBankSwift\":null,\"intermediaryAccountNumer\":null}}' \
  --form filecontent=@CO.png
```

***

## Gestión de respuestas

### Respuesta de éxito

Cuando tu solicitud de Wire In sea aceptada, recibirás una respuesta detallada:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
    "transactionType": "WireIn",
    "transactionFlow": "wireInAutomatic",
    "externalId": "a11h7890-78ju-098j-hu78-124ftn8lo0io",
    "internalId": "b97fe1cd-50d3-4ee2-8a6e-34ee6d7e4f4e",
    "country": "BOL",
    "currency": "BOB",
    "clientCode": "0001",
    "creationDate": "2025-12-04T21:07:41.689+00:00",
    "errors": [],
    "status": {
        "code": "101",
        "description": "PENDING_AUTH",
        "detail": "Pending Auth"
    },
    "accountNumber": "{{accountNumber}}",
    "amount": 97.32,
    "fees": {
        "description": "Fee",
        "currency": "BOB",
        "amount": 0.5,
        "account": "{{accountNumber}}"
    },
    "localTaxes": [
        {
            "code": "0016",
            "percentage": 2.18,
            "description": "FNA",
            "currency": "BOB",
            "fxSource": 6.911493,
            "fxQuote": 0.0,
            "amount": 2.18,
            "account": "{{accountNumber}}"
        }
    ],
    "withHoldings": [],
    "comment": "Comment",
    "code": "101"
}
```

#### Campos de respuesta clave

| Campo | Tipo | Descripción |
| - | - | - |
| `externalId` | string | Tu identificador único de transacción |
| `internalId` | string | ID interno de transacción de Localpayment |
| `creationDate` | string | Marca de tiempo de creación de la transacción (ISO 8601) |
| `amount` | number | Cantidad neta después de comisiones |
| `fees` | object | Comisiones de procesamiento aplicadas |
| `status` | object | Información del estado actual de la transacción |

### Respuesta de error

#### Ejemplo de error de validación

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "089c81c6-7be2-4798-8e53-d4bfff61f852",
  "errors": [
    {
      "code": "404",
      "detail": "This beneficiary account is invalid"
    }
  ],
  "status": {
    "code": "404", 
    "description": "REJECTED",
    "detail": "This beneficiary account is invalid"
  }
}
```

***

## Seguimiento del estado de la transacción

Después de enviar un Wire In, supervisa tu 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

| Código | Estado | Descripción |
| :- | :- | :- |
| `100` | `PendingCredit` | Crédito pendiente |
| `200` | `Completed` | Completado |
| `717` | `RejectedByBank` | Rechazado |

> [!NOTE]
>
> **Referencia completa**
>
> Consulta todos los códigos de estado en nuestra [documentación sobre el estado de las transacciones](https://docs.localpayment.com/es/reference/transaction-status-error-codes).

### Recomendaciones de seguridad

* Utiliza siempre HTTPS para las solicitudes a la API
* Almacena los tokens de acceso de forma segura (nunca en el código del lado del cliente)
* Implementa un manejo de errores y un registro adecuados
* Valida todos los datos de entrada antes de enviar las solicitudes

***

## Recursos y próximos pasos

Maximiza el éxito de tu integración con estos recursos esenciales.

> [card] [Integración de webhooks](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura notificaciones en tiempo real para las actualizaciones del estado de las transacciones.

> [card] [Portal de informes empresariales](https://docs.localpayment.com/es/docs/balance-report.md)
>
> Accede a análisis detallados, herramientas de generación de informes y funciones de conciliación.

> [card] [Monitoreo de transacciones](https://docs.localpayment.com/es/reference/transaction-status-error-codes)
>
> Aprende a consultar el estado de las transacciones e implementar un seguimiento exhaustivo.

> [card] [Referencia de la API](https://docs.localpayment.com/es/reference/exchange-bulk.md)
>
> Documentación completa del endpoint con ejemplos interactivos.

> [!NOTE]
>
> **Consejo profesional**
>
> Siempre prueba tu flujo de trabajo en nuestro entorno de pruebas antes de implementarlo en producción. Esto garantiza que el manejo de errores, el procesamiento de webhooks y el seguimiento del estado funcionen correctamente en todos los escenarios.

***

> [!NOTE]
>
> **¿Necesitas ayuda?**
>
> Ponte en contacto con nuestro [equipo de soporte](mailto:support@localpayment.com) si experimentas algún problema o necesitas ayuda con la integración.


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