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

# Transferencia interna nacional

Transferencias internas seguras entre tus cuentas de Localpayment. Mantén la liquidez y gestiona los fondos a nivel nacional sin conversión de moneda.

Una transferencia interna nacional te permite mover fondos de forma segura entre tus cuentas de Localpayment dentro del mismo país y la misma moneda. Esta funcionalidad es ideal para gestionar la liquidez entre varias cuentas o redistribuir fondos para lograr eficiencia operativa.

## Casos de uso

* **Reequilibrio de carteras:** Reasigna dinámicamente el capital entre las carteras de clientes para aprovechar con rapidez los movimientos del mercado y cumplir los mandatos de inversión estratégicos.
* **Gestión centralizada de la liquidez:** Consolida los saldos de diversas cuentas operativas para optimizar el capital de trabajo, garantizar pagos puntuales y maximizar el aprovechamiento de los fondos.
* **Distribución estructurada de fondos:** Automatiza el desembolso de presupuestos a departamentos, proyectos o centros de costos desde una cuenta central, manteniendo plena visibilidad y control.
* **Cumplimiento regulatorio y de riesgos:** Gestiona de forma proactiva las reservas de capital y los márgenes de riesgo segregando los fondos en cuentas de tipos designados para cumplir los requisitos regulatorios y las políticas internas.

***

## Requisitos previos

Antes de iniciar transferencias internas nacionales, asegúrate de contar con:

* **Fondos suficientes** en tu cuenta de origen
* **Credenciales de API válidas** con permisos para transferencias internas
* **Verificación de las cuentas** de origen y de destino
* **Registro en el mismo país** de ambas cuentas

> [!WARNING]
>
> **Importante**
>
> Ambas cuentas deben estar registradas en el mismo país.

***

## Integración de la API

Para crear una transferencia interna nacional, envía una solicitud `POST` al endpoint [Crear transferencia interna](https://docs.localpayment.com/es/reference/domestic-transfer.md).

### Endpoint

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

### Autenticación

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

### Parámetros clave de la solicitud

| Parámetro | Tipo | Descripción |
| - | - | - |
| `externalId` | string | Tu identificador único de transacción |
| `country` | string | Código de país ISO alfa-3 |
| `currency` | string | Código de moneda ISO |
| `amount` | number | Importe de la transferencia |
| `transactionType` | string | Debe ser "InternalDomesticTransfer" |
| `client.from.accountNumber` | string | Número de la cuenta de origen |
| `client.to.accountNumber` | string | Número de la cuenta de destino |

### Ejemplo de solicitud

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
      --url https://api.stage.localpayment.com/api/internal-transfer \
      --header 'Authorization: Bearer <your_access_token>' \
      --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --data '{
        "externalId": "8888ad65-aa6e-4643-b9ba-ff62318fd90b",
        "country": "ARG",
        "currency": "ARS",
        "amount": 1000,
        "transactionType": "InternalDomesticTransfer",
        "client": {
          "type": "Client",
          "from": {
            "accountNumber": "{{accountNumber}}"
          },
          "to": {
            "accountNumber": "{{accountNumber}}"
          }
        }
      }'
```

***

## Gestión de respuestas

Nuestra API proporciona datos de respuesta completos para una gestión y conciliación eficaces de las transacciones.

### Respuesta de éxito

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
    "transactionType": "InternalDomesticTransfer",
    "externalId": "8888ad65-aa6e-4643-b9ba-ff62318fd90b",
    "internalId": "cda1c606-a14f-4cab-a323-82c09f2ca8b1",
    "country": "ARG",
    "currency": "ARS",
    "clientCode": "0001",
    "creationDate": "2025-10-14T15:44:53.374+00:00",
    "errors": [],
    "status": {
        "code": "200",
        "description": "Completed",
        "detail": "INTERNAL TRANSFER"
    },
    "amount": 1000,
    "client": {
        "type": "Client",
        "from": {
            "clientCode": "0001",
            "accountNumber": "{{accountNumber}}"
        },
        "to": {
            "clientCode": "0001",
            "accountNumber": "{{accountNumber}}",
            "amount": 966.0
        }
    },
    "fees": {
        "description": "Fee",
        "currency": "ARS",
        "amount": 21.0,
        "account": "{{accountNumber}}"
    },
    "localTaxes": [
        {
            "code": "0001",
            "percentage": 1.3,
            "description": "IDC",
            "currency": "ARS",
            "fxSource": 1360.092976,
            "fxQuote": 0.0,
            "amount": 13.0,
            "account": "{{accountNumber}}"
        }
    ],
    "withHoldings": [],
    "code": "200"
}
```

#### Campos de respuesta clave

| Campo | Descripción |
| - | - |
| `internalId` | Identificador único generado por el sistema para el seguimiento |
| `status.code` | Estado de la transacción: 200 (COMPLETED), 702+ (ERRORS) |
| `client.to.amount` | Importe neto acreditado en la cuenta de destino |
| `fees.amount` | Total de comisiones de procesamiento deducidas |
| `localTaxes` | Arreglo de impuestos locales aplicables |
| `payment.creditedAmount` | Importe final recibido en la cuenta de destino |

### Respuestas de error

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
    {
      "externalId": "TXN_INVALID_123",
      "internalId": "fc2c831c-d0f1-41f6-8a59-0ecd426c087d",
      "errors": [
        {
          "code": "702",
          "detail": "Account not configured for InternalDomesticTransfer"
        },
        {
          "code": "703", 
          "detail": "Account countries must match"
        },
        {
          "code": "704",
          "detail": "Insufficient funds in source account"
        }
      ],
      "status": {
        "code": "702",
        "description": "REJECTED",
        "detail": "Configuration validation failed"
      }
    }
```

***

## Seguimiento del estado de las transacciones

Supervisa tus cambios de divisas a través de múltiples canales:

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

### Ciclo de vida del estado

| Código | Estado | Descripción |
| :- | :- | :- |
| `100` | `InProgress` | En curso |
| `102` | `PendingDebit` | Débito pendiente |
| `103` | `PendingCredit` | Crédito pendiente |
| `200` | `Completed` | TRANSFERENCIA INTERNA |
| `303` | `Rejected` | Este token de tipo de cambio ha caducado. |

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

***

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