Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.siplex.cl/llms.txt

Use this file to discover all available pages before exploring further.

El link de activación es una página hosted donde tu cliente sube su certificado digital (.pfx) y API key de Simple API. Tú no necesitas construir UI para esto.

​
Flujo

Tu SaaS                    Nuestra API              Tu cliente
  │                             │                       │
  ├── POST /activation-link ───►│                       │
  │◄── { url, expiresAt } ─────┤                       │
  │                             │                       │
  ├── envía url por email ──────┼──────────────────────►│
  │                             │                       │
  │                             │◄── abre url ──────────┤
  │                             │◄── sube .pfx ─────────┤
  │                             │◄── ingresa API key ───┤
  │                             │                       │
  │◄── webhook: credentials ────┤                       │
  │    updated                  │                       │

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/activation-link \
  -H "Authorization: Bearer sk_live_..."
Respuesta: 
{
  "token": "act_abc123...",
  "url": "https://app.example.com/activate/act_abc123...",
  "expiresAt": "2024-04-07T00:00:00Z"
}

​
Qué ve tu cliente

La página de activación guía al usuario en 2 pasos:
  1. API Key de Simple API — campo de texto enmascarado
  2. Certificado digital — drag-and-drop de archivo .pfx con password, RUT, nombre y fecha de vencimiento
Cuando ambos pasos están completos, el token se marca como completado y recibes un webhook.

​
Token

  • Expira en 7 días por defecto
  • Se puede generar un nuevo link en cualquier momento (el anterior se invalida)
  • El token se hashea con SHA-256 antes de almacenarse
  • Es de un solo uso — una vez completado, no se puede reutilizar

​
Saber cuándo terminó

Configura un webhook para el evento tenant.credentials.updated. Se dispara automáticamente cuando tu cliente completa la activación. 
{
  "event": "tenant.credentials.updated",
  "data": {
    "tenantId": "uuid",
    "apiKey": { "configured": true },
    "certificate": { "configured": true }
  }
}