AAPDÓrdenes
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 cinco 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 los endpoints directo); tu backend opcionalmente llama al paso 5 (refund).
Tu backend SkipPay Widget Ventipay
│ │ │ │
│ POST /orders │ │ │
│ ─────────────────► │ │ │
│ ◄── { hash } ── │ │ │
│ │ │ │
│ (mintea widget, │ │
│ embebe iframe) │ │
│ │ │ │
│ │ ◄── validate_customer_identity ── │
│ │ ◄── add_payment_method ── │
│ │ ───────────────────────► (setup tarjeta) │
│ │ ◄── POST /payment ── │
│ │ ───────────────────────► (flujo préstamo) │
│ │ ◄── webhooks ─────────── │
│ │ │
│ ◄── webhook (order.paid) ── │
│ │
│ PUT /orders/{hash}/refund (opcional, en cualquier momento después de paid) │
│ ─────────────────► │ │Paso a paso
| Paso | Endpoint | Auth | Llamador | Doc |
|---|---|---|---|---|
| 1 | POST /orders | client_secret | Tu backend | Crear una orden |
| 2 | POST /orders/{hash}/validate_customer_identity | client_id | Widget | Validar identidad |
| 3 | POST /orders/{hash}/add_payment_method | client_id | Widget | Agregar método de pago |
| 4 | POST /orders/{hash}/payment | client_id | Widget | Capturar pago |
| 5 | PUT /orders/{hash}/refund | client_secret | Tu backend (opcional) | Reembolso |
Solo implementas el paso 1 y el paso 5 (más el receptor de webhooks). El resto es trabajo del widget — los gestiona solo cuando lo embebes.
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.