Link de activación - Siplex

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                  │                       │

Generar el link

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/activation-link \
  -H "Authorization: Bearer sk_live_..."

const { url, expiresAt } = await fetch(
  `https://api.example.com/api/v1/tenants/${tenantId}/activation-link`,
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer sk_live_...' },
  }
).then(r => r.json())

// Envía `url` a tu cliente
await sendEmail(clientEmail, {
  subject: 'Configura tu facturación electrónica',
  body: `Completa tu activación aquí: ${url}`,
})

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:

API Key de Simple API — campo de texto enmascarado
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 }
  }
}