Build on the platform that moves Switzerland

The platform

A booking engine you call over HTTPS

Quote a route, place a booking, assign a chauffeur, and follow the car to the door. Requests are HTTPS POST with a JSON body; responses are JSON. Access is by partner key, scoped to your own account. Admin and internal endpoints are never exposed.

Capabilities · one platform, the whole journey

From the first quote to the paid invoice, every part of the transfer lifecycle is an endpoint you can call.

Authentication · one header on every request

Authenticate with your partner key in the X-Api-Key header. Keep it secret. Your key only ever sees and acts on your own data.

curl -X POST "https://api.easy-transfers.ch/?action=getQuote" \
  -H "X-Api-Key: YOUR_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"GVA","to":"Verbier","pax":3}'

The API · every part of the journey

A comprehensive API across the whole transport lifecycle, grouped by domain and read live from the running platform, so the reference always matches what your key can call.

The Console · keys and webhooks, managed for you

The Partner Console is where you manage your API key, configure a webhook endpoint, and watch every delivery in real time, with automatic retries and a full log.

1 · Overview

Webhooks let your system react in real time to events in the EasyTransfer Transport® platform. When a subscribed event occurs, we send an HTTP POST with a JSON body to your endpoint, signed with HMAC-SHA256.

Subscribe with exact names or wildcards, e.g. booking.*,invoice.* or all.

2 · Events · booking lifecycle

2 · Events · chauffeur, billing, notifications

3 · Delivery & headers

Each delivery is a POST with Content-Type: application/json and:

Payload

{
  "event": "booking.completed",
  "data": {
    "ref": "ET-000999",
    "status": "COMPLETED",
    "client": "Max Muster",
    "price": 120.00
  },
  "timestamp": "2026-06-30T16:33:00+02:00"
}

4 · Verifying the signature

Compute HMAC-SHA256 over the raw body with your secret and compare (constant-time) to X-ET-Signature.

# PHP
$expected = hash_hmac('sha256', $rawBody, $yourSecret);
if (!hash_equals($expected, $_SERVER['HTTP_X_ET_SIGNATURE'] ?? '')) { http_response_code(401); exit; }

# Node
const exp = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
if (!crypto.timingSafeEqual(Buffer.from(exp), Buffer.from(req.header('X-ET-Signature')||''))) return res.sendStatus(401);

5 · Responses, timeouts & retries

6 · Configuration, test & versioning

curl -X POST "https://api.easy-transfers.ch/?action=partner.webhook.config" \
  -H "X-Api-Key: etk_partner_..." -H "Content-Type: application/json" \
  -d '{"url":"https://your-domain.com/webhook","events":["booking.created","invoice.paid"]}'

This is v1. New event types and fields may be added; your handler must ignore unknown fields and events. Breaking changes would ship as v2.

EasyTransfer Transport® · Chemin du midi 15d, 1260 Nyon, Switzerland · info@easy-transfers.ch