Pular para o conteúdo

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"}'

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

  1. Crie a conta

    Cadastro no painel, com o código de convite do acesso antecipado.

  2. Gere a chave

    Em Desenvolvedores, uma chave de sandbox que aparece uma vez só.

  3. Crie a cobrança

    POST /cobrancas com o valor em centavos. Volta o Pix e o link.

  4. 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.

www.arzapay.com.br/llms.txt

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));
}