> ## 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 doméstica

Transferências internas seguras entre suas contas da Localpayment. Mantenha a liquidez e gerencie fundos no âmbito doméstico, sem conversão de moeda.

Uma transferência interna doméstica permite mover fundos com segurança entre suas contas da Localpayment dentro do mesmo país e da mesma moeda. Este recurso é ideal para gerenciar a liquidez entre várias contas ou redistribuir fundos para obter eficiência operacional.

## Casos de uso

* **Rebalanceamento de portfólio:** Realoque capital dinamicamente entre os portfólios de clientes para aproveitar rapidamente as oscilações do mercado e cumprir os mandatos estratégicos de investimento.
* **Gestão centralizada de liquidez:** Consolide os saldos de várias contas operacionais para otimizar o capital de giro, garantir pagamentos pontuais e maximizar a utilização dos fundos.
* **Distribuição estruturada de fundos:** Automatize o desembolso de orçamentos para departamentos, projetos ou centros de custo a partir de uma conta central, mantendo total visibilidade e controle.
* **Conformidade regulatória e de riscos:** Gerencie proativamente as reservas de capital e as margens de segurança de risco, segregando os fundos entre tipos de conta designados para atender aos requisitos regulatórios e às políticas internas.

***

## Pré-requisitos

Antes de iniciar transferências internas domésticas, certifique-se de ter:

* **Fundos suficientes** em sua conta de origem
* **Credenciais de API válidas** com permissões para transferências internas
* **Verificação da conta** para as contas de origem e de destino
* **Registro no mesmo país** para ambas as contas

> [!WARNING]
>
> **Importante**
>
> Ambas as contas devem estar registradas no mesmo país.

***

## Integração com a API

Para criar uma Transferência Interna Doméstica, 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

```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 |
| `country` | string | Código de país ISO alfa-3 |
| `currency` | string | Código de moeda ISO |
| `amount` | number | Valor da transferência |
| `transactionType` | string | Deve ser "InternalDomesticTransfer" |
| `client.from.accountNumber` | string | Número da conta de origem |
| `client.to.accountNumber` | string | Número da conta de destino |

### 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": "8888ad65-aa6e-4643-b9ba-ff62318fd90b",
        "country": "ARG",
        "currency": "ARS",
        "amount": 1000,
        "transactionType": "InternalDomesticTransfer",
        "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 bem-sucedida

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

| Campo | Descrição |
| - | - |
| `internalId` | Identificador exclusivo gerado pelo sistema para rastreamento |
| `status.code` | Status da transação: 200 (COMPLETED), 702+ (ERRORS) |
| `client.to.amount` | Valor líquido creditado na conta de destino |
| `fees.amount` | Total de taxas de processamento deduzidas |
| `localTaxes` | Array com os impostos locais aplicáveis |
| `payment.creditedAmount` | Valor final recebido na conta de destino |

### Respostas de erro

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

***

## 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] [Endpoint da API de Status](https://docs.localpayment.com/pt-br/reference/get-transaction-status.md)
>
> Consultar o status da transação programaticamente. Útil para consultar ou recuperar notificações de webhook perdidas.

> [card] [Visualização do Business Portal](https://docs.localpayment.com/pt-br/docs/dashboard-overview.md)
>
> Interface visual para monitoramento de transações. Ideal para supervisão manual e análise detalhada de transações.

### 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 |
| `303` | `Rejected` | Este token de taxa de câmbio expirou. |

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