Documentación de la API

La API de Makatea recibe clientes, cuotas y pagos de tu sistema. Te avisa por webhook cuando alguien paga, promete o contesta.

URL base
https://makatea.ai/api
Autenticación
Llave mk_live_ en Authorization: Bearer. Se crea en Configuración → Desarrolladores.
Formato
JSON. El éxito viene en { data } y el error en { error: { code, message, request_id } }.
Estado
GET /v1/status contesta sin llave.

Guías

  • Primeros pasosCrea una llave, da de alta un cliente con su primera cuota y recibe un webhook cuando se pague.
  • Carga históricaSube tu cartera actual con su historial de pagos sin mandar un solo mensaje por error.
  • Conciliación diariaTrae una vez al día todos los pagos que Makatea registró y cuádralos contra tu sistema y tu banco.

Referencia

  • Rutas y objetosCada ruta con sus parámetros y sus respuestas
  • referencia.mdLa misma referencia en markdown para leerla como texto o dársela a un agente
  • openapi.jsonEl spec OpenAPI 3 para generar un cliente o importarlo en Postman
  • llms.txtEl índice de esta documentación para herramientas de IA

Último cambio

23 de septiembre de 2026 · Llaves de API, idempotencia, webhooks firmados y cartera de crédito

Sin programar

Para cargar tu cartera una sola vez no hace falta la API. La app importa CSV o la hoja de Excel de Makatea. O mándanos tu Excel y la cargamos por ti.