> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abacatepay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Pix para terceiros

> Pague fornecedores, parceiros e outras pessoas por Pix direto do saldo da AbacatePay, pelo dashboard ou pela API, com chave Pix ou Pix Copia e Cola.

O Enviar Pix manda dinheiro do seu saldo na AbacatePay para a chave Pix de outra pessoa ou empresa: fornecedores, parceiros, colaboradores ou sócios. No dashboard, ele fica em **Financeiro → Pagamentos**. Na API, é o `POST /pix/send`.

## Quando usar

| Você quer | Use |
| - | - |
| Pagar outra pessoa ou empresa | Enviar Pix |
| Levar o saldo para uma conta no CPF ou CNPJ da sua empresa | [Saque](https://docs.abacatepay.com/pages/dinheiro/saques.md) |
| Repassar a parte de um vendedor do seu marketplace | [Saque da subconta](https://docs.abacatepay.com/pages/dinheiro/subcontas-e-split.md) |

## Como funciona o Enviar Pix

```mermaid theme={null}
sequenceDiagram
    participant V as Você
    participant A as AbacatePay
    participant B as Banco do destinatário
    V->>A: Novo pagamento ou POST /pix/send
    A-->>V: Envio criado (COMPLETE)
    A->>B: Envia o Pix
    B-->>A: Confirma ou recusa
    A-->>V: transfer.completed ou transfer.failed
```

O envio nasce com status `COMPLETE` e o valor sai do saldo na hora. Quando o banco confirma, sai o webhook `transfer.completed`. Se o banco recusar, o envio passa para `FAILED`, o valor volta para o seu saldo e sai o `transfer.failed`.

### Regras do Enviar Pix

* **Mesmo saldo e mesmos limites do saque:** o valor sai do saldo disponível (um saldo só por envio, se a conta recebe cartão), conta no limite diário e no limite noturno, das 20h às 8h, e respeita o intervalo de 30 segundos junto com os saques. As regras estão em [Saques](https://docs.abacatepay.com/pages/dinheiro/saques.md#regras-do-saque).
* **Destino:** qualquer chave Pix de outra pessoa ou empresa. Para mandar para uma conta no CPF ou CNPJ da sua própria empresa, use o [saque](https://docs.abacatepay.com/pages/dinheiro/saques.md).
* **Taxa:** sai do valor enviado. O destinatário recebe `amount` menos `platformFee`. Para entregar um valor exato pela API, some a taxa ao `amount`. No dashboard, você digita quanto o destinatário recebe, e a tela soma a taxa. Os valores estão na [página de preços](https://www.abacatepay.com/pricing) e em **Perfil → Taxas**.
* **Valor mínimo na API:** R\$ 1,00 (`100`).
* **Ativação:** o Enviar Pix vem ativo nas contas. Se estiver desativado na sua, a API responde `Função não habilitada`; fale com o suporte.
* **Ambiente:** só existe em produção.

### Tipos de chave Pix

| `pix.type` | Exemplo |
| - | - |
| `CPF` | `12345678901` |
| `CNPJ` | `12345678000190` |
| `PHONE` | `11987654321` |
| `EMAIL` | `contato@fornecedor.com` |
| `RANDOM` | Chave aleatória (UUID) |
| `BR_CODE` | Pix Copia e Cola completo |

Com `BR_CODE`, o Pix vai para a chave que está dentro do código, com o `amount` que você enviar: o valor gravado no código não é usado. Só o Pix Copia e Cola estático funciona. O de cobrança (dinâmico) não traz a chave e é recusado.

### Idempotência pelo `externalId`

Na API, o `externalId` é obrigatório e funciona como chave de idempotência. Se você repetir o `POST` com o mesmo `externalId` e o mesmo `amount`, por exemplo depois de um timeout, a API devolve o envio que já existe e não manda outro Pix. Com o mesmo `externalId` e outro `amount`, a API responde `externalId já usado em outro envio com valor diferente`.

## Como enviar Pix pelo dashboard

**1. Abra a tela de pagamentos**

Vá em **Financeiro → Pagamentos** e clique em **Novo pagamento** no saldo de onde o dinheiro vai sair. A conta precisa ter a verificação em duas etapas (2FA) ativa.

**2. Digite o valor**

Em **Valor do pagamento**, digite quanto o destinatário vai receber. A tela mostra quanto você pode pagar agora, já com o saldo e os limites.

**3. Informe o destinatário**

Escolha o **Tipo de chave Pix** (CPF, CNPJ, e-mail, telefone, aleatória ou Pix Copia e Cola), preencha a chave e, se quiser, uma descrição de até 140 caracteres.

**4. Confirme**

Confira o resumo: quem recebe, **O destinatário recebe**, **Taxa** e **Sai do seu saldo**. Digite o código do autenticador (2FA) e clique em **Realizar pagamento**.

O **Histórico** fica na mesma tela. Os pagamentos também aparecem no histórico de **Financeiro → Saques**, com o tipo **Pagamento**. O botão **Baixar recibo** abre o comprovante.

**Comprovante - AbacatePay**

O vídeo também está em [Comprovante](https://docs.abacatepay.com/pages/videos/comprovante.md).

## Como enviar Pix pela API

Chame [Enviar Pix](https://docs.abacatepay.com/pages/pix/create.md) com uma chave de API que tenha a permissão `WITHDRAW:CREATE`:

```bash theme={null}
curl -X POST https://api.abacatepay.com/v2/pix/send \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  --data '{
    "amount": 10000,
    "externalId": "pagamento-fornecedor-42",
    "description": "NF 1234",
    "pix": { "type": "EMAIL", "key": "contato@fornecedor.com" }
  }'
```

A resposta traz o `id` (`tran_...`), o `status`, o `amount`, a taxa em `platformFee` e o link do comprovante em `receiptUrl`. A `description` não aceita emoji.

Para acompanhar, use [Buscar Pix](https://docs.abacatepay.com/pages/pix/get.md), pelo `id` ou pelo `externalId`, e [Listar Pix](https://docs.abacatepay.com/pages/pix/list.md), as duas com a permissão `WITHDRAW:READ`. Os erros de cada rota estão na página dela.

## Notificações

| Evento | Quando é disparado |
| - | - |
| `transfer.completed` | O banco do destinatário confirmou o Pix |
| `transfer.failed` | O envio falhou e o valor voltou para o seu saldo |

Os eventos valem para os envios do dashboard e da API e trazem o mesmo `id` e `externalId` da resposta. O formato está em [Eventos de transferência](https://docs.abacatepay.com/pages/webhooks/events/transfers.md). Para receber, configure um [webhook](https://docs.abacatepay.com/pages/notificacoes/webhooks.md).

## Testar no Modo Teste

O Enviar Pix não tem simulação: ele só funciona em produção. No [Modo Teste](https://docs.abacatepay.com/pages/comecar/modo-teste.md), o botão **Novo pagamento** abre um aviso explicando como passar para produção.

## Perguntas frequentes

> [accordion] Posso pagar um sócio da empresa?
>
> Sim. O sócio é outra pessoa, então use o Enviar Pix. O saque vai só para contas no CPF ou CNPJ da própria conta.

> [accordion] Como faço o destinatário receber um valor exato?
>
> No dashboard, digite o valor que ele deve receber: a tela soma a taxa. Na API, some a taxa ao `amount`, porque ela sai do valor enviado.

> [accordion] O que acontece se eu repetir a requisição?
>
> Com o mesmo `externalId` e o mesmo `amount`, a API devolve o envio que já existe e não manda outro Pix. Com outro valor, a API recusa.

> [accordion] Posso pagar um QR Code de cobrança?
>
> Não. O Enviar Pix aceita só o Pix Copia e Cola estático, que traz a chave do destinatário. Para um código de cobrança, peça a chave Pix ao destinatário.

> [accordion] Onde fica o comprovante?
>
> No dashboard, no botão **Baixar recibo** do histórico. Na API, no `receiptUrl` da resposta.


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