Meet & Greet B2B API

POST Get parking quotes

# Get parking quotes
curl -X POST https://api.magrgroup.com/api/products \
  -H 'Content-Type: application/json' \
  -d '{
    "user_email": "registered@emailaddress.com",
    "agent_code": "your-agent-code",
    "password": "your-password",
    "quote": {
      "airport_code": "LHR",
      "dropoff_date": "2026-09-01",
      "dropoff_time": "10:00",
      "pickup_date": "2026-09-10",
      "pickup_time": "20:00"
    }
  }'
                

Return parking products for an airport and date range. Authenticate with body credentials on every call.

Result example :

 "request": {
        "status": "success",
        "airport": "LHR",
        "arrival_date": "2025-04-29",
        "arrival_time": "09:00",
        "depart_date": "2025-04-23",
        "depart_time": "12:00"
    },
    "products": [
      
        {
            "companyID": 675,
            "product_code": "HAPS-001",
            "opening_time": "00:00",
            "closing_time": "00:00",
            "name": "Heathrow Airport Parking Service - Meet & Greet",
            "processtime": "1",
            "special_features": "CCTV,DISABILITY FRIENDLY,FENCING,PATROLLED,SECURITY LIGHTING",
            "bookingemail": "apibookings@api.magrgroup.com",
            "terms": null,
            "extra_charges": "0",
            "parking_type": "Meet and Greet",
            "logo": "https://dashboard.magrgroup.com/storage/app/companies/S3XatB3IRZgjP9Xi3VgoVNY9zmooGOU0stjIXoyl.png",
            "cancelable": "Yes",
            "editable": "Yes",
            "price": "55.99",
            "new_price": "55.99",
            "agent_amount": "8.40",
            "mg_amount": "12.00",
            "agent_month_end_return": "8.40",
            "mg_retained": "12.00",
            "park_api": "b2b",
            "overview": "Essentials\n\nEstimated journey time to the airport: Drop at the terminal\nYour
keys will stay in the car park whilst you are away.\nDisability Friendly\n\n
Overview:\nOpt for Heathrow Airport Parking Service Meet and Greet Super Saver for an efficient and discover the seamless parking experience with our Meet and Greet service – the hassle-free solution for business travellers and families. No more waiting at the airport, no terminal transfer worries, and no more shuttle buses, making it the perfect choice to save up to 35 minutes on your journey time. ",
            "return_proc": "Terminal 1\nPostcode: (TW6 1AP)\nClosed for renovation.\nTerminal 2\nPostcode: (TW6 1EW)\nDeparture:\nFrom the M4 exit follow the signs for Terminals 1, 2 & 3 all the way round following onto the Western Perimeter Road. Go through the main tunnel to the Central Terminal Area for Terminals 1, 2 & 3. Exiting the tunnel keep right passing the Central Bus Station joining the final approaches to Terminal 2 on Cosmopolitan Way.  .\nArrival:\nOnce you have collected your luggage and are about to clear customs, call the number given when your car was collected. Make your way to the same place where you dropped the vehicle off Level 4 short stay car park, row R or S.",
            "arrival": "Note: Please ensure you contact this number, 0208 050 3364, at least 30 minutes prior to arrival.\nTerminal 1\nPostcode: (TW6 1AP)\nClosed for renovation.\nTerminal 2\nPostcode: (TW6 1EW)\nDeparture:\nFrom the M4 exit follow the signs for Terminals 1, 2 & 3 all the way round following onto the Western Perimeter Road. Go through the main tunnel to the Central Terminal Area for Terminals 1, 2 & 3. Exiting the tunnel keep right passing the Central Bus Station joining the final approaches to Terminal 2 on Cosmopolitan Way. Again keep right as the road to Terminal 2 will move away from building, before turning back as the road ramps up to Terminal 2 Departures & the Short Stay 2 car park on Constellation Way. On the rising ramp continue to keep right as the ramp will lead directly into the Short stay car park entry barriers. Take the barrier ticket and enter the car park.  "
            "id": 1150,
            "admin_id": 101,
            "facilities": "Pick up at the Airport, Fully Insured Mature Driver's, 6 Miles from airport, Hassle free & convenient, Serving all terminals of Heathrow",
            "park_api": "b2b"
        },
                

QUERY PARAMETERS

RESPONSE PARAMETERS

POST Create booking

# Step 2 — customer clicked a product → create PaymentIntent
# Example: parking 55.99 + your UI fees (e.g. 1.99 + 1.99 + 1.25) = 61.22
curl -X POST https://api.magrgroup.com/api/payments/create-intent \
  -H 'Content-Type: application/json' \
  -d '{
    "user_email": "registered@emailaddress.com",
    "password": "your-password",
    "agent_code": "your-agent-code",
    "amount": 61.22,
    "currency": "gbp",
    "company_code": "HAPS-001",
    "park_api": "b2b",
    "airport_code": "LHR",
    "dropoff_date": "2026-09-10",
    "dropoff_time": "10:00",
    "pickup_date": "2026-09-15",
    "pickup_time": "10:00",
    "bookreference": "YOUR-CLIENT-REF-OPTIONAL"
}'
# Save: payment_intent_id, client_secret, publishable_key
# M&G booking reference (MG-A-{id}) is created later on /bookings — not here.
                    

<!-- Include Stripe.js -->
<script src="https://js.stripe.com/v3/"></script>

<!-- Step 3: your booking details form (example fields) -->
<form id="details-form">
  <input name="first_name" placeholder="First name" required>
  <input name="last_name" placeholder="Last name" required>
  <input name="customer_email" type="email" placeholder="Email" required>
  <input name="phone_number" placeholder="Phone" required>
  <input name="car_registration_number" placeholder="Vehicle reg" required>
  <!-- …make, model, color, flights, terminals… -->
</form>

<!-- Step 4: card -->
<form id="payment-form">
  <div id="card-element"></div>
  <button id="submit">Pay & book</button>
  <div id="error"></div>
</form>

<script>
  // From create-intent (step 2):
  const publishableKey = 'pk_test_...';
  const clientSecret = 'pi_..._secret_...';

  const stripe = Stripe(publishableKey);
  const elements = stripe.elements();
  const card = elements.create('card');
  card.mount('#card-element');

  document.getElementById('payment-form').addEventListener('submit', async (e) => {
    e.preventDefault();
    document.getElementById('submit').disabled = true;

    // Read step-3 form values first
    const details = Object.fromEntries(new FormData(document.getElementById('details-form')));

    const { paymentIntent, error } = await stripe.confirmCardPayment(clientSecret, {
      payment_method: {
        card: card,
        billing_details: {
          name: (details.first_name + ' ' + details.last_name).trim(),
          email: details.customer_email,
          phone: details.phone_number,
        },
      },
    });

    if (error) {
      document.getElementById('error').textContent = error.message;
      document.getElementById('submit').disabled = false;
      return;
    }

    if (paymentIntent.status === 'succeeded') {
      // Step 5 — POST /bookings with details + payment_token
      await fetch('https://api.magrgroup.com/api/bookings', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          user_email: 'registered@emailaddress.com',
          password: 'your-password',
          agent_code: 'your-agent-code',
          company_code: 'HAPS-001',
          dropoff_date: '2026-09-10',
          dropoff_time: '10:00',
          pickup_date: '2026-09-15',
          pickup_time: '10:00',
          title: 'Mr',
          first_name: details.first_name,
          last_name: details.last_name,
          customer_email: details.customer_email,
          phone_number: details.phone_number,
          car_registration_number: details.car_registration_number,
          car_make: 'Ford',
          car_model: 'Focus',
          car_color: 'Blue',
          departure_flight_number: 'BA123',
          arrival_flight_number: 'BA456',
          departure_terminal: 'Terminal 2',
          arrival_terminal: 'Terminal 3',
          passenger: 1,
          park_api: 'b2b',
          paymentgateway: 'stripe',
          payment_token: paymentIntent.id,
          // optional: bookreference: 'YOUR-CLIENT-REF'
        }),
      }).then(r => r.json()).then(data => {
        // data.reference => "MG-A-12345"
        console.log('Booking reference', data.reference);
      });
    }
  });
</script>
                    

# Step 5 — same as the fetch above (after PI succeeded)
curl -X POST https://api.magrgroup.com/api/bookings \
  -H 'Content-Type: application/json' \
  -d '{
    "user_email": "registered@emailaddress.com",
    "password": "your-password",
    "agent_code": "your-agent-code",
    "company_code": "HAPS-001",
    "dropoff_time": "10:00",
    "dropoff_date": "2026-09-10",
    "pickup_time": "10:00",
    "pickup_date": "2026-09-15",
    "title": "Mr",
    "first_name": "John",
    "last_name": "Smith",
    "customer_email": "customer@example.com",
    "phone_number": "07123456789",
    "departure_flight_number": "BA123",
    "arrival_flight_number": "BA456",
    "departure_terminal": "Terminal 2",
    "arrival_terminal": "Terminal 3",
    "car_registration_number": "AB12 CDE",
    "car_make": "Ford",
    "car_model": "Focus",
    "car_color": "Blue",
    "passenger": 1,
    "park_api": "b2b",
    "paymentgateway": "stripe",
    "payment_token": "pi_XXXXXXXX",
    "fees": {
      "booking_fee": "1.99",
      "cancellation_fee": "1.25",
      "sms_notification_fee": "1.99"
    }
}'
# Response example:
# {
#   "success": true,
#   "message": "Booking created",
#   "reference": "MG-A-12345",
#   "booking_amount": 61.22,
#   "fees": {
#     "booking_fee": "1.99",
#     "cancellation_fee": "1.25",
#     "sms_notification_fee": "1.99"
#   }
# }
                    

Create a booking after quoting. Use product_code / company_code and park_api from the products response. booking_amount in the response is the total collected on M&G Stripe. fees in the response echoes the fee amounts you sent on the booking request (not catalog defaults).

JSON BOOKING POST DATA PARAMETERS

                Sample success response  :
                {
                    "success": true,
                    "message": "Booking created",
                    "reference": "MG-A-12345",
                    "booking_amount": 61.22,
                    "fees": {
                        "booking_fee": "1.99",
                        "cancellation_fee": "1.25",
                        "sms_notification_fee": "1.99"
                    }
                }
                

RESPONSE PARAMETERS

POST Amend booking

Non-Flexible Booking: This type of booking cannot be modified once confirmed. Flexible Booking: Modifications to this booking type are permitted, provided they are made at least 24 hours prior to the scheduled departure date. Using Stripe Payment Intent Method, API doesn't support Extend Booking Request.For date change cancel the booking and book again.But if you want to change only the airport details or customer details follow the bellow request

                curl \
                -X POST https://api.magrgroup.com/api/amend/ \
                -H 'Content-Type: application/json' \
                -H 'Cache-Control: no-cache' \
                -d '{
                    "company_code": "HAPS-001",
                    "bookreference": "CDC-012504222077",
                    "amend_booking": "amend_booking",
                    "dropoff_time": "09:00",
                    "dropoff_date": "2025-04-24",
                    "pickup_time": "09:00",
                    "pickup_date": "2025-04-29",
                    "title": "Mr",
                    "first_name": "test",
                    "last_name": "test",
                    "customer_email": "b2b@meetandgreetparkingdeals.com",
                    "phone_number": "23433323",
                    "departure_flight_number": "TBA",
                    "arrival_flight_number": "test",
                    "departure_terminal": "Terminal 2",
                    "arrival_terminal": "Terminal 3",
                    "car_registration_number": "test",
                    "car_make": "test",
                    "car_model": "test",
                    "car_color": "test",
                    "park_api": "b2b",
                    "passenger": 1,
                    "paymentgateway": "Invoice",
                    "payment_token": "pi_3RGghGL3PGdUbgCn0UtqdIj3",
                    "booking_amount": 50.99,
                    "agent_code": "Ic5w0rP2kWu4M5DVDUztZH6tYqPb",
                    "user_email": "b2b@meetandgreetparkingdeals.com",
                    "password": "1234"
                }'
                

RESPONSE PARAMETERS

        Amend Sample Success response :
        {
            "status": "success",
            "message": "Booking updated successfully",
            "reference": "MG-A-12345",
        }
        

        Amend Sample user email,key or password Error response :
        {
            "status": "Error",
            "message": "Invalid API Credentials (User not found)",
            }
        

        Amend Sample 48 Hours Error response :
        {
            "status": "Error",
            "message": "Booking cannot be amended within 48 hours of departure",
            
        }
        

        Amend Sample NonFlex Error response :
        {
            "status": "Error",
            "message": "the product must be flex",
                
        }
        

POST Cancel booking

Submits a cancellation request only. The product must be cancelable=Yes and drop-off at least 24 hours away. M&G cancels with the parking company afterwards; Stripe refund is issued only after company confirmation. Non-cancelable products return an error and do not create a request. Same behaviour on /cancel_booking and /partner/parking/cancel.

                curl \
                -X POST https://api.magrgroup.com/api/cancel/ \
                -H 'Content-Type: application/json' \
                -H 'Cache-Control: no-cache' \
                -d '{ 
                    "booking_ref": "CDC-012504222077",
                    "refund": 50.99,
                    "agent_code": "Ic5w0rP2kWu4M5DVDUztZH6tYqPb",
                    "user_email": "b2b@meetandgreetparkingdeals.com",
                    "password": "1234"
                }'
                

RESPONSE PARAMETERS

                Cancellation Sample response :
        {
            "status": "success",
            "message": "Cancellation request received. You will be notified after the company confirms.",
            "booking_ref": "MG-A-12345",
            "cancel_stage": "Pending",
            "cancelable": "Yes",
            "requested_refund": "50.99"
        }
        

        Cancel Sample user email,key or password Error response :
        {
            "status": "Error",
            "message": "Invalid API Credentials (User not found)",
            }
        

        Cancel Sample 48 Hours Error response :
        {
            "status": "Error",
            "message": "Booking cannot be Cancel within 48 hours of departure",
            
        }
        

        Cancel Sample NonFlex Error response :
        {
            "status": "Error",
            "message": "the product must be flex",
                
        }
        

Errors

The meet and greet API sent following error response:

EMPTY OR INVALID LOGIN EMAIL & HASH KEY PARAMETERS

                Error Sample response :
        {
            "status": "Error",
            "message": "User Email is required or Invalid API Credentials ",
            
        }
        

        Error Sample response :
        {
            "status": "Error",
            "message": "Your request is for live API but your account is in test mode. Use https://dev-api.magrgroup.com for test accounts.",
            
        }
        

        Error Sample response :
        {
            "status": "Error",
            "message": "e.g Booking Reference is Missing. Payment Transaction is Missing.",
            
        }
        

TEST / LIVE API MODE

TEST / LIVE API MODE