Referencia API
El contrato de las APIs de Skip — endpoints, webhooks y errores.
Esta es la referencia: el contrato exacto de cada endpoint (request, response, errores) y de los webhooks que Skip te envía. Si buscas cómo armar una integración paso a paso, ve a Guías.
Convenciones
- Formato. Todas las requests y responses son JSON (salvo la subida de boletas, que es
multipart/form-data). - Montos. En CLP, como string sin decimales (
"100000"). - RUT. Chileno, normalizado a
XXXXXXXX-X. Ver RUT y beneficiarios. - Errores. Códigos HTTP estándar con un cuerpo machine-readable. Catálogo completo en Errores.
Autenticación
| Credencial | Dónde va | Para qué |
|---|---|---|
public_key | Query param | Endpoints de Spot (no es secreta). |
client_secret | Authorization: Bearer | Endpoints server-side de AAPD (/orders). Secreta. |
client_id | Header | Llamadas que hace el widget en nombre del paciente. |
widget_token | Query param | Endpoints que consume el iframe del widget. |
Detalle conceptual en Guías → Autenticación y URLs por ambiente en Ambientes.
Superficie por producto
- Spot — widget, suscripción y boletas. Auth con
public_key. - AAPD — órdenes de SkipPay (
pay.getskip.ai) y el contrato del widget. - Webhooks — eventos firmados que Skip envía a tu endpoint.
- Errores — catálogo consolidado de códigos 4xx.
¿Falta un endpoint? Si tu integración necesita algo que no aparece acá, escríbenos a
contacto@getskip.ai— algunos endpoints existen pero quedan fuera del alcance de la documentación pública por ahora.