Referencia de API — AAPD
Endpoints de orden y eventos de webhook que vas a consumir para AAPD.
AAPD se construye sobre dos superficies: los endpoints de orden de SkipPay (pay.getskip.ai) y los webhooks que Skip te envía a tu endpoint. Tu integración además usa el widget de Spot — ver Spot → Referencia para el minteo del token.
Órdenes
/ordersauth: client_secretCrea la orden AAPD. Devuelve un hash que pasas como order_token al widget. Ver detalle →
/orders/{order_hash}auth: client_secret | client_idConsulta el estado de una orden. Ver detalle →
/orders/{order_hash}/refundauth: client_secretReembolso total o parcial. Ver detalle →
Llamadas que hace el widget
Estas tres las dispara el widget en nombre del paciente — tu backend no las llama directo. Se documentan por contexto.
/orders/{order_hash}/validate_customer_identityauth: client_idValida RUT + serie de CI. Ver detalle →
/orders/{order_hash}/add_payment_methodauth: client_idDevuelve la URL de Ventipay donde el paciente ingresa la tarjeta. Ver detalle →
/orders/{order_hash}/paymentauth: client_idInicia el préstamo. Ver detalle →
Webhooks
Skip envía un POST firmado con HMAC-SHA256 a la URL que registres durante el onboarding.
{tu webhook_notification_url}Eventos: order.paid, order.partially_paid, order.refunded, order.failed. Verifica la firma X-Gokeipay-Signature antes de confiar en el payload. Ver detalle →
¿Falta un endpoint? Si tu integración necesita algo que no aparece acá, escríbenos a
contacto@getskip.ai.