Developers
translateEspañolOpen an account

Get started

  • Reseller API
  • Quickstart

Concepts

  • Authentication and modes
  • Errors
  • Idempotency
  • Rate limits
  • Pagination

Reference

  • Endpoints
  • Objects

Guides

  • Booking lifecycle
  • Payment link and hold
  • Cancellations
  • Webhooks
  • Sandbox

More

  • Changelog
data_objectOpenAPI 3.1
menu_bookPayment link and holdexpand_more

Get started

  • Reseller API
  • Quickstart

Concepts

  • Authentication and modes
  • Errors
  • Idempotency
  • Rate limits
  • Pagination

Reference

  • Endpoints
  • Objects

Guides

  • Booking lifecycle
  • Payment link and hold
  • Cancellations
  • Webhooks
  • Sandbox

More

  • Changelog
data_objectOpenAPI 3.1

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.paid and the booking becomes paid.

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.

arrow_backPreviousBooking lifecycleNextarrow_forwardCancellations

On this page

  • 2-hour hold
  • Your commission