Skip to main content
Para organization_type = comercio: aceptas pagos en tu propio nombre (e-commerce, checkout en app, facturación por suscripción). Tu integración se centra en pay-in assess antes de la captura.

​
Módulos que necesitas

​
Fases de integración

1

Fase 1 — Claves y sandbox

  1. Conexiones → Claves API — crea Publishable (clm_pub_*) y Secret (clm_sk_*) con permiso Assess.
  2. Ejecuta el Inicio rápido contra sandbox.
  3. Prueba escenarios en Simulación — Guía de simulación.
2

Fase 2 — Prevención en checkout

Patrón recomendado: SDK en navegador para señales de dispositivo → assess en servidor con clm_sk_* antes de la captura del PSP.
  1. Incrusta el SDK para navegador en el checkout.
  2. Al enviar el pago, tu backend llama POST /api/v1/assess con:
    • amount, currency (decimal mayor preferido — consulta la guía de assess)
    • order_id (clave de idempotencia estable)
    • device.ip de la solicitud HTTP
    • email o customer_id
    • payment_method (BIN/last4 para reglas de tarjeta)
    • session_id del SDK cuando esté disponible
  3. Ramifica según decision: procede solo con approve (o tu política para review / challenge).
  4. Tu servidor llama a Stripe / Mercado Pago / tu PSP — Clausum no captura por ti.
Consulta Arquitectura — ciclo de protección.
3

Fase 3 — Notificaciones asíncronas

  1. Conexiones → Empezar → Webhooks salientes — configura la URL saliente.
  2. Suscríbete a transaction.created y transaction.blocked.
  3. Verifica X-Clausum-Signature — Recibir webhooks.
  4. Incluye clausum_session_id en los metadatos del PSP al capturar.
4

Fase 4 — Post-pago (opcional)

En Conexiones → Entrada, empieza por el webhook genérico (Ingest de eventos + clm_wh_*).
Las guías por procesador (p. ej. Stripe) son ayudas secundarias — no un catálogo de logos.El ingest post-pago no sustituye el assess en checkout.
5

Fase 5 — Operaciones y go-live

  1. Configura Protección — reglas, blocklists, umbrales.
  2. Implementa política fail-open de Resiliencia de assess para 503 / 504.
  3. Capacita al equipo en Monitor de Transacciones.
  4. Ante fraude confirmado → Reportar fraude.
  5. Claves de producción en https://dashboard.clausum.ai (o tu host asignado).

​
Campos obligatorios de assess (pay-in)

Descubre requisitos en vivo: GET /api/v1/assess → field_requirements_by_segment.merchant.

​
Checklist de go-live

  • Assess en servidor con clm_sk_* antes de cada captura
  • order_id estable por intento de checkout
  • URL de webhook saliente probada en sandbox
  • Política de resiliencia documentada para mantenimiento / timeout
  • Roles de equipo asignados — Equipo y acceso
  • Límites de tasa comprendidos — Límites de tasa

​
Profundización en capacidades

Assess en tiempo real

Payload, decisiones, montos

SDK para navegador

Huella de dispositivo

Webhooks

Firmas y eventos

Todas las capacidades

Catálogo de módulos por segmento