Payments

Implementing Payments

Payments are handled during the two-step booking process: Prebook and Confirm.

By default, use_payment_sdk is set to true in POST /api/v1/bookings/prebook.

The response includes:

payment_url - Hosted checkout page.

transaction_id - Payment transaction reference.

return_url - URL returns to after payment.

Redirect to the payment_url.

After successful payment, you will be returned to return_url, and the booking is automatically confirmed.

If you set use_payment_sdk to false, no hosted payment URL is returned.

In that case, you must confirm the booking yourself using:

POST /api/v1/bookings/confirm

Keep the booking_id and prebook_id from the prebook response.

A prebook is not a confirmed booking until payment and confirmation are complete.

If automatic confirmation fails after payment, check the return response and retry confirmation if needed.