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

# Enviar fondos mediante transferencia bancaria.

Envía fondos mediante transferencia bancaria utilizando la API de Localpayment. Esta guía abarca todo lo que necesitas saber sobre cómo crear pagos, gestionar las respuestas, administrar el estado de las transacciones y cumplir con los requisitos específicos de cada país.

Las transferencias bancarias te permiten enviar fondos directamente a las cuentas bancarias de los beneficiarios. Puedes iniciar estas transferencias a través de cualquiera de las siguientes opciones:

* **Portal comercial de Localpayment**: Interfaz fácil de usar para la [gestión manual de transacciones.](https://docs.localpayment.com/es/docs/internal-transfers)
* **Integración de API**: Acceso programático para el procesamiento automatizado de pagos.

Esta guía se centra en la implementación de la API, abarcando el flujo completo desde la inicialización hasta la finalización.

## Antes de comenzar

Asegúrate de tener:

* [Credenciales API válidas ](https://docs.localpayment.com/es/docs/api-keys-and-environments.md)(token de acceso).
* Información completa del beneficiario.
* [Configuración](https://docs.localpayment.com/es/docs/setup-guide.md) adecuada de la cuenta para el país de destino.
* Comprensión de los requisitos específicos de cada país (véase [Requisitos por país](#country-specific-requirements) a continuación).

***

## Paso 1: Inicializar la transacción de pago

Para crear un payout mediante transferencia bancaria, envía una solicitud `POST` al endpoint **[Create a Payout](https://docs.localpayment.com/es/reference/create-a-payout.md)** con `paymentMethod.type` establecido en `"BankTransfer"`.

### Endpoint

```
POST https://api.stage.localpayment.com/api/payout/
```

### Encabezados obligatorios

```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 objetos clave:

| Objeto | Descripción | Requerido |
| - | - | - |
| `beneficiary` | Datos del destinatario, incluyendo información bancaria. | ✅ |
| `sender` | Información del remitente para el cumplimiento | ✅ |
| `merchant` | Datos del comerciante/negocio | ✅ |
| `paymentMethod` | Configuración del método de pago | ✅ |
| `amount` | Importe de la transacción | ✅ |
| `currency` | Código de moneda de la transacción | ✅ |
| `country` | Código del país de destino | ✅ |

### 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/payout/ \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '[
 {
  "externalId": "212407f5-0c86-4687-91e4-df3ab8a513ab",
  "country": "ARG",
  "currency": "ARS",
  "amount": 500.18,
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "0010",
    "flow": "DIRECT"
  },
  "beneficiary": {
    "name": "John",
    "lastName": "Doe",
    "type": "INDIVIDUAL",
    "document": {
      "type": "CUIT",
      "id": "20907920276"
    },
    "userReference": "Test",
    "email": "john.doe@email.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "12345678"
    },
    "birthDate": "2021-11-08",
    "nationality": "Argentine",
    "address": {
      "street": "Avenida Principal",
      "number": "234",
      "city": "La Plata",
      "state": "Buenos Aires",
      "country": "Argentina",
      "zipCode": "C1420",
      "comment": "TEST"
    },
    "bank": {
      "name": "BANCO DE GALICIA Y BUENOS AIRES S.A.U.",
      "code": "007",
      "account": {
        "number": "0070145330004020870169",
        "type": "S"
      }
    }
  },
  "sender": {
    "type": "INDIVIDUAL",
    "name": "David",
    "lastName": "Doe",
    "document": {
      "type": "CUIT",
      "id": "20907920276"
    },
    "userReference": "Test",
    "email": "david.doe@email.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "12345678"
    },
    "birthDate": "2021-11-08",
    "nationality": "Argentine",
    "address": {
      "street": "Avenida Principal",
      "number": "234",
      "city": "La Plata",
      "state": "Buenos Aires",
      "country": "Argentina",
      "zipCode": "C1420",
      "comment": "TEST"
    }
  },
  "merchant": {
    "type": "COMPANY",
    "name": "Company Name",
    "document": {
      "type": "CUIT",
      "id": "20907920276"
    },
    "userReference": "Test",
    "email": "company@email.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "11",
      "number": "12345678"
    },
    "birthDate": "2021-11-08",
    "nationality": "Argentine",
    "address": {
      "street": "Avenida Principal",
      "number": "234",
      "city": "La Plata",
      "state": "Buenos Aires",
      "country": "Argentina",
      "zipCode": "C1420",
      "comment": "TEST"
    }
  },
  "accountNumber": "{{accountNumber}}",
  "conceptCode": "0039",
  "comment": "ARG TEST",
  "requireAuth": true
}
]'
```

***

## Paso 2: Gestionar la respuesta

### Respuesta exitosa

Una respuesta exitosa incluye información detallada de la transacción e identificadores de seguimiento:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
    "externalId": "212407f5-0c86-4687-91e4-df3ab8a513ab",
    "internalId": "095a5d8d-53ff-4a8d-9665-7ceb6eaa94df",
    "paymentMethod": {
        "code": "0010",
        "name": "INTERBANKING",
        "description": "string",
        "paymentMethodType": "BankTransfer"
    },
    "country": "ARG",
    "currency": "ARS",
    "amount": 500.18,
    "accountNumber": "{{accountNumber}}",
    "clientCode": "0001",
    "clientName": "Acme",
    "status": {
        "code": "104",
        "description": "PendingAuth",
        "detail": "The payout is pending of authorization by client"
    },
    "beneficiary": {
        "bank": {
            "name": "BANCO DE GALICIA Y BUENOS AIRES S.A.U.",
            "code": "007",
            "countryISOCode3": null,
            "branch": null,
            "account": {
                "number": "0070145330004020870169",
                "type": "S",
                "alias": null,
                "pixKey": null,
                "phone": null
            }
        },
        "type": "INDIVIDUAL",
        "name": "John",
        "lastname": "Doe",
        "document": {
            "type": "CUIT",
            "id": "20907920276"
        },
        "userReference": "Test",
        "email": "john.doe@email.com",
        "phone": {
            "countryCode": "54",
            "areaCode": "11",
            "number": "12345678"
        },
        "birthdate": "2021-11-08T00:00:00Z",
        "nationality": "Argentine",
        "address": {
            "street": "Avenida Principal",
            "number": "234",
            "city": "La Plata",
            "state": "Buenos Aires",
            "country": "Argentina",
            "zipCode": "C1420",
            "comment": "TEST"
        }
    },
    "merchant": {
        "type": "COMPANY",
        "name": "Company Name",
        "lastname": null,
        "document": {
            "type": "CUIT",
            "id": "20907920276"
        },
        "userReference": "Test",
        "email": "company@email.com",
        "phone": {
            "countryCode": "54",
            "areaCode": "11",
            "number": "12345678"
        },
        "birthdate": "2021-11-08T00:00:00Z",
        "nationality": "Argentine",
        "address": {
            "street": "Avenida Principal",
            "number": "234",
            "city": "La Plata",
            "state": "Buenos Aires",
            "country": "Argentina",
            "zipCode": "C1420",
            "comment": "TEST"
        }
    },
    "sender": {
        "type": "INDIVIDUAL",
        "name": "David",
        "lastname": "Doe",
        "document": {
            "type": "CUIT",
            "id": "20907920276"
        },
        "userReference": "Test",
        "email": "david.doe@email.com",
        "phone": {
            "countryCode": "54",
            "areaCode": "11",
            "number": "12345678"
        },
        "birthdate": "2021-11-08T00:00:00Z",
        "nationality": "Argentine",
        "address": {
            "street": "Avenida Principal",
            "number": "234",
            "city": "La Plata",
            "state": "Buenos Aires",
            "country": "Argentina",
            "zipCode": "C1420",
            "comment": "TEST"
        }
    },
    "comment": "ARG TEST",
    "exchangeRateToken": null,
    "date": {
        "creationDate": "2025-10-10T21:04:44.2729228Z",
        "processedDate": "2025-10-10T21:04:44.2731812Z"
    },
    "errors": null,
    "internalLoteID": "151840"
}
```

### Campos de respuesta clave

| Campo | Descripción | Caso de uso |
| - | - | - |
| `internalId` | Identificador único de transacción de Localpayment | Seguimiento y soporte de transacciones |
| `externalId` | Tu número de referencia | Reconciliación interna |
| `status.code` | Código de estado de transacción actual | Monitoreo de estado |
| `date.creationDate` | Cuando se creó la transacción | Registro de auditoría |
| `date.processedDate` | Cuando comenzó el procesamiento de la transacción | Cálculo del tiempo de procesamiento |

### Respuesta de error

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

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
[
  {
    "externalId": "1736488884",
    "internalId": "cd052d8c-8406-45f8-98aa-aff9876c3285",
    "status": {
      "code": "801",
      "description": "Rejected",
      "detail": "Params error"
    },
    "errors": [
      {
        "code": "300",
        "description": "Invalid param + [paymentMethod.code] + doesn't exist for PAYMENT_METHOD_TYPE BankTransf"
      },
      {
        "code": "300",
        "description": "Invalid param + [beneficiary.document.id] + doesn´t match regex ^(20|23|24|25|26|27|30|33|34)-?\\d{2}[.]?\\d{3}[.]?\\d{3}-?\\d$"
      }
    ],
    "comment": "Addicional informetion"
  }
]
```

***

## Paso 3: Seguimiento del estado de la transacción

Después de realizar un pago, 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

| Código | Estado | Descripción |
| :- | :- | :- |
| `100` | `Received` | Se recibió el pago. |
| `101` | `Locked` | El pago ha sido confirmado y ha superado las validaciones contra el blanqueo de capitales. |
| `102` | En curso | El pago ha sido enviado al banco. |
| `104` | `PendingAuth` | El pago está pendiente de autorización por parte del cliente. |
| `200` | `Completed` | El pago fue debitado. |
| `300` | `Rejected` | Parámetro no válido + \[nombre del parámetro] + \[motivo]. |

> [!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).

***

## Paso 4: Aprobación de la transacción

Para mayor seguridad, ciertas transacciones requieren la [aprobación de dos personas](https://docs.localpayment.com/es/docs/approvals-and-double-signature.md):

1. **Iniciador**: Envía la solicitud de pago.
2. **Aprobador**: Revisa y confirma la transacción.

Este proceso se puede gestionar a través del [Business Portal](https://docs.localpayment.com/es/docs/dashboard-review-payout.md) o de los [endpoints de la API](https://docs.localpayment.com/es/reference/authorize-payout.md).

> [!NOTE]
>
> **Nota de seguridad**
>
> Los requisitos de aprobación ayudan a prevenir transacciones no autorizadas y a garantizar el cumplimiento de las normativas locales.

***

## Requisitos específicos de cada país

Los detalles de implementación varían según el país. Cualquier país no mencionado explícitamente se rige por el procedimiento estándar sin requisitos especiales. Revisa estos requisitos antes de la integración:

> [tab] Brasil
>
> **Requisitos especiales:**
>
> * `beneficiary.bank.branch` es **obligatorio** cuando envías el payout con un número de cuenta (`beneficiary.bank.account.number`). Esto se aplica tanto a las transferencias TED como a las Pix realizadas a una cuenta. Si lo omites, el payout se rechaza con el error 300 (`beneficiary.bank.branch` must not be null) y el error 701 (Invalid bank branch code).
>   * `code`: **Obligatorio.** El código de la sucursal en el formato exigido por el banco.
>   * `name`: **Opcional.** El nombre completo de la sucursal bancaria.
> * Cuando envías el payout con una clave Pix (`beneficiary.bank.account.alias`), `beneficiary.bank.branch` es opcional.
> * `merchant.address` es **obligatorio** y debe incluir `country`.
>   * `country`: **Obligatorio.** El código de país ISO de 3 letras de la dirección del comercio (por ejemplo, `BRA`).
>   * Los demás campos de `merchant.address` son opcionales.
>
> **Envío de fondos con Chave Pix:**
>
> Como alternativa a los datos bancarios tradicionales, puedes enviar fondos usando una clave Pix. Pix es el sistema de pagos instantáneos de Brasil, que permite realizar transferencias las 24 horas del día, los 7 días de la semana, incluidos fines de semana y días festivos.
>
> Para utilizar este método:
>
> 1. El destinatario debe tener una clave Pix registrada.
> 2. Debes proporcionar esta clave en la propiedad `beneficiary.bank.account.alias`.
>
>    **Nota:** Las propiedades beneficiary.bank.account.type y beneficiary.bank.account.number deben excluirse de la solicitud.
>
> **Tipos de claves Pix compatibles:**
>
> Puedes utilizar cualquiera de los siguientes cinco tipos de clave:
>
> * CPF (Registro Individual de Contribuyentes)
> * CNPJ (Registro Nacional de Personas Jurídicas)
> * Número de teléfono celular
> * Dirección de correo electrónico
> * Clave aleatoria: Un código único de 32 caracteres generado por el Banco Central. Esta opción permite a los beneficiarios recibir pagos sin compartir información personal.

> [tab] Chile
>
> **Requisitos especiales:**
>
> * Cuando la moneda se establece en **CLP**, el importe debe especificarse como un valor entero. No se permiten decimales.

> [tab] Colombia
>
> Los bancos disponibles dependen del método de pago elegido. Colombia admite tres vías de pago: ACH (`0060`), Transfiya (`0061`) y Bre-B (`0062`).
>
> **Transfiya (`0061`)**
>
> > [!NOTE]
> >
> > Transfiya identifica a los beneficiarios por su **número de teléfono móvil**. Esto es distinto de ACH (`0060`), que requiere un número de cuenta bancaria y un código de banco.
>
> Transfiya gestiona los pagos utilizando el número de teléfono móvil registrado del beneficiario. Una vez iniciada la transacción, el beneficiario recibe una notificación por SMS y puede aceptarla o rechazarla desde su aplicación bancaria.
>
> | Campo | Valor |
> | - | - |
> | `beneficiary.bank.account.type` | `"P"` |
> | `beneficiary.bank.account.number` | Cadena de 12 dígitos que comienza con `+573` |
>
> **Instituciones apoyadas:**
>
> * BANCO AGRARIO DE COLOMBIA
> * BANCO COOPERATIVO COOPCENTRAL DIGITAL
> * BANCO CREZCAMOS
> * BANCO DE LAS MICROFINANZAS BANCAMIA SA
> * BANCO FALABELLA
> * BANCO FINANDINA
> * BANCO ITAÚ
> * BANCO POWWI
> * BANCO SERFINANZA
> * BANCOCOOPCENTRAL
> * BANCOLOMBIA
> * CFA COOPERATIVA FINANCIERA
> * CONFIAR COOPERATIVA FINANCIERA
> * DAVIVIENDA
> * MOVII
> * NEQUI
>
> **Actualmente no es compatible:**
>
> * Banco AV Villas (servicio intermitente)
> * Banco de Bogotá
> * Banco de Occidente SA
> * Dale
> * Davibank
>
> ***
>
> **Bre-B (`0062`)**
>
> Bre-B es el sistema de pagos instantáneos de Colombia para transferencias en tiempo real entre instituciones financieras. Utiliza identificadores sencillos, como números de teléfono o números de identificación, en lugar de los datos completos de la cuenta bancaria.
>
> Antes de comenzar, consulta la [lista de bancos disponibles](https://docs.localpayment.com/es/docs/colombia.md) para verificar qué instituciones admiten Bre-B.
>
> Para utilizar este método:
>
> 1. El destinatario debe tener una llave Bre-B registrada en su banco.
>
> 2. Proporciona la clave en `beneficiary.bank.account.alias`.
>
> > [!NOTE]
> >
> > Al usar Bre-B, excluye `beneficiary.bank.account.type` y `beneficiary.bank.account.number` de la solicitud.
>
> Tipos de claves Bre-B compatibles:
>
> * **Documento de identidad** — documento nacional de identidad, tarjeta de inmigración, tarjeta de ciudadanía o pasaporte
> * **Código de comerciante**
> * **Número de teléfono celular**
> * **Dirección de correo electrónico**
> * **Clave alfanumérica** — un código único generado por el banco (p. ej., `@alphamunKey01`) que permite recibir pagos sin compartir información personal
>
> Antes de enviar el pago, puedes comprobar opcionalmente si la clave Bre-B está activa y ver los detalles de su propietario enmascarado. Consulta [Verificar un alias de pago](https://docs.localpayment.com/es/docs/verify-a-payout-alias.md).

> [tab] República Dominicana
>
> **Requisitos especiales:**
>
> * El `beneficiary.bank.account.number` puede proporcionarse en formato nacional o IBAN. Ambos representan la misma cuenta subyacente.
>   * **Formato nacional:** El número de cuenta nacional estándar.
>     Ejemplo: 830640009
>   * **Formato IBAN:** El estándar internacional de 28 caracteres. Un IBAN dominicano comienza con "DO".
>     Ejemplo: DO42BPDO00000000000830640009

> [tab] México
>
> **Requisitos especiales:**
>
> * El `beneficiary.document.type` es opcional.
> * Especificaciones para pagos con número móvil:
>   * `beneficiary.bank.account.type`: Debe estar configurado en "P".
>   * `beneficiary.bank.account.number`: Debe ser un número de 10 dígitos.

> [tab] Perú
>
> **Requisitos especiales:**
>
> * Para validar un **CCI**, recomendamos utilizar el recurso oficial proporcionado por los bancos peruanos:
>   [https://www.transferenciasinterbancarias.pe/](https://www.transferenciasinterbancarias.pe/)

***

## Probando tu integración

### Entorno de pruebas

Utiliza el entorno de prueba para realizar las pruebas:

```
https://api.stage.localpayment.com/api/payout/
```

### Escenarios de prueba

Verifica que tu integración gestione estos escenarios:

1. **Transacción exitosa**: Flujo de pago estándar
2. **Errores de validación**: Cuenta bancaria no válida, campos faltantes
3. **Retrasos en el procesamiento**: Transacciones que requieren tiempo para procesarse.
4. **Transacciones fallidas**: Fondos insuficientes, beneficiarios bloqueados
5. **Actualizaciones de estado**: Gestión de webhooks y sondeo de estado

***

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