What is a Flexible Ride?

A Flexible Ride is a pre-defined, company-funded journey where origin and destination are fixed in advance and the rider claims the ride on demand, with no fixed pickup time, no app requirement, and no Cabify account needed.

Usage

A cabify client can create a Flexible Ride via our API, setting up the journey specifications for the ride with it, similar to when creating a Journey. Once created, a public url is generated for the Flexible Ride and Cabify sends it to the guest rider by WhatsApp, or by SMS if WhatsApp can't deliver it. You can also share the url yourself.

Once the guest rider has the public url link, it can access it via web, and Claim the Flexible Ride, generating a new Journey based on the specifications on the Flexible Ride, without the need of a Cabify user or the Cabify App. Do note that in order to claim a Flexible Ride, it should be in pending status.

Rider notification

When you create a Flexible Ride, Cabify sends the guest rider a WhatsApp message at rider.mobile with the origin, the destination, when the ride can be claimed and a button to claim it. If WhatsApp can't deliver it, the rider gets an SMS with the same details and the link.

The message is in English when the rider's locale is English, such as en, EN or en-GB, and in Spanish for any other value. If the rider has no locale, it uses the requester's language, and Spanish if that isn't set either. The sender is sender_name, or the client's name when it isn't set, and times are in the local time of the origin.

A Flexible Ride that is claimed, cancelled or expires before the message goes out sends nothing.

States

A Flexible Ride can end up in different states, which are the following:

• pending - Initial state.
• claimed - It was claimed by a user and a journey was created for it.
• failed - A non recoverable error ocurred during the claiming process (e.g overbudget).
• cancelled - It was cancelled by the owner.
• expired - After the expiration time was reached.

All states besides pending are final.

API Reference

You can find the API Reference for the Flexible Rides endpoints Here.

Webhooks

We provide different webhooks for integrations to keep track of status changes in a Flexible Ride, you can find their specification Here.