Guia de integração

Como integrar Pix no
seu sistema

Receba pagamentos Pix no seu site ou aplicativo em minutos. Sem mensalidade, com taxa fixa de R$ 0,65 por cobrança.

1. Crie sua conta de comerciante

Cadastre-se em /register e aguarde a aprovação manual. Após a aprovação, você pode gerar cobranças e links.

2. Gere um link de pagamento

No painel, em /links-pagamento, crie um link com nome, valor e slug único. Compartilhe a URL /pay/:slug por qualquer canal.

3. Crie uma cobrança via API

Chame a função gatewayCreateCharge com o valor e dados do pagador. Receba o copia e cola e o QR Code na resposta.

4. Receba o webhook de pagamento

Cadastre um endpoint em /webhooks. Quando o Pix é pago, entregamos o evento assinado em HMAC-SHA256 para a sua URL.

Exemplo: criar cobrança com curl

Requisição
# Criar uma cobrança Pix
curl -X POST https://wavez.online/functions/gatewayCreateCharge \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49.90,
    "description": "Curso de marketing digital",
    "external_reference": "pedido_123",
    "payer_name": "João Silva",
    "payer_email": "joao@email.com",
    "fee_payer": "merchant"
  }'
Resposta
{
  "id": "chg_abc123",
  "goatpay_id": "pay_xyz",
  "copy_paste": "00020126...",
  "qrcode_url": "https://api.goatpay.com.br/qr/pay_xyz.png",
  "expires_at": "2026-10-04T20:30:00Z",
  "fee_payer": "merchant"
}
Taxa fixa e transparente. R$ 0,65 por cobrança recebida e R$ 0,65 por saque. Sem percentual sobre volume, sem mensalidade. O repasse cai na sua chave Pix em minutos.