arzapayPainel

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

  1. 1Você cria a cobrança
  2. 2O cliente paga no Pix
  3. 3A ArzaPay confirma
  4. 4O valor entra no saldo
  5. 5Você sacaem breve

Primeiros passos

  1. Crie a conta em /criar-conta, com o código de convite do acesso antecipado.
  2. Gere uma chave em Painel › Desenvolvedores. Ela aparece uma vez só.
  3. Crie uma cobrança pela API (abaixo) ou pelo botão Nova cobrança.
  4. 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).

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..." } }
StatusCódigoO que aconteceu
401chave_ausente, chave_invalidaChave faltando, errada ou revogada.
404nao_encontradaA cobrança não existe nesta conta e ambiente.
409nao_pendenteA cobrança não está mais pendente.
422valor_invalido, descricao_invalida, referencia_invalidaAlgum 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.txt

Referência das rotas

MétodoRotaO que faz
POST/cobrancasCria uma cobrança. Campos: valor (centavos, obrigatório), descricao, referencia.
GET/cobrancasLista as cobranças mais recentes. Aceita ?limite= (até 100).
GET/cobrancas/{id}Consulta uma cobrança.
GET/saldoSaldo da conta, em centavos.
GET/extratoLançamentos mais recentes. Aceita ?limite= (até 100).
POST/sandbox/cobrancas/{id}/pagarSó no sandbox: simula o pagamento da cobrança.