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.
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.
Três decisões de arquitetura que mudam o que você consegue construir em cima.
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.
REST consistente, webhooks idempotentes, SDKs tipados, sandbox espelhada e mensagens de erro descritivas. Você não precisa "aprender o jeito brasileiro" de integrar.
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.
Sandbox espelhada da produção. SDKs pra Node, Python, Go e PHP. Webhooks de evento real desde o primeiro request.
Acesse o dashboard, gere uma cbz_test_* e copie pra sua env.
Disponível para node, python, go e php — ou use REST direto.
Uma chamada POST /v1/recurrences e o seu cliente recebe a autorização via WhatsApp.
Eventos idempotentes para recurrence.authorized, charge.paid, invoice.emitted.
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;
1from cobranzo import Cobranzo 2 3cbz = Cobranzo(api_key=os.environ['CBZ_KEY']) 4 5# Cria recorrência parcelada (12× R$ 197 no Pix) 6rec = cbz.recurrences.create( 7 customer_id='cus_8d9f7e6c', 8 amount=19700, 9 installments=12, 10 frequency='monthly', 11 start_date='2026-05-10', 12 payment_method='pix', 13 description='Assinatura Plano Pro', 14 invoice={'auto_emit': True}, 15 webhook=os.environ['HOOK_URL'], 16) 17 18# → rec.id == "rec_1234567890"
1# POST /api/v1/recurrences 2$ curl https://cobranzo.com/api/v1/recurrences \ 3 -H "Authorization: Bearer cbz_test_1234567890" \ 4 -H "Content-Type: application/json" \ 5 -d '{ 6 "customer_id": "cus_8d9f7e6c", 7 "amount": 19700, 8 "installments": 12, 9 "frequency": "monthly", 10 "payment_method": "pix", 11 "description": "Assinatura Plano Pro" 12 }' 13 14# ← 201 Created 15# ← {"id":"rec_1234567890","status":"awaiting_authorization", ... }
Tudo que você precisa para cobrar, conciliar e emitir nota fiscal — em REST padrão.
Toda mudança de estado vira evento. Retry com backoff exponencial até 24h. Cabeçalho Cobranzo-Signature para verificação HMAC.
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});
Pacote mensal fechado, sem percentual sobre transação. Você paga pelo acesso à infra — não pela sua receita.
* valores reais ajustados com você no onboarding.
Sem cartão de crédito para começar. Configuração em 10 minutos. Primeira cobrança sai hoje.
Comercial e suporte em dias úteis, das 09:00 às 18:00.
oi@cobranzo.com +55 11 3149-6169