Desarrolladores y automatización
Una API REST, webhooks y firma electrónica para los sistemas que rodean tu cartera de préstamos
Usa la API para leer y escribir prestatarios, préstamos y reembolsos desde tu propio software, los webhooks para enterarte de los cambios en el momento en que ocurren, y la firma electrónica integrada para que se firmen los documentos del préstamo sin un servicio de firma aparte.
curl "https://api.lendbox.io/borrowers?page=1&limit=20" \
-H "Authorization: Bearer live_your_api_key"- Estado
- Integrada
- Planes
- API en Business, Growth y Enterprise
- Entornos
- Sandbox y producción
- Documentación
- api.lendbox.io/docs
Inicio rápido
Cuatro pasos desde cero hasta tu primera respuesta.
- 1Genera una claveEn el panel, abre API Integration → REST API y selecciona Generate New API Key. Guárdala en un lugar seguro. Al generar una clave nueva, la anterior deja de funcionar, así que cámbiala cada vez que se vaya alguien que tenía acceso.
- 2Elige el entornoSandbox y producción son entornos separados, cada uno con su propia URL base, sus claves y sus datos: https://sandbox-api.lendbox.io y https://api.lendbox.io. Las claves de sandbox empiezan por sandbox_ y las de producción por live_. Desarrolla primero contra sandbox.
- 3Envía la clave en cada peticiónPásala como token bearer en el encabezado Authorization. Los códigos de respuesta que devuelve la API aparecen en esa misma página del panel.
- 4Trabaja con la referenciaCada endpoint, parámetro y estructura de respuesta está en la documentación pública de api.lendbox.io/docs. La lista de prestatarios, por ejemplo, se pagina con los parámetros page y limit.
Una clave por espacio de trabajo, junto con el encabezado en el que se envía y las dos URL base.
Qué construyen los equipos sobre ella
La mayoría de las integraciones responden a uno de cuatro patrones. Todos usan endpoints que ya figuran en la referencia pública.
Altas desde tu propia app
Crea prestatarios y préstamos desde tu propio sitio web o tu app de alta con peticiones POST, para que una solicitud recibida fuera de Lendbox nunca tenga que teclearse dos veces.
Registrar reembolsos desde otro canal
Cuando el dinero llega a un sitio con el que Lendbox no se conecta, como una cuenta bancaria o una nómina, registra el reembolso en su préstamo con una sola llamada desde el sistema que lo recibió.
Alimentar tus propios informes
Lee prestatarios, préstamos y reembolsos de forma programada en un almacén de datos o una herramienta de BI, y usa los webhooks para saber qué registros cambiaron entre una lectura y otra.
Lanzar tus propios flujos de trabajo
Usa el evento de creación de reembolso para enviar un agradecimiento desde tu CRM, o el evento de creación de préstamo para abrir un expediente en tu sistema documental.
Cómo funcionan las claves de API
- Una clave por espacio de trabajo. Actúa con el acceso del propietario del espacio de trabajo, así que trátala como la contraseña del propietario y guárdala en tu servidor, nunca en un navegador ni en una app.
- Las claves no caducan por sí solas. Regenera la clave desde el panel para revocarla.
- Ver y gestionar la página de la API es un permiso de personal propio, así que puedes limitarlo a las personas que crean integraciones.
- El acceso a la API está incluido en los planes Business, Growth y Enterprise.
Webhooks: entérate de los cambios en el momento en que ocurren
Añade un webhook en API Integration → Webhooks: introduce la URL de un endpoint que controles y marca los eventos que debe recibir. Lendbox envía un POST con JSON a esa URL cada vez que ocurre uno de ellos.
| Registro | Creado | Actualizado | Eliminado |
|---|---|---|---|
| Préstamo | Sí | Sí | Sí |
| Prestatario | Sí | Sí | Sí |
| Reembolso | Sí | Sí | Sí |
| Inversor | Sí | Sí | Sí |
| Producto de inversión | Sí | Sí | Sí |
| Cuenta de inversor | Sí | Sí | Sí |
POST /your/webhook/endpoint
Content-Type: application/json
X-LendBox-Event: <event name>
X-LendBox-Webhook-ID: <your webhook's id>- X-LendBox-Event
- Qué evento se ha producido, para que un mismo endpoint pueda gestionar varios.
- X-LendBox-Webhook-ID
- Cuál de tus webhooks envió la entrega.
Cómo construir un receptor robusto
Responde rápido
Lendbox espera diez segundos a que tu endpoint responda. Confirma primero la recepción de la entrega y haz después el trabajo lento.
Trata cada entrega como un aviso
Antes de actuar sobre un evento, obtén desde la API el préstamo, el prestatario o el reembolso que menciona. Así tienes el registro actual y confirmas que el evento es auténtico.
Concilia de forma programada
Cada evento se entrega una sola vez. Una lectura nocturna a través de la API recoge todo lo que tu endpoint se perdió mientras estaba caído, y los manejadores idempotentes hacen que una repetición no cause daño.
Firma electrónica integrada para los documentos del préstamo
Los contratos de préstamo, los extractos y los cronogramas de pago se firman dentro de Lendbox, así que la copia firmada queda en el préstamo y no en la cuenta de otro servicio.
1Crea la plantilla
En Documents → Loan Templates, redacta el contrato en el editor con marcadores para los datos del prestatario y del préstamo, o sube un documento de Word que ya incluya los marcadores.
2Marca dónde se firma
En tus propias plantillas, colocas una vez los campos de firma y de texto, y cada préstamo que usa esa plantilla recibe las mismas zonas de firma. El Loan Statement y el Repayment Schedule integrados ya llegan con sus bloques de firma colocados.
3Envía los enlaces
Desde la pestaña Documents del préstamo, elige Send for Signature. Firma tú, envía al prestatario su enlace por correo electrónico, añade al oficial de crédito y añade otros firmantes, como un familiar de contacto.
4Recoge las firmas
Cada firmante dibuja su firma en pantalla y la guarda. Cada firma genera una nueva versión del PDF, así que la contrafirma funciona y las versiones anteriores siguen en el préstamo.
Los enlaces de firma van al prestatario, al oficial de crédito y a cualquier otra persona que añadas.
Cada enlace de firma funciona una sola vez y caduca a los siete días.
Qué guarda el registro de firma
Se registra
- El nombre y el rol del firmante: prestatario, oficial de crédito u otro
- Cuándo firmó
- Cada versión del documento, antes y después de cada firma
No se registra
- Un código de un solo uso: no se envía ninguno, así que lo que identifica al firmante es tener el enlace recibido por correo
- La dirección IP o el dispositivo del firmante
- Un certificado de finalización aparte
El personal puede guardar su propia firma en Settings → Admin → My signature y después rellenar con un clic todos los campos que tenga asignados.
Preguntas frecuentes
- Sí. Es una API REST con documentación pública en api.lendbox.io/docs, entornos sandbox y de producción separados, y autenticación con token bearer mediante una clave que generas en el panel.
- Business, Growth y Enterprise. La firma electrónica está incluida en todos los planes.
- Sí. Suscríbete al evento de creación de reembolso. Lendbox envía un POST a tu endpoint cuando se crea el reembolso, y después puedes obtenerlo desde la API para tener el registro completo.
- Depende de la legislación del lugar donde prestas y del documento, así que consúltalo con tu asesor jurídico. Lendbox registra quién firmó, con qué rol y cuándo, y guarda en el préstamo cada versión del PDF firmado.
- Sí. El enlace de firma se abre en el navegador del teléfono y el prestatario dibuja su firma con el dedo. No hay nada que instalar.
- Puedes desarrollarlo. La API lee prestatarios, préstamos y reembolsos, y los webhooks anuncian los cambios, así que un desarrollador puede enviarlos a otro sistema. No hay un conector listo para usar con QuickBooks ni con Xero.
¿Tiene Lendbox una API pública?
¿Qué planes incluyen acceso a la API?
¿Puede un webhook avisarme cuando se registra un reembolso?
¿Son legalmente vinculantes las firmas electrónicas de Lendbox?
¿Pueden firmar los prestatarios en su teléfono?
¿Puedo conectar Lendbox con un software de contabilidad mediante la API?
Sigue leyendo
- Todas las integracionesIntegraciones de LendboxDinero móvil en Zambia, recordatorios por SMS y WhatsApp, importación desde Excel, la API REST y los webhooks, cada uno con su forma de conexión indicada.
- RelacionadoSeguridad y controlesPermisos por módulo y por rol, doble control y la pista de auditoría.
- RelacionadoResumen de seguridadCifrado, alojamiento, copias de seguridad y cómo informar de una vulnerabilidad.
- RelacionadoCanales de reembolso del prestatarioDónde encajan los enlaces de firma entre el portal, los enlaces de pago y los extractos.
- RelacionadoContabilidad integradaEl libro mayor en el que se registra cada préstamo, reembolso y comisión.
- RelacionadoMigración de datosTraer prestatarios y préstamos mediante Excel en lugar de a través de la API.
Desarrolla sobre Lendbox
Comienza una prueba gratuita, lee la referencia de la API y conecta producción cuando estés listo.
No se requiere tarjeta