Book a Space - Plugixa Car Parking

POST /plugixa-car-parking/v1/booking

Create a booking the way the booking form does: the selection is checked, priced and held in one step, and the booking’s payment key comes back for Start Payment.

Anyone may call it, signed in or not, with the public nonce the plugin’s pages print (see Public routes). It counts against the booking rate limit: 10 an hour per visitor address.

Note. The booking belongs to whoever is signed in when the request is made, or to nobody for a guest. A user_id in the body is ignored. A booking made without customer_email cannot be found later through List Customer Bookings by a guest, because that lookup matches the e-mail.

Request

POST https://your-site.example/wp-json/plugixa-car-parking/v1/booking

Request body

Content type: application/json. Send the nonce as security here or in the X-Plugixa-Carparking-Nonce header.

The price is always worked out on the server. The billing unit is the location’s own: a billing_type in the body is dropped. The new booking takes the status set in the settings (by default pending), with payment_status unpaid. When the settings hold pending bookings for a limited time, hold_expires_at says until when.

The hidden field pcp_hp is a spam trap: leave it out.

{
  "location_id": 2,
  "space_type_id": 1,
  "entry": "2026-11-20 08:00",
  "exit": "2026-11-23 18:00",
  "quantity": 1,
  "customer_name": "Lucas Bernard",
  "customer_email": "lucas@example.com",
  "customer_phone": "+33 6 12 34 56 78",
  "license_plate": "AB-123-CD",
  "gateway": "offline"
}

Responses

200 OK. data is the new booking.

{
  "success": true,
  "message": "Your booking has been created.",
  "data": {
    "id": "57",
    "booking_ref": "PKG-3F9A2C",
    "language_code": null,
    "location_id": "2",
    "space_type_id": "1",
    "space_id": null,
    "booking_form_id": "1",
    "user_id": null,
    "status": "pending",
    "billing_type": "day",
    "entry_datetime": "2026-11-20 08:00:00",
    "exit_datetime": "2026-11-23 18:00:00",
    "quantity": "1",
    "hold_expires_at": null,
    "license_plate": "AB-123-CD",
    "vehicle": null,
    "customer_name": "Lucas Bernard",
    "customer_email": "lucas@example.com",
    "customer_phone": "+33 6 12 34 56 78",
    "billing": null,
    "currency": "EUR",
    "subtotal": "48.0000",
    "discount_total": "0.0000",
    "tax_total": "0.0000",
    "deposit_amount": "0.0000",
    "total": "48.0000",
    "amount_paid": "0.0000",
    "coupon_id": null,
    "payment_method": "offline",
    "payment_status": "unpaid",
    "notes": null,
    "meta": null,
    "created_by": "0",
    "modified_by": "0",
    "created_at": "2026-11-12 09:30:00",
    "updated_at": null,
    "modified_at": "2026-11-12 09:30:00",
    "deleted_at": null,
    "summary_url": "https://your-site.example/booking-summary/?plugixa_carparking_ref=PKG-3F9A2C&plugixa_carparking_token=9c1e5b2a7d",
    "payment_key": "4f0c2a9e1b7d3c5a8e6f0b2d4c6a8e1f"
  }
}

Note. This route returns the stored row as the database gives it back: ids, quantities and amounts are strings ("48.0000"), not numbers. Convert them before you compute with them.

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-car-parking/v1/booking" \
  -H "Content-Type: application/json" \
  -H "X-Plugixa-Carparking-Nonce: $PCP_NONCE" \
  -d '{"location_id":2,"space_type_id":1,"entry":"2026-11-20 08:00","exit":"2026-11-23 18:00","quantity":1,"customer_name":"Lucas Bernard","customer_email":"lucas@example.com","customer_phone":"+33 6 12 34 56 78","license_plate":"AB-123-CD","gateway":"offline"}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-car-parking/v1/booking');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'X-Plugixa-Carparking-Nonce: ' . getenv('PCP_NONCE'),
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'location_id'    => 2,
        'space_type_id'  => 1,
        'entry'          => '2026-11-20 08:00',
        'exit'           => '2026-11-23 18:00',
        'quantity'       => 1,
        'customer_name'  => 'Lucas Bernard',
        'customer_email' => 'lucas@example.com',
        'customer_phone' => '+33 6 12 34 56 78',
        'license_plate'  => 'AB-123-CD',
        'gateway'        => 'offline',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/plugixa-car-parking/v1/booking', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Plugixa-Carparking-Nonce': PCP_NONCE,
  },
  body: JSON.stringify({
    location_id: 2,
    space_type_id: 1,
    entry: '2026-11-20 08:00',
    exit: '2026-11-23 18:00',
    quantity: 1,
    customer_name: 'Lucas Bernard',
    customer_email: 'lucas@example.com',
    customer_phone: '+33 6 12 34 56 78',
    license_plate: 'AB-123-CD',
    gateway: 'offline',
  }),
});
const { data } = await response.json();