Kobana

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.

API do Faturamento Automático para desenvolvedores
300+
endpoints na API
40+
eventos de webhook
3
SDKs oficiais
99.9%
de uptime

Tudo que você precisa para integrar

REST API Completa
300+ endpoints cobrindo todos os recursos: assinaturas, faturas, pagamentos, clientes, produtos e mais. JSON padronizado em todas as respostas.
Webhooks em Tempo Real
40+ tipos de eventos para sincronizar sua aplicação. Assinatura HMAC-SHA256 em todas as notificações para validação segura.
Sandbox Isolado
Ambiente de testes completamente isolado. Cartões de teste para simular diferentes cenários de pagamento.
SDKs Multi-linguagem
Bibliotecas oficiais para Node.js/TypeScript, Python e Ruby. Comece a integrar em minutos com tipagem completa.
5 Minutos para Integrar
Da criação da conta ao primeiro request em menos de 5 minutos. Documentação clara com exemplos prontos para usar.
Documentação Interativa
Explore e teste a API diretamente no navegador. Exemplos em todas as linguagens e respostas detalhadas.
5 minutos

Da instalação ao primeiro request

Instale o SDK, configure sua API key e crie sua primeira assinatura. Simples assim.

1
Instale o SDK da sua linguagem
2
Configure sua API key do sandbox
3
Faça seu primeiro request
bash
# 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.

Node.js / TypeScript
npm install @kobana/produtos/faturamento-automatico
Ver no GitHub
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
});
Webhooks

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.expired

Faturas

invoice.createdinvoice.sentinvoice.paidinvoice.overdueinvoice.canceled

Pagamentos

payment.createdpayment.confirmedpayment.failedpayment.refundedpayment.charged_back

Clientes

customer.createdcustomer.updatedcustomer.payment_method_updated
Exemplo de handler
Valide a assinatura e processe os eventos
import { 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');
  }
});
Sandbox

Ambiente de testes isolado

Teste sua integração sem processar transações reais. Use cartões de teste para simular diferentes cenários.

Cartões de teste
Use estes números para simular diferentes comportamentos
4242 4242 4242 4242
Sempre aprova
4000 0000 0000 0002
Sempre recusa
4000 0000 0000 3220
Requer 3DS

Use 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.

1
Crie sua conta sandbox
Acesse o dashboard e gere suas credenciais de teste em segundos.
2
Configure produtos e planos
Cadastre seus produtos, defina preços e ciclos de faturamento.
3
Integre sua aplicação
Use nossos SDKs ou chamadas REST diretas para criar assinaturas.
4
Configure webhooks
Receba notificações de pagamentos, renovações e cancelamentos.
5
Teste com cartões simulados
Valide todos os cenários: aprovação, recusa, 3DS e disputas.
6
Migre para produção
Troque as credenciais e comece a processar pagamentos reais.

Seguranç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.