Developers

Build the booking flow your clients want

Use the drop-in widget, or your own form with our SDK. Prices, availability, bookings and secure card capture come from one API.

// Your own form, with the SDK
const chauffeurCircle = ChauffeurCircle('cc_pk_live_…');

const quote = await chauffeurCircle.quotes.create({
  service_type: 'airport',
  pickup: { airport: 'JFK' },
  dropoff: { address, lat, lng },
  pickup_at: '2026-06-10T10:00',
  passengers: 2,
});

const { booking, payment_session } =
  await chauffeurCircle.bookings.create({ quote_id: quote.id, … });

chauffeurCircle.payments.mount('#card', {
  session: payment_session,
  onSuccess: (card) => showThanks(card),
});
All plans

Widget

One script tag. Inline form, quote box, popup or iframe, themed with CSS variables, with events for analytics.

Widget guide →
Pro and Business

JavaScript SDK

Typed client for quotes and bookings, plus the secure payment frame for your own form. Never touches card data.

SDK reference →
Business

Server API and webhooks

Secret keys to list bookings from your server, and signed webhooks for every booking and payment event.

Webhooks →

Made to be predictable

  • Money in integer cents, percentages in basis points.
  • Every write accepts an Idempotency-Key, so retries never double-book.
  • One error shape: { "error": { "code", "message", "fields" } }.
  • Publishable keys only work from the domains you list. Test keys also work on localhost.
  • OpenAPI description at /v1/openapi.json.

Try it against the demo

Metro Black Car is a fictional company with real prices. Its test key works from localhost, so you can build against it before you sign up.

Open the demo company site