> ## 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 de divisas

Una transferencia interna internacional te permite transferir fondos de forma segura entre tus cuentas de Localpayment en diferentes países conservando la misma moneda.

Esta potente funcionalidad agiliza la gestión de la liquidez internacional, facilita las operaciones transfronterizas y optimiza tu estrategia financiera global.

## Casos de uso

Transforma tus operaciones financieras internacionales con estas aplicaciones estratégicas:

* **Reequilibrio de carteras transfronterizas:** Reasigna dinámicamente el capital entre carteras de clientes internacionales para aprovechar las oportunidades del mercado global y mantener asignaciones de inversión estratégicas en múltiples países y jurisdicciones.

* **Optimización de la liquidez global:** Centraliza y redistribuye los saldos entre cuentas operativas internacionales para maximizar la eficiencia del capital de trabajo y garantizar que los pagos transfronterizos fluyan sin contratiempos.

* **Distribución de fondos en varios países:** Automatiza la asignación de presupuestos y el desembolso de fondos a filiales internacionales, operaciones regionales o proyectos específicos de cada país, manteniendo la supervisión centralizada y el cumplimiento regulatorio.

* **Cumplimiento regulatorio internacional:** Gestiona estratégicamente las reservas de capital y los márgenes de riesgo entre jurisdicciones para cumplir diversos requisitos regulatorios, mantener ratios de liquidez adecuados y garantizar el cumplimiento de las normativas bancarias locales.

***

## Requisitos previos

Asegúrate de que tu configuración cumpla estos requisitos antes de iniciar transferencias internas internacionales:

* **Saldo disponible suficiente** en tu cuenta de origen, con reservas adecuadas para comisiones e impuestos
* **Credenciales de API válidas** con permisos para transferencias internas habilitados
* **Verificación de cuentas en varios países** para las cuentas de origen y de destino en diferentes países

> [!WARNING]
>
> **Importante**
>
> Ambas cuentas deben estar registradas en la misma moneda.

***

## Integración de la API

Para crear una transferencia interna internacional, 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

Todas las solicitudes requieren autenticación segura mediante token bearer:

```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 para el seguimiento |
| `country` | string | Código de país ISO alfa-3 de la cuenta de origen |
| `currency` | string | Código de moneda ISO de la cuenta de origen |
| `amount` | number | Importe de la transferencia |
| `transactionType` | string | Debe ser "InternalForeignTransfer" |
| `client.from.accountNumber` | string | Número de la cuenta de origen |
| `client.to.accountNumber` | string | Número de la cuenta de destino (otro país) |

### 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": "IFT-2024-033214-05",
  "country": "ARG",
  "currency": "USD",
  "amount": 100.00,
  "transactionType": "InternalForeignTransfer",
  "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 transferencia exitosa

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "InternalForeignTransfer",
  "externalId": "IFT-2024-033214-05",
  "internalId": "a70614fe-b76c-4f6c-9a5a-7144f2f7ea1f",
  "country": "ARG",
  "currency": "USD",
  "clientCode": "0001",
  "creationDate": "2024-03-23T00:38:30.828+00:00",
  "errors": [],
  "status": {
    "code": "200",
    "description": "COMPLETED",
    "detail": "INTERNAL FOREIGN TRANSFER PROCESSED"
  },
  "amount": 100.00,
  "client": {
    "type": "Client",
    "from": {
      "accountNumber": "{{accountNumber}}"
    },
    "to": {
      "accountNumber": "{{accountNumber}}",
      "amount": 95.80
    }
  },
  "fees": {
    "description": "Cross-border transfer fee",
    "currency": "USD",
    "amount": 3.00,
    "account": "{{accountNumber}}"
  },
  "localTaxes": [
    {
      "code": "0001",
      "percentage": 1.2,
      "description": "International Debit Tax (IDC)",
      "currency": "USD",
      "amount": 1.20,
      "account": "{{accountNumber}}"
    }
  ],
  "withHoldings": []
}
```

#### Campos de respuesta clave

| Campo | Objetivo |
| - | - |
| `internalId` | UUID generado por el sistema para el seguimiento de la transacción y el soporte |
| `status.code` | Resultado de la transacción: 200 (SUCCESS) o 702+ (ERROR) |
| `client.to.amount` | Importe neto acreditado después de comisiones e impuestos |
| `fees.amount` | Total de comisiones de procesamiento aplicadas a la cuenta de origen |
| `localTaxes` | Desglose detallado de los impuestos jurisdiccionales aplicables |
| `creationDate` | Marca de tiempo UTC para el registro preciso del momento de la transacción |

### Gestión de respuestas de error

Gestión de errores robusta con información de diagnóstico detallada:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "IFT-ERROR-123",
  "internalId": "fc2c831c-d0f1-41f6-8a59-0ecd426c087d",
  "errors": [
    {
      "code": "702",
      "detail": "Source account not configured for international transfers"
    },
    {
      "code": "703", 
      "detail": "Cross-border transfer requires different country accounts"
    },
    {
      "code": "704",
      "detail": "Insufficient funds: Available balance inadequate for transfer + fees"
    }
  ],
  "status": {
    "code": "702",
    "description": "REJECTED",
    "detail": "Pre-transfer 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] [API de estado](https://docs.localpayment.com/es/docs/reporting-and-reconciliation.md)
>
> Consulta el estado de las transacciones mediante programación usando el ID de la transacción. Perfecto para el sondeo de estado.

> [card] [Business Portal](https://docs.localpayment.com/es/docs/dashboard-overview.md)
>
> Interfaz de supervisión visual con historial detallado de transacciones y analíticas.

### 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 |
| `704` | `Rejected` | La cuenta acreditada no existe |

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