Desenvolvedores
Uma API que cabe numa página.
Seis rotas, valores em centavos e um webhook assinado. Do primeiro Pix de teste ao aviso no seu servidor em poucos passos.
curl -X POST https://www.arzapay.com.br/api/v1/cobrancas \
-H "Authorization: Bearer $ARZAPAY_CHAVE" \
-H "Content-Type: application/json" \
-d '{"valor": 18000, "descricao": "Corte e escova"}'const r = await fetch('https://www.arzapay.com.br/api/v1/cobrancas', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.ARZAPAY_CHAVE}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ valor: 18000, descricao: 'Corte e escova' }),
});
const cobranca = await r.json();import os, requests
r = requests.post(
"https://www.arzapay.com.br/api/v1/cobrancas",
headers={"Authorization": f"Bearer {os.environ['ARZAPAY_CHAVE']}"},
json={"valor": 18000, "descricao": "Corte e escova"},
)
cobranca = r.json()Feita para quem constrói
Sandbox aberto
Chaves sk_sandbox_ e pagamento simulado por uma rota. Teste o fluxo inteiro sem dinheiro de verdade.
Webhook assinado
O evento cobranca.paga chega com HMAC-SHA256 no cabeçalho ArzaPay-Assinatura.
llms.txt para a sua IA
Cole o endereço no Claude, no ChatGPT ou no Lovable e peça para integrar.
Erros que explicam
Todo erro diz o código e o que fazer. Valores sempre em centavos.
Do zero ao primeiro aviso
Crie a conta
Cadastro no painel, com o código de convite do acesso antecipado.
Gere a chave
Em Desenvolvedores, uma chave de sandbox que aparece uma vez só.
Crie a cobrança
POST /cobrancas com o valor em centavos. Volta o Pix e o link.
Receba o aviso
Cadastre a URL do webhook e confira a assinatura.
Confira antes de confiar.
Cada aviso traz o horário e uma assinatura feita com o segredo do seu webhook. Com cinco linhas, seu servidor sabe que a mensagem veio da ArzaPay.
Cole esse endereço na sua IA e peça: "integre a ArzaPay no meu projeto".
import { createHmac, timingSafeEqual } from 'node:crypto';
export function assinaturaConfere(cabecalho, corpo, segredo) {
const { t, v1 } = Object.fromEntries(cabecalho.split(',').map((p) => p.split('=')));
const esperado = createHmac('sha256', segredo).update(`${t}.${corpo}`).digest('hex');
return v1.length === esperado.length && timingSafeEqual(Buffer.from(v1), Buffer.from(esperado));
}