cobranzo for developers

Pix Automático e parcelado no seu backend, em uma chamada.

API REST com OAuth, webhooks idempotentes e sandbox completa. Infra de cobrança recorrente via Pix — pronta para ser embutida no seu SaaS, marketplace ou produto vertical.

$npm install @cobranzo/sdk · $pip install cobranzo
SDK do Cobranzo em editor TypeScript com event log e terminal mostrando POST /v1/recurrences
Pix Automático oficial · BACEN · ISO 27001 / 27701 · LGPD compliant · 99.98% uptime · 90d
why cobranzo

Por que Cobranzo e não outro gateway?

Três decisões de arquitetura que mudam o que você consegue construir em cima.

// pix-first architecture

Arquitetura Pix-first, não adaptação

Pensada do zero para Pix Automático. Recorrência, parcelado e autorização BACEN são primitivos da API — não workarounds em cima de gateway de boleto ou cartão.

// world-class DX

Padrão de API nível Stripe e Shopify

REST consistente, webhooks idempotentes, SDKs tipados, sandbox espelhada e mensagens de erro descritivas. Você não precisa "aprender o jeito brasileiro" de integrar.

// flat-pricing

0% sobre transação. Pacote fechado.

Outros gateways cobram percentual sobre cada transação sua. Aqui é mensalidade fechada — você paga pelo acesso, não pelo seu GMV. Custo previsível do starter ao scale.

quickstart

Da chave de API até a primeira cobrança em 10 minutos.

Sandbox espelhada da produção. SDKs pra Node, Python, Go e PHP. Webhooks de evento real desde o primeiro request.

01

Crie sua conta e pegue a chave

Acesse o dashboard, gere uma cbz_test_* e copie pra sua env.

02

Instale o SDK

Disponível para node, python, go e php — ou use REST direto.

03

Crie sua primeira recorrência

Uma chamada POST /v1/recurrences e o seu cliente recebe a autorização via WhatsApp.

04

Ouça os webhooks

Eventos idempotentes para recurrence.authorized, charge.paid, invoice.emitted.

recurrences.ts — cobranzo-api connected · sandbox
1import { cobranzo } from '@cobranzo/sdk';
2
3// Cria recorrência parcelada (12× R$ 197 no Pix)
4const rec = await cobranzo.recurrences.create({
5  customer_id: 'cus_8d9f7e6c',
6  amount: 19700,                  // em centavos
7  installments: 12,
8  frequency: 'monthly',
9  start_date: '2026-05-10',
10  payment_method: 'pix',
11  description: 'Assinatura Plano Pro',
12  invoice: { auto_emit: true },
13  webhook: env.HOOK_URL
14});
15
16// → 201 Created
17// → rec.id = "rec_1234567890"
18// → authorization_url enviada
19//   ao cliente via WhatsApp
20
21return rec;
api reference

Endpoints principais

Tudo que você precisa para cobrar, conciliar e emitir nota fiscal — em REST padrão.

POST/v1/customers
Cria cliente vinculado a CPF ou CNPJ.
POST/v1/recurrences
Recorrência fixa, variável ou parcelada no Pix.
POST/v1/charges
Cobrança única (Pix tradicional).
GET/v1/recurrences/:id
Status, parcelas e histórico do ciclo.
DEL/v1/recurrences/:id
Cancela cobranças futuras (parcelas pagas permanecem).
POST/v1/invoices
Emite NF-e avulsa fora do fluxo da recorrência.
POST/v1/webhooks
Assina eventos: paid, failed, authorized, cancelled…
GET/v1/events
Stream / polling para reprocessar eventos.
Referência completa em docs.cobranzo.com/reference
webhooks

Eventos idempotentes em tempo real.

Toda mudança de estado vira evento. Retry com backoff exponencial até 24h. Cabeçalho Cobranzo-Signature para verificação HMAC.

▸ recurrence.authorized 14:02:11
▸ charge.paid 14:02:48
▸ invoice.emitted NF-e 00482
▸ webhook.delivered 200 OK · 142ms
▸ recurrence.active cycle 1/12
webhook.ts — your-app
1app.post('/hooks/cobranzo', async (req, res) => {
2  const sig = req.headers['cobranzo-signature'];
3
4  // Verifica assinatura HMAC
5  const event = cobranzo.webhooks.construct(
6    req.body, sig, env.WEBHOOK_SECRET
7  );
8
9  switch (event.type) {
10    case 'charge.paid':
11      await grantAccess(event.data.customer_id);
12      break;
13    case 'recurrence.cancelled':
14      await revokeAccess(event.data.customer_id);
15      break;
16  }
17
18  res.json({ received: true });
19});
pricing

Pricing que não cresce com o seu GMV.

Pacote mensal fechado, sem percentual sobre transação. Você paga pelo acesso à infra — não pela sua receita.

// diferente de outros gateways: eles cobram percentual sobre cada transação sua. Quanto mais você fatura, mais pagam eles. Aqui é pacote fechado — seu faturamento é seu.
// starter
Essencial
Para quem está começando com modelos de venda de assinaturas.
R$ 99,00 / mês
  • Sandbox espelhada da produção
  • Webhooks ilimitados
  • NF-e automática inclusa
  • 0% sobre transação
Fale com a gente
Recomendado // pro
Profissional
Para negócios que já operam com volume e precisam de mais capacidade mensal.
R$ 249,00 / mês
  • Volume maior em produção
  • 0% sobre transação
  • NF-e automática inclusa
  • Suporte prioritário
Fale com a gente
// scale
Corporativo
Para empresas com grande volume de assinaturas e operações mais maduras.
R$ 899,00 / mês
  • Volume sem limite, preço fixo
  • 0% sobre transação
  • SLA dedicado · IP fixo
  • White-label opcional
Fale com a gente

* valores reais ajustados com você no onboarding.

status.cobranzo.com

Status page público

Uptime real, incidentes detalhados e RSS para seu canal de incidentes.

API · Pagamentos
Operacional
99.98% · últimos 90d
Webhooks
Operacional
99.95% · últimos 90d
NF-e
Degradado
prefeitura X intermitente
// uptime histórico (90d)
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
01/fevhoje
→ Receber atualizações por e-mail ou WhatsApp
Comece em 10 minutos

Pronto para cobrar
no Pix Automático?

Sem cartão de crédito para começar. Configuração em 10 minutos. Primeira cobrança sai hoje.

Fale com a gente Sou dev · ver API
Sem fidelidade · cancele quando quiser
Prefere falar com a gente?

Comercial e suporte em dias úteis, das 09:00 às 18:00.

Fale com a gente