Conceptos
Glosario
Cada término que aparece en la documentación de Skip, definido una sola vez.
| Término | Definición |
|---|---|
| AAPD / CNPL | "Atiéndete Ahora y Paga Después" / Care Now, Pay Later. El producto de financiamiento sanitario de Skip. |
| Beneficiary | Una ficha de paciente en Skip. Pertenece a un User (titular de cuenta), identificada por rut. Un usuario puede tener varios beneficiarios (él/ella + familia). |
client_id | Credencial SkipPay, browser-safe. Para operaciones del paciente en AAPD (validar identidad, agregar método de pago, capturar). |
client_secret | Credencial SkipPay, solo server-side. Para creación de órdenes, reembolsos y operaciones admin. Nunca en código de browser. |
| ISAPRE | Aseguradora privada de salud chilena. Los pacientes presentan reembolsos a su ISAPRE. Skip lo hace en su nombre. |
| Issuer RUT | El RUT de la entidad que emitió una boleta — usualmente la clínica o farmacia. Distinto del RUT del médico. |
| Meta-prestador | Partner que opera con muchas sub-clínicas detrás de una integración. Reservo (meta-provider de Spot) y meta-prestadores estilo Sacmed (AAPD) son las dos formas hoy. |
order_token | Igual al campo hash que retorna POST /orders de SkipPay. Se pasa al widget para activar el flujo AAPD. |
| Provider | La fila en la base de datos de Skip que representa a un partner. Identificada por public_key. Determina qué endpoints puede llamar el partner. |
provider_rut | El RUT de una sub-clínica en la red de un meta-prestador. Se pasa a POST /orders para atribuir la orden a esa sub-clínica. |
public_key | Credencial Spot. Browser-safe — vive en tu código. Autentica POST /api/spot/widget y los endpoints de boletas. |
secret_key | Credencial via header, emitida puntualmente a partners específicos (DTEmite, Reservo) para endpoints estilo admin (lectores de RUT, registro partner-RUT). |
skip_pay_order_id | El valor order_token, cuando va dentro de payloads de boletas (POST /api/spot/gastos). Liga la boleta a una orden AAPD específica. |
| Sub-centro | Una clínica individual en la red de un meta-prestador. Onboardeada una sola vez vía POST /api/spot/sacmed/centers. |
| TempWidgetToken | Token de corta vida (1 hora o 30 días) que representa una sesión de widget pendiente. Tu backend lo crea; el navegador del paciente lo consume. |
| Tenant | Término interno de SkipPay para un partner. Externamente expuesto como el mismo concepto que Provider. |
webhook_secret | Secreto HMAC-SHA256 que SkipPay usa para firmar webhooks salientes a tu endpoint. Solo server-side. |
widget_token | El UUID que identifica un TempWidgetToken. Devuelto por POST /api/spot/widget. |