Começando
ArzaPay: Pix e link de pagamento com aviso na hora
Crie cobranças por Pix ou link de pagamento, receba o aviso quando o cliente paga e acompanhe saldo e extrato. Tudo pelo painel, sem programar, ou pela API, se você quer automatizar.
A ArzaPay está em pré-lançamento. Hoje só o sandbox está ligado: tudo funciona, mas com dinheiro de mentira.
Como um pagamento funciona
- 1Você cria a cobrança
- 2O cliente paga no Pix
- 3A ArzaPay confirma
- 4O valor entra no saldo
- 5Você sacaem breve
Primeiros passos
- Crie a conta em /criar-conta, com o código de convite do acesso antecipado.
- Gere uma chave em Painel › Desenvolvedores. Ela aparece uma vez só.
- Crie uma cobrança pela API (abaixo) ou pelo botão Nova cobrança.
- Simule o pagamento e veja o saldo subir e o webhook chegar.
Sandbox
O sandbox é um ambiente completo com dinheiro de mentira. As chaves começam com sk_sandbox_, os códigos Pix são inválidos de propósito e o pagamento acontece pela rota de simulação ou pelo botão Simular pagamento.
curl -X POST https://www.arzapay.arkynia.com.br/api/v1/sandbox/cobrancas/cob_3f9a1c0b7d2e4a6f81/pagar \
-H "Authorization: Bearer $ARZAPAY_CHAVE"Chaves de API
Envie a chave em toda chamada, no cabeçalho Authorization: Bearer. Use sempre no servidor, nunca no navegador. Você pode ter até 10 chaves ativas e revogar qualquer uma pelo painel.
Endereço base: https://www.arzapay.arkynia.com.br/api/v1
Taxas
As taxas ficam publicadas em /precos, com simulador. Enquanto a ArzaPay não abre, os valores são de exemplo.
Cobrar
Cobranças
Valores sempre em centavos, como número inteiro: R$ 180,00 é 18000. A referencia é o seu identificador (pedido, fatura) e volta em tudo.
curl -X POST https://www.arzapay.arkynia.com.br/api/v1/cobrancas \
-H "Authorization: Bearer $ARZAPAY_CHAVE" \
-H "Content-Type: application/json" \
-d '{"valor": 18000, "descricao": "Corte e escova", "referencia": "pedido-42"}'Resposta (201):
{
"id": "cob_3f9a1c0b7d2e4a6f81",
"status": "pendente",
"valor": 18000,
"descricao": "Corte e escova",
"referencia": "pedido-42",
"ambiente": "sandbox",
"pix_copia_cola": "ARZAPAY-SANDBOX-...",
"link_pagamento": "https://www.arzapay.arkynia.com.br/pagar/cob_3f9a1c0b7d2e4a6f81",
"criada_em": "2026-11-10T23:40:00.000Z",
"expira_em": "2026-11-11T23:40:00.000Z",
"paga_em": null
}Status: pendente, depois paga ou expirada (24 horas sem pagamento no sandbox).
Link de pagamento
Toda cobrança tem um link_pagamento: uma página com o valor, a descrição, o QR Code e o Pix copia e cola. Mande no WhatsApp ou no e-mail. Quando o cliente paga, a página muda para paga sozinha.
Pix
Use o pix_copia_cola da resposta para mostrar o Pix no seu próprio checkout, como texto para copiar ou como QR Code.
Dinheiro
Saldo e extrato
curl https://www.arzapay.arkynia.com.br/api/v1/saldo -H "Authorization: Bearer $ARZAPAY_CHAVE"
{ "ambiente": "sandbox", "saldo": 25050 }O extrato (GET /extrato) lista recebimentos e saídas, cada um com o tipo, o valor em centavos e a cobrança de origem.
Saques
O saque para a conta bancária do seu negócio chega com o lançamento. No sandbox o saldo é de mentira e não pode ser sacado.
Integrar
Webhooks
Cadastre uma URL em Painel › Desenvolvedores. Quando a cobrança é paga, a ArzaPay faz um POST com o evento:
{
"evento": "cobranca.paga",
"criado_em": "2026-11-10T23:41:12.000Z",
"cobranca": { "id": "cob_3f9a1c0b7d2e4a6f81", "status": "paga", "valor": 18000, "...": "..." }
}Responda com 2xx em até 5 segundos. O cabeçalho ArzaPay-Assinatura traz t (horário) e v1 (HMAC-SHA256 de t.corpo com o segredo do webhook). Confira antes de confiar:
import { createHmac, timingSafeEqual } from 'node:crypto';
// cabecalho = valor de "ArzaPay-Assinatura"; corpo = texto cru recebido
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));
}Hoje cada evento é enviado uma vez, sem nova tentativa. Se o seu servidor estiver fora, consulte a cobrança pela API.
Erros
Todo erro vem no mesmo formato:
{ "erro": { "codigo": "valor_invalido", "mensagem": "valor é obrigatório, em centavos..." } }| Status | Código | O que aconteceu |
|---|---|---|
401 | chave_ausente, chave_invalida | Chave faltando, errada ou revogada. |
404 | nao_encontrada | A cobrança não existe nesta conta e ambiente. |
409 | nao_pendente | A cobrança não está mais pendente. |
422 | valor_invalido, descricao_invalida, referencia_invalida | Algum campo veio fora do formato. |
llms.txt e IA
Constrói com IA? Cole o endereço abaixo no Claude, no ChatGPT, no Lovable ou no Cursor e peça: "integre a ArzaPay no meu projeto".
https://www.arzapay.arkynia.com.br/llms.txtReferência das rotas
| Método | Rota | O que faz |
|---|---|---|
| POST | /cobrancas | Cria uma cobrança. Campos: valor (centavos, obrigatório), descricao, referencia. |
| GET | /cobrancas | Lista as cobranças mais recentes. Aceita ?limite= (até 100). |
| GET | /cobrancas/{id} | Consulta uma cobrança. |
| GET | /saldo | Saldo da conta, em centavos. |
| GET | /extrato | Lançamentos mais recentes. Aceita ?limite= (até 100). |
| POST | /sandbox/cobrancas/{id}/pagar | Só no sandbox: simula o pagamento da cobrança. |