Como integrar Pix no seu sistema
Guia prático para desenvolvedores. Crie cobranças Pix, receba webhooks assinados e faça saques automáticos. Taxa fixa de R$ 0,65 por cobrança, sem mensalidade.
1. Crie sua conta
Cadastre-se na SymbolPay e aguarde aprovação manual. Após aprovação, gere uma chave de API na aba API do painel.
2. Crie uma cobrança
Chame a função gatewayCreateCharge com o valor e descrição. Você recebe o QR Code e o copia-e-cola Pix na hora.
3. Receba o webhook
Configure um endpoint HTTPS no painel. Quando o pagamento for confirmado, entregamos o evento charge.paid assinado em HMAC-SHA256.
4. Saque seu saldo
Cadastre sua chave Pix no perfil e solicite o saque do saldo disponível. Repasse automático, taxa fixa de R$ 0,65.
Criar cobrança Pix
Envie o valor e receba o QR Code + copia-e-cola. O pagador paga e o webhook dispara automaticamente.
curl -X POST https://wavez.online/functions/gatewayCreateCharge \
-H "Authorization: Bearer wz_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"amount": 99.90,
"description": "Produto X",
"payer_name": "João Silva",
"payer_email": "joao@email.com"
}'{
"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-06T21:00:00Z",
"fee_payer": "merchant"
}Receber webhook de pagamento
Quando o Pix é pago, entregamos o evento charge.paid no seu endpoint HTTPS, assinado em HMAC-SHA256.
// Seu endpoint recebe POST com:
{
"event": "charge.paid",
"data": {
"id": "chg_abc123",
"amount": 99.90,
"net_amount": 99.25,
"fee": 0.65
},
"timestamp": "2026-10-06T20:30:00Z"
}
// Valide a assinatura no header:
// x-wavez-signature: sha256=...Solicitar saque
Transfira o saldo disponível para sua chave Pix cadastrada. Taxa fixa de R$ 0,65 por saque.
curl -X POST https://wavez.online/functions/gatewayWithdraw \
-H "Authorization: Bearer wz_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{ "amount": 500.00 }'{
"id": "wdw_xyz789",
"status": "pendente"
}Criar link de pagamento
Gere um link reutilizável e compartilhe. O pagador paga sem precisar de conta.
curl -X POST https://wavez.online/functions/createPaymentLink \
-H "Authorization: Bearer wz_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"name": "Curso de Marketing",
"amount": 297.00,
"description": "Acesso completo",
"slug": "curso-marketing"
}'{
"id": "lnk_abc",
"slug": "curso-marketing",
"url": "https://wavez.online/pay/curso-marketing"
}Segurança da integração
- • Webhooks assinados em HMAC-SHA256 com validação fail-closed
- • Confirmação server-to-server com a GoatPay antes de creditar saldo
- • Reserva atômica de saldo nos saques (sem duplo crédito)
- • Idempotência nas transições de status (entregas duplicadas não reprocessam)
- • Chaves de API armazenadas como hash SHA-256 (nunca em texto plano)
Pronto para integrar?
Crie sua conta grátis e comece a receber Pix em minutos.
Criar conta grátisThis site uses cookies
We use essential cookies for the site to function and analytics cookies to improve your experience. You can accept all, reject optional ones, or manage your preferences. Learn more in our Cookie Policy