Ciclo de vida de la orden
Desde la creación hasta la captura, la secuencia de llamadas que hacen tu backend y el widget.
Una orden AAPD pasa por cuatro pasos mediados por backend. Tu backend es dueño del paso 1; el widget es dueño de los pasos 2–4 (lo embebes pero no llamas a esos endpoints directo — son internos del widget).
Tu backend SkipPay Widget Financiamiento
│ │ │ │
│ POST /orders │ │ │
│──────────────────►│ │ │
│◄──────────────────│ │ │
│ { hash } │ │ │
│ │ │ │
│ (mintea widget, │ │ │
│ embebe iframe) │ │ │
│ │ │ │
│ │ (valida identidad) │ │
│ │◄────────────────────│ │
│ │ (setup de tarjeta) │ │
│ │◄────────────────────│ │
│ │ │ (setup tarjeta) │
│ │───────────────────────────────────────►│
│ │ (inicio de pago) │ │
│ │◄────────────────────│ │
│ │ │ (flujo préstamo) │
│ │───────────────────────────────────────►│
│ │ │ webhooks │
│ │◄───────────────────────────────────────│
│ │ │ │
│◄──────────────────│ │ │
│ order.changed │ │ │
│ (status paid) │ │ │Paso a paso
| Paso | Qué hace | Auth | Llamador | Doc |
|---|---|---|---|---|
| 1 | Crear la orden (POST /orders) | client_secret | Tu backend | Crear una orden |
| 2 | Validar identidad del cliente | client_id | Widget (interno) | — |
| 3 | Agregar método de pago | client_id | Widget (interno) | — |
| 4 | Iniciar el pago / préstamo | client_id | Widget (interno) | — |
Solo implementas el paso 1 (más el receptor de webhooks). Los pasos 2–4 son trabajo del widget — los gestiona solo cuando lo embebes. Puedes consultar el estado en cualquier momento con GET /orders/{hash}.
Después del pago: envía el gasto (obligatorio)
El pago del 30% no cierra el flujo. Una vez emitida la boleta de la prestación, tu backend debe enviársela a Skip para que presente el reembolso ante la ISAPRE/seguro — es lo que habilita el eventual cobro del 70%. Manda la boleta (obligatoria) con su metadata, y la orden médica si aplica o está disponible, vía POST /api/spot/gastos con skip_pay_order_id = el hash de la orden. Ver Enviar el gasto a Skip.
Ciclo de vida del estado de la orden
pending → partially_paid → paid → (partially_refunded | refunded)
└→ cancelled| Estado | Cuándo |
|---|---|
pending | Orden creada, sin pago todavía |
partially_paid | Primera cuota del 30% capturada |
paid | Préstamo aprobado y financiado completo |
partially_refunded | Reembolso parcial emitido |
refunded | Reembolso total procesado |
cancelled | Orden cancelada antes del pago |
Recibes un webhook en cada cambio de estado. Ver Webhooks → Catálogo de eventos.
URL base
https://pay.getskip.aiStaging: https://staging.pay.getskip.ai. Ver Conceptos → Ambientes.