# Transferência interna (/docs/pix-processamento/endpoints/internal-transfer)



Quando origem e destino são ambos contas PayZu, use **transferência interna** em vez de saque Pix. Liquidação é **instantânea** e usa apenas o `accountNumber` (6 dígitos) de cada conta. Tarifa conforme tabela da sua conta.

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/endpoints/internal-transfer/post_internal_transfer" title="Criar transferência" method="POST" path="/internal-transfer" />

  <QuickLink href="/docs/pix-processamento/endpoints/internal-transfer/get_internal_transfer" title="Consultar transferência" method="GET" path="/internal-transfer" />
</QuickLinks>

## Quando usar cada um [#quando-usar-cada-um]

| Pergunta                                       | Endpoint                                                                                                |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Quero mover saldo de uma conta PayZu pra outra | [`POST /internal-transfer`](/docs/pix-processamento/endpoints/internal-transfer/post_internal_transfer) |
| A transferência foi concluída? Qual o status?  | [`GET /internal-transfer`](/docs/pix-processamento/endpoints/internal-transfer/get_internal_transfer)   |

## Exemplos [#exemplos]

<Accordions type="single">
  <Accordion title="POST /internal-transfer, transferir entre contas">
    ```bash
    curl -X POST https://api.payzu.processamento.com/v1/internal-transfer \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "payerAccountNumber": "513579",
        "receiverAccountNumber": "987654",
        "amount": 100.50,
        "description": "Pagamento referente a fatura #1234",
        "callbackUrl": "https://seusite.com.br/webhooks/payzu",
        "clientReference": "transfer-abc-123"
      }'
    ```
  </Accordion>

  <Accordion title="GET /internal-transfer, consultar por clientReference">
    ```bash
    curl "https://api.payzu.processamento.com/v1/internal-transfer?clientReference=transfer-abc-123" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json"
    ```
  </Accordion>
</Accordions>

## Diferenças vs Saque Pix [#diferenças-vs-saque-pix]

| Aspecto       | Transferência interna       | Saque Pix (`/withdraw`) |
| ------------- | --------------------------- | ----------------------- |
| Destino       | Conta PayZu                 | Qualquer banco/conta    |
| Tarifa        | Conforme tabela da conta    | Conforme tabela         |
| Liquidação    | Instantânea                 | Pix em segundos         |
| Identificador | `accountNumber` (6 dígitos) | Chave Pix ou QR Code    |
| Mínimo        | R$ 0,01                     | R$ 0,01                 |

<Callout type="info">
  O `accountNumber` da conta destino vem do parceiro PayZu. A plataforma não expõe diretório público de contas.
</Callout>

## Fluxo recomendado [#fluxo-recomendado]

<Mermaid
  chart="`
flowchart LR
  A[&#x22;POST /internal-transfer&#x22;] --> B[&#x22;Débito do pagador&#x22;]
  B --> C[&#x22;Crédito do recebedor&#x22;]
  C --> D[&#x22;Callback COMPLETED&#x22;]

  click A &#x22;/docs/pix-processamento/endpoints/internal-transfer/post_internal_transfer&#x22; &#x22;POST /internal-transfer&#x22;
  click D &#x22;/docs/pix-processamento/webhooks&#x22; &#x22;Webhooks&#x22;

  style A fill:#f59e0b,stroke:#d97706,color:#ffffff
  style D fill:#14ce71,stroke:#0eb464,color:#ffffff
`"
/>

## Tutoriais e boas práticas [#tutoriais-e-boas-práticas]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/tutoriais/internal-transfer" title="Tutorial: Transferência interna" />

  <QuickLink href="/docs/pix-processamento/best-practices/idempotency" title="Idempotência" />

  <QuickLink href="/docs/pix-processamento/best-practices/multi-tenant" title="Multi-tenant" />
</QuickLinks>