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 POST JSON con los encabezados X-Reimber-Event (el nombre del evento) y X-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