Place Booking - Plugixa Chauffeur

POST /plugixa-chauffeur/v1/public/book

Create a booking the way the booking wizard does: checked, priced on the server, and followed by the booking e-mails.

Public: no login and no capability. The request must carry the booking nonce, see below.

The nonce. A page that shows the [plugixa_chauffeur_booking_form] shortcode carries a nonce for the action plugixa_chauffeur_frontend, in plugixaChauffeurBooking.nonce. Send it back as nonce in the body, or in the X-Plugixa-Chauffeur-Nonce header. A nonce expires within a day, so a page served from a long-lived cache can hold a stale one.

Note. When Stripe Checkout cannot be started, the response is 502, but the booking has already been saved, as pending and unpaid, and its e-mails have gone out.

Request

POST https://your-site.example/wp-json/plugixa-chauffeur/v1/public/book

Request body

Content type: application/json

In order, the server checks the nonce, loads the published form, checks the pickup time against the availability rules and then against the form’s own minimum notice, checks the customer details, loads the vehicle, and works out the fare itself: any price in the request is ignored. The booking is saved as pending and unpaid, the booking e-mails go to the customer and the admin (when e-mails are on), and plugixa_chauffeur_booking_created fires.

{
  "nonce": "a1b2c3d4e5",
  "form_id": 1,
  "service_type": "distance",
  "transfer_type": "one_way",
  "distance_km": 32.5,
  "passengers": 2,
  "pickup_datetime": "2026-11-20 14:30",
  "vehicle_id": 3,
  "customer_name": "Claire Martin",
  "customer_email": "claire.martin@example.com",
  "customer_phone": "+33 6 12 34 56 78",
  "pickup_address": "Paris Charles de Gaulle Airport, Terminal 2E",
  "dropoff_address": "Hotel Lutetia, 45 Boulevard Raspail, Paris",
  "luggage": 3,
  "payment_method": "stripe",
  "return_url": "https://your-site.example/book"
}

Responses

200 Booked. data is the new booking’s summary.

{
  "success": true,
  "message": "Booking received.",
  "data": {
    "booking_id": 42,
    "booking_number": "PXC-20261112-0815",
    "status": "pending",
    "price_total": 78.5,
    "currency": "EUR",
    "vehicle_name": "Mercedes E-Class",
    "payment_method": "stripe",
    "payment_label": "Pay online (card)",
    "payment_type": "online",
    "payment_instructions": "",
    "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_a1B2c3D4e5F6"
  }
}

After paying, Stripe sends the customer to return_url with plugixa_chauffeur_booking=success, ref (the booking number) and session_id added. Confirm the payment from there with Confirm Stripe Payment; the webhook confirms it too.

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-chauffeur/v1/public/book" \
  -H "Content-Type: application/json" \
  -d '{"nonce":"a1b2c3d4e5","form_id":1,"service_type":"distance","transfer_type":"one_way","distance_km":32.5,"passengers":2,"pickup_datetime":"2026-11-20 14:30","vehicle_id":3,"customer_name":"Claire Martin","customer_email":"claire.martin@example.com","customer_phone":"+33 6 12 34 56 78","pickup_address":"Paris Charles de Gaulle Airport, Terminal 2E","dropoff_address":"Hotel Lutetia, 45 Boulevard Raspail, Paris","luggage":3,"payment_method":"stripe","return_url":"https://your-site.example/book"}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-chauffeur/v1/public/book');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'nonce'           => 'a1b2c3d4e5',
        'form_id'         => 1,
        'service_type'    => 'distance',
        'transfer_type'   => 'one_way',
        'distance_km'     => 32.5,
        'passengers'      => 2,
        'pickup_datetime' => '2026-11-20 14:30',
        'vehicle_id'      => 3,
        'customer_name'   => 'Claire Martin',
        'customer_email'  => 'claire.martin@example.com',
        'customer_phone'  => '+33 6 12 34 56 78',
        'pickup_address'  => 'Paris Charles de Gaulle Airport, Terminal 2E',
        'dropoff_address' => 'Hotel Lutetia, 45 Boulevard Raspail, Paris',
        'luggage'         => 3,
        'payment_method'  => 'stripe',
        'return_url'      => 'https://your-site.example/book',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/plugixa-chauffeur/v1/public/book', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    nonce: 'a1b2c3d4e5',
    form_id: 1,
    service_type: 'distance',
    transfer_type: 'one_way',
    distance_km: 32.5,
    passengers: 2,
    pickup_datetime: '2026-11-20 14:30',
    vehicle_id: 3,
    customer_name: 'Claire Martin',
    customer_email: 'claire.martin@example.com',
    customer_phone: '+33 6 12 34 56 78',
    pickup_address: 'Paris Charles de Gaulle Airport, Terminal 2E',
    dropoff_address: 'Hotel Lutetia, 45 Boulevard Raspail, Paris',
    luggage: 3,
    payment_method: 'stripe',
    return_url: 'https://your-site.example/book',
  }),
});
const { data } = await response.json();