Saltar a contenido

Pagos y confirmación

Producto: OpenBooking | Módulo: Integración API | Última actualización: 2026-08-12

Introducción

El cobro no ocurre dentro de la API: se delega a la pasarela. Su integración inicia el pago, redirige al cliente y después verifica el resultado.

Pasarelas disponibles

GET /api/gateways

Devuelve las pasarelas activas en la instalación, con su identificador y su nombre visible. Use ese identificador en el campo payment_gateway del checkout.

Identificador Pasarela
offline_payment Pago fuera del sistema
installments Pago en cuotas
transbank_webpay Transbank Webpay
stripe Stripe
paypal PayPal
payrexx Payrexx
paystack Paystack

ℹ️ Nota: No asuma esta lista fija. Consulte siempre el endpoint: las pasarelas activas dependen de la configuración de cada instalación y de su plan.

Flujo con pasarela en línea

1. POST /api/booking/doCheckout           → devuelve la URL de pago
2. Redirigir al cliente a esa URL
3. El cliente paga en el sitio de la pasarela
4. La pasarela retorna a la URL de confirmación
5. Verificar el estado de la reserva

Retornos

Ruta Cuándo
GET /api/booking/confirm/{gateway} El cliente completó el pago
GET /api/booking/cancel/{gateway} El cliente canceló

⚠️ Advertencia: El retorno del navegador no es prueba de pago. El cliente puede cerrar la ventana antes de volver, o volver sin haber pagado. Verifique siempre el estado real con check-status antes de dar la reserva por confirmada.

Verificar el estado

GET /api/booking/{code}/check-status
Estado Significa
Pendiente de pago Sin pago registrado
Procesando Pago iniciado, sin confirmar
Pago parcial Con abonos, con saldo
Confirmada / pagada Pago completo
Cancelada Anulada

Flujo con pago offline

Con offline_payment no hay redirección: la reserva queda pendiente de pago y la respuesta incluye las instrucciones configuradas —datos bancarios y plazo—. El operador registra el pago después desde el panel.

Notificación del proveedor

Las pasarelas notifican el resultado del pago al sistema mediante un aviso servidor a servidor. Esa confirmación es la que actualiza definitivamente el estado de la reserva.

💡 Consejo: Si un pago se cobró y la reserva no se actualizó, el problema casi siempre está en esa notificación. Revise el panel de la pasarela y avise a soporte con el identificador de la transacción.

Buenas prácticas

  1. Nunca dé por pagada una reserva solo porque el cliente volvió del retorno.
  2. Muestre el estado real consultado a la API.
  3. Maneje el abandono: la reserva queda pendiente y se puede retomar.
  4. Pruebe con credenciales de prueba antes de cobrar de verdad.
  5. No procese datos de tarjeta: eso ocurre siempre en el sitio de la pasarela.

¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl