TRANSFERISE PARTNER API · V1 · REFERENZ
Flughafentransfer-API-Dokumentation
Orte suchen, Live-Preise abrufen, private Flughafentransfers anlegen, ändern und stornieren – mit einer JSON-API. Jede Anfrage unten zeigt rechts den Aufruf und genau das Ergebnis. Entwickeln Sie mit einem kostenlosen Sandbox-Schlüssel; bis zum Livegang erreicht nichts Fahrer oder Zahlungen.
Schnellstart
Drei Aufrufe führen vom „Wohin?“ zum gebuchten Transfer.
- 1Orte finden
placesmacht aus „AYT“ oder einem Hotelnamen eine Orts-ID. - 2Live-Preise zeigen
quoteliefert jedes Fahrzeug mit Endpreis. - 3Buchen
booklegt die Buchung und bei Bedarf einen sicheren Kartenzahlungslink an.
Authentifizierung & Sandbox
Senden Sie Ihren Schlüssel im Header X-Api-Key. Alle Anfragen und Antworten sind JSON (UTF-8).
- Base URL
https://transferise.com/api/widget.php?action=…- Sandbox-Schlüssel
tfx_test_…. Gleiche Orte, Preise und Prüfungen wie live. Buchungen sindTEST-…und nur für Sie sichtbar. Keine Fahrer, Zahlungen oder E-Mails.- Live-Schlüssel
tfx_…. Wird nach kurzer Prüfung in der Partner-Konsole ausgegeben und kann an Ihre Domains gebunden werden.- Sicherheit
- Rufen Sie
book,updateundcancelvom Server auf, nie aus dem Browser. Legen Sie einen Live-Schlüssel nie in Client-Code oder ein öffentliches Repository.
curl 'https://transferise.com/api/widget.php?action=places&q=antalya' \
-H 'X-Api-Key: tfx_test_…' {
"ok": false,
"error": "invalid_api_key",
"docs": "https://transferise.com/developers/docs"
}Buchungsablauf
Eine Buchung durchläuft diese Status. booking liefert immer den aktuellen.
payment_urlcancelled ist pro Fahrt oder für die ganze Buchung möglich, bis das Stornofenster schließt.
?action=placesOrte suchen
Finden Sie einen Flughafen, ein Hotel, einen Ferienort oder eine Adresse. Verwenden Sie die zurückgegebene id in quote und book.
| Parameter | Typ | |
|---|---|---|
qPflicht | string | Suchtext, mindestens 2 Zeichen |
- Nur lesend. Es wird nichts gespeichert.
- Liefert bis zu 10 Treffer mit Koordinaten.
- Orte, die nicht in unserer Liste sind, können mit
from_lat / from_lng / from_labeltrotzdem gebucht werden.
curl 'https://transferise.com/api/widget.php?action=places&q=rixos+downtown' \
-H 'X-Api-Key: tfx_test_…'const res = await fetch(
'https://transferise.com/api/widget.php?action=places&q=rixos+downtown',
{ headers: { 'X-Api-Key': process.env.TRANSFERISE_KEY } }
);
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=places&q=rixos+downtown');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true); {
"ok": true,
"results": [
{
"id": "hotel:17370",
"kind": "hotel",
"name": "Rixos Downtown Antalya",
"label": "Rixos Downtown Antalya, Antalya City, Antalya, Türkiye",
"iata": null,
"lat": 36.8774,
"lng": 30.6656
}
]
}?action=quoteLive-Preise abrufen
Fahrzeuge und Preise für eine Fahrt. Die Preise sind endgültig und gelten pro Fahrzeug, außer pricing ist per_person.
| Parameter | Typ | |
|---|---|---|
from, toPflicht | place id | Aus places, z. B. airport:68. Oder from_lat, from_lng, from_label. |
date, timePflicht | YYYY-MM-DD, HH:MM | Lokale Abholzeit |
passengers | int | 1–30, Standard 2 |
round, return_date, return_time | 1 + date/time | Hin- und Rückfahrt |
currency | EUR · GBP · USD · TRY … | Standard EUR |
lang | en · tr · de · ru | Sprache von Namen und Links |
- Die Preise werden nach denselben Regeln wie auf unserer Website berechnet. Es wird nichts gebucht.
payment_methodszeigt, womit der Reisende je Fahrzeug zahlen kann.booking_urlöffnet unseren Checkout mit Ihrem Partnercode. Buchungen innerhalb von 30 Tagen werden Ihnen gutgeschrieben.
curl 'https://transferise.com/api/widget.php?action=quote&from=airport%3A68&to=hotel%3A17370&date=2026-12-02&time=14%3A00&passengers=2¤cy=GBP' \
-H 'X-Api-Key: tfx_test_…'const res = await fetch(
'https://transferise.com/api/widget.php?action=quote&from=airport%3A68&to=hotel%3A17370&date=2026-12-02&time=14%3A00&passengers=2¤cy=GBP',
{ headers: { 'X-Api-Key': process.env.TRANSFERISE_KEY } }
);
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=quote&from=airport%3A68&to=hotel%3A17370&date=2026-12-02&time=14%3A00&passengers=2¤cy=GBP');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true); {
"ok": true,
"test": false,
"from": "Antalya Airport (AYT)",
"to": "Rixos Downtown Antalya",
"date": "2026-12-02",
"time": "14:00",
"passengers": 2,
"round_trip": false,
"vehicles": [
{
"id": 60,
"name": "Standard Sedan",
"type": "private",
"pricing": "per_vehicle",
"max_passengers": 3,
"max_luggage": 3,
"price": 25.04,
"currency": "GBP",
"price_eur": 30,
"payment_methods": [
"iyzico_full"
]
}
],
"booking_url": "https://transferise.com/search?from=…&ref=p12&utm_source=partner&utm_medium=widget&utm_content=api"
}?action=bookBuchung anlegen
Buchen Sie ein Fahrzeug aus einem aktuellen Angebot. Vorlaufzeit und Routenprüfung sind wie auf unserer Website.
| Parameter | Typ | |
|---|---|---|
vehicle_idPflicht | int | Aus quote |
from, to, date, timePflicht | Wie bei quote | |
customerPflicht | object | first_name, last_name, email, phone |
adults, children, infants | int | Aufteilung der Reisenden |
round_trip, return_date, return_time | Hin- und Rückfahrt | |
flight_number, hotel, notes | string | Hilft dem Fahrer |
payment_method | string | Einer der payment_methods aus quote |
partner_reference | string ≤ 64 | Ihre eigene ID. Bei Wiederholung kommt die bestehende Buchung zurück. |
- Eine Buchung mit eigener
referencewird angelegt. Mit einem Sandbox-Schlüssel ist es eineTEST-…-Buchung, die nur Sie sehen. - API-Buchungen werden derzeit vollständig per Karte bezahlt. Die Buchung bleibt
pending_payment, bis der Reisende aufpayment_url(3-D Secure) zahlt, und wird dannconfirmed. - Der Reisende erhält unsere Bestätigungs-E-Mail. Unser Team teilt den Fahrer zu.
- Ein erneuter Versuch mit derselben
partner_referencelegt nie eine zweite Buchung an.
curl -X POST 'https://transferise.com/api/widget.php?action=book' \
-H 'X-Api-Key: tfx_test_…' \
-H 'Content-Type: application/json' \
-d '{"vehicle_id":60,"from":"airport:68","to":"hotel:17370","date":"2026-12-02","time":"14:00","round_trip":true,"return_date":"2026-12-09","return_time":"10:00","adults":2,"currency":"GBP","lang":"en","customer":{"first_name":"Anna","last_name":"Smith","email":"anna@example.com","phone":"+447700900123"},"flight_number":"TK123","payment_method":"iyzico_full","partner_reference":"ARF-1001"}'const res = await fetch('https://transferise.com/api/widget.php?action=book', {
method: 'POST',
headers: {
'X-Api-Key': process.env.TRANSFERISE_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"vehicle_id": 60,
"from": "airport:68",
"to": "hotel:17370",
"date": "2026-12-02",
"time": "14:00",
"round_trip": true,
"return_date": "2026-12-09",
"return_time": "10:00",
"adults": 2,
"currency": "GBP",
"lang": "en",
"customer": {
"first_name": "Anna",
"last_name": "Smith",
"email": "anna@example.com",
"phone": "+447700900123"
},
"flight_number": "TK123",
"payment_method": "iyzico_full",
"partner_reference": "ARF-1001"
}),
});
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=book');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'vehicle_id' => 60,
'from' => 'airport:68',
'to' => 'hotel:17370',
'date' => '2026-12-02',
'time' => '14:00',
'round_trip' => true,
'return_date' => '2026-12-09',
'return_time' => '10:00',
'adults' => 2,
'currency' => 'GBP',
'lang' => 'en',
'customer' => [
'first_name' => 'Anna',
'last_name' => 'Smith',
'email' => 'anna@example.com',
'phone' => '+447700900123',
],
'flight_number' => 'TK123',
'payment_method' => 'iyzico_full',
'partner_reference' => 'ARF-1001',
]),
]);
$data = json_decode(curl_exec($ch), true); {
"ok": true,
"booking": {
"reference": "TRS-7F3A21C",
"status": "pending_payment",
"payment_method": "iyzico_full",
"payment_status": "pending",
"total": 50.08,
"currency": "GBP",
"vehicle": {
"id": 60,
"name": "Standard Sedan"
},
"round_trip": true,
"passengers": {
"adults": 2,
"children": 0,
"infants": 0,
"total": 2
},
"customer": {
"first_name": "Anna",
"last_name": "Smith",
"email": "anna@example.com",
"phone": "+447700900123"
},
"notes": "",
"legs": [
{
"id": 9812,
"type": "outbound",
"status": "confirmed",
"from": "Antalya Airport (AYT)",
"to": "Rixos Downtown Antalya",
"pickup_date": "2026-12-02",
"pickup_time": "14:00",
"flight_number": "TK123",
"hotel": "",
"can_modify": true,
"hours_until_pickup": 331.5
},
{
"id": 9813,
"type": "return",
"status": "confirmed",
"from": "Rixos Downtown Antalya",
"to": "Antalya Airport (AYT)",
"pickup_date": "2026-12-09",
"pickup_time": "10:00",
"flight_number": "",
"hotel": "",
"can_modify": true,
"hours_until_pickup": 499.5
}
],
"payment_url": "https://transferise.com/payment/iyzico/TRS-7F3A21C",
"manage_url": "https://transferise.com/my-booking",
"partner_reference": "ARF-1001",
"test": false
}
}?action=bookingBuchung abrufen
Eine von Ihnen angelegte Buchung mit dem aktuellen Status jeder Fahrt (Hin- und Rückfahrt).
| Parameter | Typ | |
|---|---|---|
referencePflicht | string | Oder partner_reference |
- Nur lesend. Es wird nichts gespeichert.
- Jede Fahrt zeigt
status,can_modifyundhours_until_pickup. - Fragen Sie dies regelmäßig ab oder nutzen Sie den Sync des Supabase-Kits, um Statusänderungen zu verfolgen.
curl 'https://transferise.com/api/widget.php?action=booking&reference=TRS-7F3A21C' \
-H 'X-Api-Key: tfx_test_…'const res = await fetch(
'https://transferise.com/api/widget.php?action=booking&reference=TRS-7F3A21C',
{ headers: { 'X-Api-Key': process.env.TRANSFERISE_KEY } }
);
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=booking&reference=TRS-7F3A21C');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true); { "ok": true, "booking": { … same shape as book … } }?action=bookingsBuchungen auflisten
Ihre Buchungen nach Abholdatum, 50 pro Seite.
| Parameter | Typ | |
|---|---|---|
from, to | YYYY-MM-DD | Standard −30 / +365 Tage |
page | int | Standard 1 |
- Nur lesend. Es wird nichts gespeichert.
- Es werden nur Buchungen mit Ihren Schlüsseln angezeigt.
curl 'https://transferise.com/api/widget.php?action=bookings&from=2026-11-01&to=2027-01-31' \
-H 'X-Api-Key: tfx_test_…'const res = await fetch(
'https://transferise.com/api/widget.php?action=bookings&from=2026-11-01&to=2027-01-31',
{ headers: { 'X-Api-Key': process.env.TRANSFERISE_KEY } }
);
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=bookings&from=2026-11-01&to=2027-01-31');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true); { "ok": true, "page": 1, "per_page": 50, "bookings": [ … ] }?action=updateBuchung ändern
Ändern Sie Abholdatum oder -zeit, Flugnummer, Hotel oder Notizen einer Fahrt.
| Parameter | Typ | |
|---|---|---|
referencePflicht | string | Oder partner_reference |
leg_id | int | Standard: Hinfahrt |
pickup_date, pickup_time, flight_number, hotel, notes | Zu ändernde Felder |
- Die Fahrt wird sofort aktualisiert.
- Reisender, Fahrer und unser Team werden automatisch informiert.
- Möglich, bis das Änderungsfenster schließt (standardmäßig 24 Std. vor Abholung). Danach erhalten Sie
409 not_modifiable.
curl -X POST 'https://transferise.com/api/widget.php?action=update' \
-H 'X-Api-Key: tfx_test_…' \
-H 'Content-Type: application/json' \
-d '{"reference":"TRS-7F3A21C","leg_id":9812,"pickup_time":"15:30","flight_number":"TK999"}'const res = await fetch('https://transferise.com/api/widget.php?action=update', {
method: 'POST',
headers: {
'X-Api-Key': process.env.TRANSFERISE_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"reference": "TRS-7F3A21C",
"leg_id": 9812,
"pickup_time": "15:30",
"flight_number": "TK999"
}),
});
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=update');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'TRS-7F3A21C',
'leg_id' => 9812,
'pickup_time' => '15:30',
'flight_number' => 'TK999',
]),
]);
$data = json_decode(curl_exec($ch), true); { "ok": true, "booking": { … } }?action=cancelBuchung stornieren
Stornieren Sie eine Fahrt (leg_id) oder die ganze Buchung (ohne leg_id).
| Parameter | Typ | |
|---|---|---|
referencePflicht | string | Oder partner_reference |
leg_id | int | Nur diese Fahrt stornieren |
- Die Fahrt oder Buchung wird
cancelled, der Fahrer wird freigegeben. - Kostenlos, bis das Stornofenster schließt. Kartenzahlungen werden gemäß unserer Erstattungsrichtlinie erstattet.
- Der Reisende wird informiert.
curl -X POST 'https://transferise.com/api/widget.php?action=cancel' \
-H 'X-Api-Key: tfx_test_…' \
-H 'Content-Type: application/json' \
-d '{"reference":"TRS-7F3A21C"}'const res = await fetch('https://transferise.com/api/widget.php?action=cancel', {
method: 'POST',
headers: {
'X-Api-Key': process.env.TRANSFERISE_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"reference": "TRS-7F3A21C"
}),
});
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=cancel');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'TRS-7F3A21C',
]),
]);
$data = json_decode(curl_exec($ch), true); { "ok": true, "booking": { "status": "cancelled", … } }Transferise for Supabase
Ein Open-Source-Kit (MIT), das jeder App auf Supabase Flughafentransfers hinzufügt. Buchungen liegen mit Row Level Security in Ihrer eigenen Supabase-Datenbank, und jede Statusänderung kommt über Supabase Realtime in Ihre App. Kein eigenes Buchungs-Backend nötig.
Buchungen in Ihrer Datenbank
Eine Migration legt transferise_bookings und eine Statushistorie an. Abfragen wie bei jeder Tabelle.
Live-Status
Eine geplante Funktion aktualisiert offene Buchungen. Realtime sendet confirmed → assigned → completed an den angemeldeten Inhaber.
Standardmäßig sicher
Dank RLS lesen Nutzer nur eigene Zeilen, und niemand schreibt aus dem Browser. Der API-Schlüssel bleibt ein Edge-Function-Secret. E-Mail und Telefon der Reisenden werden nicht gespeichert.
1. Installation
Holen Sie einen Sandbox-Schlüssel, spielen Sie die Migration ein, setzen Sie die Secrets und deployen Sie die zwei Funktionen.
- Ihr Projekt erhält zwei Tabellen mit RLS, Triggern und Realtime.
transferise(JWT nötig) undtransferise-sync(gemeinsames Secret) werden deployt.- Ihr Schlüssel wird nur als Funktions-Secret gespeichert.
supabase link --project-ref <project-ref>
supabase db push
supabase secrets set \
TRANSFERISE_API_KEY=tfx_test_xxx \
SYNC_SECRET=$(openssl rand -hex 24)
supabase functions deploy transferise
supabase functions deploy transferise-sync --no-verify-jwt Applying migration 20261113000000_transferise.sql...
Finished supabase db push.
Finished supabase secrets set.
Deployed Functions: transferise, transferise-sync2. Preise abrufen und buchen
Rufen Sie die Edge Function mit supabase.functions.invoke auf. Der angemeldete Nutzer wird Inhaber der Buchung.
- Die Funktion prüft das JWT des Nutzers und ruft die Transferise-API mit Ihrem geheimen Schlüssel auf.
- In
transferise_bookingswird eine Zeile mit Referenz, Route, Zeit, Preis und Status geschrieben. - Ist eine Kartenzahlung nötig, wird
payment_urlfür den Reisenden zurückgegeben.
const { data: quote } = await supabase.functions.invoke('transferise', {
body: { action: 'quote', from: 'airport:68', to: 'hotel:17370',
date: '2026-12-02', time: '14:00', passengers: 2 },
});
const { data } = await supabase.functions.invoke('transferise', {
body: {
action: 'book', from: 'airport:68', to: 'hotel:17370',
date: '2026-12-02', time: '14:00', passengers: 2,
vehicle_id: quote.vehicles[0].id, flight_number: 'TK123',
customer: { first_name: 'Anna', last_name: 'Smith',
email: 'anna@example.com', phone: '+447700900123' },
},
});
if (data.booking.payment_url) location.href = data.booking.payment_url; {
"booking": {
"id": "7b1c…",
"reference": "TRS-7F3A21C",
"status": "pending_payment",
"from_label": "Antalya Airport (AYT)",
"to_label": "Rixos Downtown Antalya",
"pickup_date": "2026-12-02",
"pickup_time": "14:00:00",
"total": 25.04,
"currency": "GBP",
"payment_url": "https://transferise.com/payment/iyzico/TRS-7F3A21C"
}
}3. Live-Status anzeigen
Abonnieren Sie Änderungen. RLS sorgt dafür, dass jeder Nutzer nur seine eigenen Buchungen erhält.
transferise-syncläuft per pg_cron alle 5 Minuten und aktualisiert offene Buchungen.- Jede Statusänderung wird in die Tabelle und in
transferise_booking_eventsgeschrieben. - Realtime schickt die Änderung an den Browser. Kein Polling in Ihrer App.
supabase
.channel('my-transfers')
.on('postgres_changes',
{ event: 'UPDATE', schema: 'public', table: 'transferise_bookings' },
(p) => updateCard(p.new.reference, p.new.status))
.subscribe(); {
"eventType": "UPDATE",
"table": "transferise_bookings",
"old": {
"status": "confirmed"
},
"new": {
"reference": "TRS-7F3A21C",
"status": "assigned",
"pickup_date": "2026-12-02",
"pickup_time": "14:00:00"
}
}supabase/migrations/…_transferise.sqltables, triggers, RLS, Realtimesupabase/functions/transferise/places · quote · book · status · cancelsupabase/functions/transferise-sync/status syncsupabase/cron.sqlpg_cron + Vaulttests/SQL/RLS, unit, sandbox
Fehler
Fehler liefern {"ok": false, "error": "…"} mit HTTP-Status. Manche enthalten eine lesbare message.
| HTTP | error | Bedeutung |
|---|---|---|
| 401 | invalid_api_key | Schlüssel fehlt oder ist falsch, oder die Anfrage kommt von einer Domain, für die der Live-Schlüssel nicht freigegeben ist. |
| 400 | from_to_required · reference_required · q_too_short | Ein Pflichtparameter fehlt. |
| 404 | booking_not_found · leg_not_found | Nicht Ihre Buchung oder falsche Fahrt-ID. |
| 405 | use_post | book, update und cancel benötigen POST. |
| 409 | not_modifiable · already_cancelled | Das Änderungs- oder Stornofenster ist geschlossen, oder die Buchung ist bereits storniert. |
| 422 | booking_rejected | message nennt den Grund: Preis geändert (neu anfragen), Vorlauf zu kurz, Kontaktdaten fehlen… |
| 429 | rate_limited | 120 Anfragen/Min. pro Schlüssel; 30 Buchungen/Std. pro Live-Schlüssel. |
Buchungsregeln
- Zahlung:
cash_driver(beim Fahrer),iyzico_split(Anzahlung per Karte, Rest bar),iyzico_full(komplett per Karte). Nur diepayment_methodsaus quote werden akzeptiert. API-Buchungen nutzen derzeitiyzico_full. - Änderung und Storno: kostenlos bis zum Ende des Fensters (standardmäßig 24 Std. vor jeder Abholung). Danach
manage_urlnutzen oder den Support kontaktieren. - Kommunikation: Der Reisende erhält unsere Bestätigungs-E-Mail mit Fahrerdaten und dem Link „Meine Buchung“. Änderungen per API werden Reisendem und Fahrer mitgeteilt.
- Zuordnung: Buchungen mit Ihrem Schlüssel und Buchungen innerhalb von 30 Tagen nach Öffnen Ihrer
booking_urltragen Ihren Partnercode. - Faire Nutzung: Richtlinie zur zulässigen Nutzung
Bereit loszulegen?
Holen Sie sich in Minuten einen Sandbox-Schlüssel und machen Sie heute Ihre erste Buchung. Live-Schlüssel nach kurzer Prüfung.
