Kobana

Toda la regla de cobranza, disponible por API

API REST v1 para personas, cobros, reglas, acuerdos, disputas, tareas, plantillas y notificaciones. Autenticación por api-key, webhooks de salida firmados, OpenAPI y colección Postman listas para importar.

API Pública
Página de desarrolladores con autenticación, descargas OpenAPI/Postman y endpoints
80+
endpoints en la API v1
25+
recursos disponibles
HMAC
firma en los webhooks de salida
OpenAPI
especificación y Postman incluidos

De la api-key a la automatización completa en cuatro pasos

1

Genera tu api-key

En el área de desarrolladores del panel, con control y revocación por clave.

2

Integra los recursos

Los mismos recursos de la interfaz: crear cobros, vincular reglas, consultar telemetría, abrir disputas, registrar acuerdos.

3

Firma los webhooks

Configura endpoints de salida para recibir eventos, con secreto firmado y rotación.

4

Automatiza

Tu ERP crea los cobros; la regla se encarga del resto.

Los mismos recursos de la interfaz, listos para integrar

Recursos Completos
Personas, cobros, reglas y etapas, clasificaciones, plantillas, notificaciones, interacciones, tareas, acuerdos y cuotas, disputas, reportes negativos, protestos, importaciones y exportaciones.
  • Mismas reglas de negocio que la interfaz
  • Máquinas de estado respetadas en la API
  • Panel y métricas de recuperación por endpoint
Autenticación Doble
Sesión para el panel, api-key para integraciones servidor a servidor.
  • Creación y revocación de claves en el panel
  • Rastreo de origen por clave
  • Alcance por workspace
Webhooks de Salida
Recibe eventos de la Regla de Cobranza en tu sistema, con firma verificable y rotación de secreto.
  • Endpoints configurables por evento
  • Rotación de secreto con un clic
  • Historial de entregas consultable
Acciones de Dominio
Además del CRUD, endpoints de acción: notificar cobro, aceptar y cancelar acuerdo, resolver disputa, completar tarea, reclasificar persona, emitir enlace del portal.
  • POST /v1/charges/{id}/notify
  • POST /v1/agreements/{id}/accept
  • POST /v1/people/{id}/portal-link
Auditoría por la API
Logs de auditoría consultables por endpoint — la misma huella inmutable de la interfaz, integrable a tu SIEM o BI.
  • Filtros por entidad y actor
  • Antes/después en cada registro
  • Append-only garantizado por la base de datos
Importación y Exportación
Importa carteras por archivo, exporta cualquier recurso y sigue los jobs de procesamiento.
  • Importación idempotente
  • Exportación asíncrona con descarga
  • Estado del job consultable

Integra en minutos

Ejemplo de creación de un cobro vía API:

# Crear un cobro
curl -X POST https://app.dunning.kobana.com.br/api/v1/charges \
  -H "Authorization: Bearer SUA_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"
  }'
Endpoints de webhook con historial de entregas

Webhooks de salida: endpoints configurables con historial de entregas y rotación de secreto.

Preguntas frecuentes

Integra tu sistema a la regla

Habla con nosotros para recibir acceso a la documentación interactiva y una clave de prueba.