Agregar método de pago
POST /orders/{hash}/add_payment_method — usado por el widget.
POST /orders/{order_hash}/add_payment_method
Authorization: Bearer {client_id}Llamado por el widget. No lo implementas — esta página documenta el comportamiento.
El widget le pide a SkipPay una URL de setup de Ventipay, después redirige al paciente ahí para ingresar datos de tarjeta. Ventipay recolecta la tarjeta y confirma de vuelta a SkipPay vía su propio webhook (setup_intent.succeeded).
Respuesta (200 OK)
{
"setup_url": "https://ventipay.com/setup/abc123"
}El widget redirige al navegador del paciente a setup_url. Después de que termine en Ventipay, vuelve al widget. El widget entonces sabe que la tarjeta está en archivo y procede a la captura del pago.
Qué ve el partner
Nada directo — el setup pasa enteramente entre Ventipay y SkipPay. Desde tu lado, el único efecto es que después de este paso, llamar a POST /orders/{hash}/payment será posible.
Si necesitas saber si una tarjeta está en archivo antes de disparar el pago, consulta GET /orders/{hash} e inspecciona la respuesta (la superficie del campo se documenta en Referencia de API una vez que llegue Phase 4).