Desarrolladores
API y Webhooks
Conecta Reimber con tus propios sistemas: llama la API con una llave de API y recibe webhooks firmados cuando algo cambia.
Autenticación
Las llaves de API se emiten por empresa. El secreto se muestra una sola vez al crear la llave, así que guárdalo en un lugar seguro. Envía ambos valores como encabezados en cada solicitud.
curl https://YOUR_API_HOST/v1/... \
-H "x-api-key: YOUR_API_KEY" \
-H "x-api-secret: YOUR_API_SECRET" Las llaves de API están disponibles a solicitud durante la implementación. Nunca las expongas en un navegador ni en una app móvil.
Webhooks
Agrega un endpoint en Configuración → Integraciones → Webhooks, elige los eventos que quieres (o todos) y envía un evento de prueba desde la misma pantalla.
Eventos disponibles
- invoice.created
- invoice.paid
- invoice.overdue
- invoice.voided
- payment.received
- payment.failed
- dispute.opened
- dispute.resolved
- activity.completed
Entrega
- Cada entrega es un
POSTJSON con los encabezadosX-Reimber-Event(el nombre del evento) yX-Reimber-Signature. - Responde con cualquier estado 2xx en menos de 10 segundos.
- Las entregas fallidas se reintentan hasta 5 veces con espera exponencial (2, 4, 8, 16 y 32 segundos).
Verificar la firma
import crypto from 'node:crypto';
// rawBody: the exact request body as received (string or Buffer)
function isValidReimberSignature(rawBody, signatureHeader, webhookSecret) {
const expected =
'sha256=' +
crypto.createHmac('sha256', webhookSecret).update(rawBody).digest('hex');
return (
signatureHeader.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(signatureHeader), Buffer.from(expected))
);
} ¿Necesitas la referencia completa de endpoints?
Crea tus API keys en la aplicación y escribe a support@reimber.com para recibir la referencia completa de endpoints.
Prueba Gratis 14 Días