Pagar contas

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)

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.

Dashboard

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

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

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

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)

Introdução

Webhooks

PIX

Conta

Loja

Subcontas

API

Corpo (pagar QR / copia e cola)

Dashboard

Diferença de outros módulos

Próximos passos

Transferir PIX

Guia PIX

​API

​Corpo (pagar QR / copia e cola)

​Dashboard

​Diferença de outros módulos

​Próximos passos

Transferir PIX

Guia PIX

API

Corpo (pagar QR / copia e cola)

Dashboard

Diferença de outros módulos

Próximos passos