La regla de cobro como infraestructura de tu producto
API REST v1 completa, webhooks firmados en ambos sentidos, OpenAPI y colección Postman. Tu sistema crea los cobros; el motor se encarga del resto — con idempotencia de punta a punta.
Todo lo que necesitas para integrar
De la api-key al primer cobro en la regla
Crea la persona, crea el cobro y vincúlalo a una regla. A partir de ahí, la regla acompaña el cobro sola: notifica, ofrece acuerdo, pausa excepciones y cierra cuando llegue el pago.
# Crear una persona
curl -X POST https://app.dunning.kobana.com.br/api/v1/people \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Empresa Ejemplo SA",
"document": "12345678000190",
"email": "finanzas@ejemplo.com.br"
}'
# Crear un cobro vinculado a una regla
curl -X POST https://app.dunning.kobana.com.br/api/v1/charges \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"person_id": "per_123",
"amount": 450.00,
"due_date": "2026-08-15",
"collection_rule_id": "rule_456"
}'Recibe eventos en tu sistema
Configura endpoints de salida y recibe los eventos de la regla — cobro pagado, acuerdo aceptado, disputa abierta, notificación entregada — con firma verificable.
- ✓Firma HMAC en cada entrega
- ✓Rotación de secreto:
POST /v1/webhook-endpoints/{id}/rotate-secret - ✓Historial de entregas consultable
Envía eventos de pago
En modo standalone, registra señales de pago con evidencia y nivel de confianza — el motor interrumpe la regla al instante.
# Crear un endpoint de webhook
curl -X POST https://app.dunning.kobana.com.br/api/v1/webhook-endpoints \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://tusistema.com.br/webhooks/dunning",
"events": ["charge.paid", "agreement.accepted", "dispute.opened"]
}'
Flujo de integración
De la cuenta Kobana a la telemetría en 6 pasos.
Seguridad en cada capa
De la autenticación a la auditoría, todo fue pensado para operaciones de cobranza que necesitan probar cada paso.
- ✓OAuth2 Kobana: identidad unificada con la plataforma
- ✓Api-keys revocables: control por clave y workspace
- ✓Webhooks firmados: HMAC con rotación de secreto
- ✓Límite de tasa: protección en endpoints sensibles (portal y verificación de identidad)
- ✓Auditoría inmutable: de solo agregado garantizada por Postgres, consultable vía API
- ✓Tokens de portal: almacenados solo como hash SHA-256
Preguntas frecuentes
¿Listo para poner la regla en tu producto?
Agenda una demostración y mira la API, los webhooks y la telemetría funcionando con un escenario de cartera completo.