Como integrar API Pix em 5 minutos
Guia rápido para desenvolvedores. Copie, cole e receba o primeiro Pix sem SDK proprietária. Apenas curl ou Python, taxa fixa de R$ 0,65 por cobrança, sem mensalidade.
Crie sua conta e pegue a chave
Cadastre-se, aguarde a aprovação manual (segurança B2B) e gere uma chave de API na aba API do painel.
Instale o cliente HTTP
Use curl (já vem no Linux/macOS) ou instale o requests no Python. Nenhuma SDK proprietária é necessária.
Crie a primeira cobrança
Um POST retorna o QR Code e o copia-e-cola Pix. Cole no seu checkout e o pagador paga.
Receba o webhook de pagamento
Cadastre um endpoint HTTPS. Quando o Pix é pago, entregamos o evento assinado em HMAC-SHA256.
Confirme o saldo e saque
O saldo cai automaticamente. Solicite o saque para sua chave Pix — repasse automático, taxa fixa de R$ 0,65.
Minuto 3 — Criar cobrança em curl
Um POST e você recebe o QR Code, o copia-e-cola e a data de expiração. Sem SDK, sem build.
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",
"copy_paste": "00020126...",
"qrcode_url": "https://api.goatpay.com.br/qr/pay_xyz.png",
"expires_at": "2026-10-06T21:00:00Z"
}Minuto 3 — Mesma cobrança em Python
Exemplo com requests. Instale com pip install requests.
import requests
resp = requests.post(
"https://wavez.online/functions/gatewayCreateCharge",
headers={
"Authorization": "Bearer wz_live_SUA_CHAVE",
"Content-Type": "application/json",
},
json={
"amount": 99.90,
"description": "Produto X",
"payer_name": "João Silva",
"payer_email": "joao@email.com",
},
)
charge = resp.json()
print(charge["copy_paste"]) # copia-e-cola Pix
print(charge["qrcode_url"]) # URL do QR CodeMinuto 4 — Validar o webhook
Quando o Pix é pago, enviamos um POST assinado para o seu endpoint. Valide a assinatura antes de confiar no payload.
from flask import Flask, request, abort
import hmac, hashlib
app = Flask(__name__)
WEBHOOK_SECRET = "whsec_..."
@app.post("/webhook")
def webhook():
sig = request.headers.get("x-wavez-signature", "")
expected = "sha256=" + hmac.new(
WEBHOOK_SECRET.encode(),
request.get_data(),
hashlib.sha256,
).hexdigest()
if not hmac.compare_digest(sig, expected):
abort(401)
event = request.json
if event["event"] == "charge.paid":
charge_id = event["data"]["id"]
# ... marque como pago no seu sistema
return "", 200Pronto para o primeiro Pix?
Crie sua conta grátis e receba o primeiro pagamento 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