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

# Pagar contas

> Pague boletos e contas de consumo via PIX copia e cola na Conta Padrão.

Na GoatPay, **pagar contas** (boleto com QR PIX, contas de consumo, etc.) usa o mesmo trilho de **envio PIX** com o campo `pixCopyPaste`. Não existe produto separado de “linha digitável de boleto bancário” — use o **PIX copia e cola** impresso no boleto ou no app do banco.

## API

| Método | Rota                      | Permissão             |
| ------ | ------------------------- | --------------------- |
| POST   | `/v1/transfer-pix/create` | `transfer-pix/create` |

### Corpo (pagar QR / copia e cola)

```bash theme={null}
curl -X POST 'https://api.goatpay.com.br/v1/transfer-pix/create' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 150.90,
    "pixCopyPaste": "00020126580014br.gov.bcb.pix...",
    "description": "Conta de luz",
    "externalReference": "conta-luz-2026-07"
  }'
```

| Campo               | Obrigatório | Descrição                                                       |
| ------------------- | ----------- | --------------------------------------------------------------- |
| `amount`            | Sim         | Valor em reais (confira com o QR; alguns QRs trazem valor fixo) |
| `pixCopyPaste`      | Sim         | Código EMV “copia e cola” do boleto/conta                       |
| `description`       | Não         | Texto no extrato                                                |
| `externalReference` | Não         | ID no seu sistema                                               |

Alternativa por chave PIX (transferência comum, não QR de conta):

* `pixKey` + `pixKeyType` — veja [Transferir PIX](/api-reference/endpoint/transfer-pix/create).

## Dashboard

**Transações → Pagar contas** (`/dashboard/transactions/pay-bills`)

1. Cole o PIX copia e cola ou escaneie o QR.
2. Confirme o valor (preenchido automaticamente quando o QR traz valor).
3. Confirme o pagamento — debita o saldo da Conta Padrão.

<Note>
  Requer conta verificada e permissão de transferência PIX. Pode exigir 2FA conforme configuração de segurança.
</Note>

## Diferença de outros módulos

| Módulo                | Uso                                             |
| --------------------- | ----------------------------------------------- |
| `billings/create`     | **Receber** pagamento (cobrar cliente)          |
| `transfer-pix/create` | **Pagar** terceiros (contas, QR, chave PIX)     |
| `payment-pix/create`  | **Receber** PIX rápido (checkout / QR dinâmico) |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Transferir PIX" icon="arrow-up-right" href="/api-reference/endpoint/transfer-pix/create">
    Referência completa do endpoint.
  </Card>

  <Card title="Guia PIX" icon="qrcode" href="/api-reference/guides/pix">
    Receber vs enviar PIX na GoatPay.
  </Card>
</CardGroup>