Payment link and hold
Guides
Payment link and hold
How Muvon collects API bookings with a payment link and the 2-hour hold.
Your customer pays Muvon directly. Every booking carries a payment_url on api.muvon.mx: a page with the ride summary and a button to pay by card, in passenger.language. The charge is in US dollars.
- Share it however you like: email, WhatsApp or a button on your site.
- The payment session is created when it's opened, so the link never expires before the hold does.
- If you sent
return_url, your customer returns there after paying. - When the payment clears you get
booking.paidand the booking becomespaid.
2-hour hold
An unpaid booking cancels itself 2 hours after it was created (hold_expires_at), with cancel_reason: "payment_timeout" and the booking.cancelled event. If your customer didn't pay in time, quote and book again.
Your commission
commission_cents is what you earn on that booking per your agreement with Muvon. Muvon pays it out under that agreement; it isn't taken from your customer's payment.

