Spot
Generar un widget token
Endpoint server-side para mintear un widget token de un solo uso.
Tu backend llama a este endpoint para mintear un token y luego redirige o embebe la URL retornada.
Endpoint
POST /api/spot/widget?public_key={tu_public_key}Query opcional:
| Query param | Notas |
|---|---|
long_term_token=true | Extiende el TTL de 1 hora a 30 días. |
expires_in_minutes | TTL personalizado en minutos (alternativa a long_term_token). |
Cuerpo de la request
{
"rut": "12345678-9",
"user_data": {
"name": "María",
"surname": "González",
"email": "maria@example.com",
"phone_number": "+56912345678"
},
"metadata": {
"retry_url": "https://tu-sitio.com/retry"
},
"order_token": "2f88b330-f3ed-5521-aa1f-9d15af1fce8d"
}| Campo | Obligatorio | Notas |
|---|---|---|
rut | sí | RUT chileno. Se acepta con o sin puntos. Ver Conceptos → RUT. |
user_data | no | Pre-llena el formulario del paciente dentro del widget. El paciente puede editarlo. |
metadata.retry_url | no | URL de redirección si el paciente cancela a mitad de flujo. |
order_token | no | El hash (UUID) que retorna POST /orders. Su presencia activa el flujo AAPD; debe ser un UUID válido. |
expense_subtypes | no | Restringe los subtipos de gasto habilitados en el widget. |
provider_data | no | Solo meta-prestadores: datos del sub-prestador. |
Respuesta
{
"widget_token": "550e8400-e29b-41d4-a716-446655440000",
"url": "https://spot.getskip.ai?widget_token=550e8400-...&public_key=pk_xxx"
}Usa url directamente como src de un iframe, o ábrelo en una pestaña nueva.
Errores
| Status | Significado | Recuperación |
|---|---|---|
| 401 | public_key inválida o inactiva | Confirma la clave con Skip. Verifica que tu Provider esté activo. |
| 400 | provider_data enviado por un no-meta-provider | Quítalo, o pide a Skip habilitar modo meta-prestador. |