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

# Transferência interna para o exterior

Uma transferência interna para o exterior permite transferir fundos com segurança entre suas contas da Localpayment em diferentes países, preservando a mesma moeda.

Este poderoso recurso simplifica a gestão internacional de liquidez, facilita as operações transfronteiriças e otimiza sua estratégia financeira global.

## Casos de uso

Transforme suas operações financeiras internacionais com estas aplicações estratégicas:

* **Rebalanceamento de portfólio transfronteiriço:** Realoque capital dinamicamente entre portfólios de clientes internacionais para aproveitar as oportunidades do mercado global e manter alocações estratégicas de investimento em vários países e jurisdições.

* **Otimização global de liquidez:** Centralize e redistribua os saldos entre contas operacionais internacionais para maximizar a eficiência do capital de giro e garantir que os pagamentos transfronteiriços fluam sem problemas.

* **Distribuição de fundos em vários países:** Automatize a alocação de orçamentos e o desembolso de fundos para subsidiárias internacionais, operações regionais ou projetos específicos de cada país, mantendo a supervisão centralizada e a conformidade regulatória.

* **Conformidade regulatória internacional:** Gerencie estrategicamente as reservas de capital e as margens de segurança de risco entre jurisdições para atender a diversos requisitos regulatórios, manter índices de liquidez adequados e garantir a conformidade com as regulamentações bancárias locais.

***

## Pré-requisitos

Certifique-se de que sua configuração atende a estes requisitos antes de iniciar transferências internas para o exterior:

* **Saldo disponível suficiente** em sua conta de origem, com reservas adequadas para taxas e impostos
* **Credenciais de API válidas** com permissões de transferência interna habilitadas
* **Verificação de contas em vários países** para as contas de origem e de destino em diferentes países

> [!WARNING]
>
> **Importante**
>
> Ambas as contas devem estar registradas na mesma moeda.

***

## Integração com a API

Para criar uma Transferência Interna para o Exterior, envie uma solicitação `POST` ao endpoint [Criar Transferência Interna](https://docs.localpayment.com/pt-br/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
```

### Autenticação

Todas as solicitações exigem autenticação segura por bearer token:

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

### Parâmetros-chave da solicitação

| Parâmetro | Tipo | Descrição |
| - | - | - |
| `externalId` | string | Seu identificador exclusivo da transação para rastreamento |
| `country` | string | Código de país ISO alfa-3 da conta de origem |
| `currency` | string | Código de moeda ISO da conta de origem |
| `amount` | number | Valor da transferência |
| `transactionType` | string | Deve ser "InternalForeignTransfer" |
| `client.from.accountNumber` | string | Número da conta de origem |
| `client.to.accountNumber` | string | Número da conta de destino (país diferente) |

### Exemplo de solicitação

```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}}"
    }
  }
}'
```

***

## Tratamento de Respostas

Nossa API fornece dados de resposta abrangentes para a gestão eficaz e a conciliação das transações.

### Resposta de transferência bem-sucedida

```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 resposta principais

| Campo | Propósito |
| - | - |
| `internalId` | UUID gerado pelo sistema para rastreamento e suporte da transação |
| `status.code` | Resultado da transação: 200 (SUCCESS) ou 702+ (ERROR) |
| `client.to.amount` | Valor líquido creditado após taxas e impostos |
| `fees.amount` | Total de taxas de processamento aplicadas à conta de origem |
| `localTaxes` | Detalhamento dos impostos jurisdicionais aplicáveis |
| `creationDate` | Carimbo de data e hora UTC para o registro preciso do momento da transação |

### Tratamento de respostas de erro

Tratamento de erros robusto com informações de diagnóstico detalhadas:

```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"
  }
}
```

***

## Rastreamento do status da transação

Monitore suas conversões de moeda por meio de múltiplos canais:

> [card] [Webhooks (Recomendado)](https://docs.localpayment.com/pt-br/docs/webhooks.md)
>
> Receba notificações em tempo real quando o status da transação mudar. Ideal para ambientes de produção.

> [card] [API de Status](https://docs.localpayment.com/pt-br/docs/reporting-and-reconciliation.md)
>
> Consulte o status da transação programaticamente usando o ID da transação. Ideal para consulta periódica de status.

> [card] [Business Portal](https://docs.localpayment.com/pt-br/docs/dashboard-overview.md)
>
> Interface visual de monitoramento com histórico detalhado de transações e análises.

### Ciclo de vida do status

| Código | Status | Descrição |
| :- | :- | :- |
| `100` | `InProgress` | Em andamento |
| `102` | `PendingDebit` | Débito pendente |
| `103` | `PendingCredit` | Crédito pendente |
| `200` | `Completed` | TRANSFERÊNCIA INTERNA |
| `704` | `Rejected` | Conta creditada não existe |

> [!NOTE]
>
> **Referência completa**
>
> Consulte todos os códigos de status em nossa [Documentação de Status da Transação](https://docs.localpayment.com/pt-br/reference/transaction-status-error-codes).

***

## Recursos e próximos passos

Maximize o sucesso da sua integração com estes recursos essenciais

> [card] [Integração de Webhook](https://docs.localpayment.com/pt-br/docs/webhooks.md)
>
> Configure notificações em tempo real para atualizações do status das transações.

> [card] [Relatórios do Business Portal](https://docs.localpayment.com/pt-br/docs/balance-report.md)
>
> Acesse análises detalhadas, ferramentas de geração de relatórios e recursos de conciliação.

> [card] [Monitoramento de transações](https://docs.localpayment.com/pt-br/reference/transaction-status-error-codes)
>
> Aprenda a consultar o status das transações e a implementar um rastreamento abrangente.

> [card] [Referência da API](https://docs.localpayment.com/pt-br/reference/exchange-bulk.md)
>
> Documentação completa dos endpoints com exemplos interativos.

> [!NOTE]
>
> **Dica profissional**
>
> Sempre teste seu fluxo de trabalho em nosso ambiente de sandbox antes de implantá-lo em produção. Isso garante que o tratamento de erros, o processamento de webhooks e o rastreamento de status funcionem corretamente em todos os cenários.

***

> [!NOTE]
>
> **Precisa de ajuda?**
>
> Entre em contato com nossa [equipe de suporte](mailto:support@localpayment.com) caso encontre algum problema ou precise de ajuda com a integração.


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