Construído por devs, para devs
API REST bem documentada, webhooks em tempo real e SDKs multi-linguagem. Integre faturamento recorrente em minutos, não em semanas.

Tudo que você precisa para integrar
Da instalação ao primeiro request
Instale o SDK, configure sua API key e crie sua primeira assinatura. Simples assim.
# Instale o SDK
npm install @kobana/produtos/faturamento-automatico
# Ou use curl diretamente
curl -X POST https://api.billing.kobana.com.br/v1/subscriptions \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"customer_id": "cus_123",
"plan_id": "plan_456",
"payment_method": "credit_card"
}'SDKs oficiais
Bibliotecas nativas com tipagem completa e documentação integrada.
import { KobanaBilling } from '@kobana/produtos/faturamento-automatico';
const billing = new KobanaBilling({
apiKey: process.env.KOBANA_BILLING_API_KEY,
});
// Criar uma assinatura
const subscription = await billing.subscriptions.create({
customerId: 'cus_123',
planId: 'plan_456',
paymentMethod: 'credit_card',
});
// Listar faturas
const invoices = await billing.invoices.list({
customerId: 'cus_123',
status: 'paid',
});
// Emitir reembolso
const refund = await billing.refunds.create({
paymentId: 'pay_789',
amount: 5000, // R$ 50,00
});40+ eventos em tempo real
Receba notificações instantâneas sobre tudo que acontece com suas assinaturas, faturas e pagamentos. Todos os webhooks são assinados com HMAC-SHA256.
Assinaturas
subscription.createdsubscription.activatedsubscription.renewedsubscription.canceledsubscription.expiredFaturas
invoice.createdinvoice.sentinvoice.paidinvoice.overdueinvoice.canceledPagamentos
payment.createdpayment.confirmedpayment.failedpayment.refundedpayment.charged_backClientes
customer.createdcustomer.updatedcustomer.payment_method_updatedimport { KobanaBilling } from '@kobana/produtos/faturamento-automatico';
import express from 'express';
const app = express();
// Middleware para verificar assinatura do webhook
app.post('/webhooks/produtos/faturamento-automatico', express.raw({ type: 'application/json' }), (req, res) => {
const signature = req.headers['x-kobana-signature'];
const webhookSecret = process.env.KOBANA_WEBHOOK_SECRET;
try {
// Verificar assinatura HMAC-SHA256
const event = KobanaBilling.webhooks.constructEvent(
req.body,
signature,
webhookSecret
);
// Processar evento
switch (event.type) {
case 'invoice.paid':
console.log('Fatura paga:', event.data.id);
// Liberar acesso ao serviço
break;
case 'subscription.canceled':
console.log('Assinatura cancelada:', event.data.id);
// Revogar acesso
break;
case 'payment.failed':
console.log('Pagamento falhou:', event.data.id);
// Notificar cliente
break;
}
res.json({ received: true });
} catch (err) {
console.error('Webhook inválido:', err.message);
res.status(400).send('Webhook Error');
}
});Ambiente de testes isolado
Teste sua integração sem processar transações reais. Use cartões de teste para simular diferentes cenários.
4242 4242 4242 42424000 0000 0000 00024000 0000 0000 3220Use qualquer data de validade futura e qualquer CVV de 3 dígitos.
Fluxo típico de integração
Do sandbox a produção em 6 passos simples.
Recursos para desenvolvedores
Documentação
Guias completos, tutoriais e referência da API.
AcessarStatus Page
Monitore a disponibilidade da API em tempo real.
AcessarChangelog
Acompanhe as últimas atualizações e novidades.
AcessarColeção Postman
Importe e teste todos os endpoints rapidamente.
AcessarOpenAPI Spec
Especificação completa para geração de código.
AcessarCLI
Gerencie recursos diretamente do terminal.
AcessarSegurança em primeiro lugar
Todas as comunicações são protegidas com as melhores práticas do mercado.
- ✓HTTPS obrigatório: Todas as comunicações são criptografadas com TLS 1.3
- ✓API Keys com escopo: Controle granular de permissões por token
- ✓Webhooks assinados: Validação HMAC-SHA256 em todas as notificações
- ✓Rate limiting: Proteção contra abusos com limites generosos
- ✓PCI DSS: Dados de cartão tokenizados e nunca armazenados
Perguntas frequentes
Pronto para começar a integrar?
Crie uma conta sandbox gratuita e comece a testar em minutos. Sem compromisso, sem cartão de crédito.
