TRANSFERISE PARTNER API · V1 · СПРАВОЧНИК
Документация API трансферов из аэропорта
Ищите места, получайте актуальные цены, создавайте, изменяйте и отменяйте частные трансферы из аэропорта через один JSON API. Для каждого запроса справа показаны вызов и точный ответ. Разрабатывайте с бесплатным sandbox-ключом: до запуска ничего не доходит до водителей и платежей.
Быстрый старт
Три вызова — от «куда едем?» до забронированного трансфера.
- 1Найдите места
placesпревращает «AYT» или название отеля в id места. - 2Покажите цены
quoteвозвращает все автомобили с окончательной ценой. - 3Бронируйте
bookсоздаёт бронирование и при необходимости защищённую ссылку на оплату картой.
Авторизация и sandbox
Передавайте ключ в заголовке X-Api-Key. Все запросы и ответы — JSON (UTF-8).
- Base URL
https://transferise.com/api/widget.php?action=…- Sandbox-ключ
tfx_test_…. Те же места, цены и проверки, что и в рабочем режиме. БронированияTEST-…видны только вам. Без водителей, платежей и писем.- Рабочий ключ
tfx_…. Выдаётся после короткой проверки в консоли партнёра. Можно привязать к вашим доменам.- Безопасность
- Вызывайте
book,updateиcancelс сервера, а не из браузера. Никогда не размещайте рабочий ключ в клиентском коде или публичном репозитории.
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"
}Этапы бронирования
Бронирование проходит эти статусы. booking всегда возвращает текущий.
payment_urlcancelled возможен для участка или всего бронирования, пока окно отмены открыто.
?action=placesПоиск мест
Найдите аэропорт, отель, курорт или адрес. Используйте полученный id в quote и book.
| Параметр | Тип | |
|---|---|---|
qобязательно | string | Текст поиска, минимум 2 символа |
- Только чтение. Ничего не сохраняется.
- Возвращает до 10 совпадений с координатами.
- Места, которых нет в нашем списке, можно забронировать через
from_lat / from_lng / from_label.
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=quoteАктуальные цены
Автомобили и цены для одной поездки. Цены окончательные, за автомобиль, если pricing не равно per_person.
| Параметр | Тип | |
|---|---|---|
from, toобязательно | place id | Из places, напр. airport:68. Или from_lat, from_lng, from_label. |
date, timeобязательно | YYYY-MM-DD, HH:MM | Местное время подачи |
passengers | int | 1–30, по умолчанию 2 |
round, return_date, return_time | 1 + date/time | Туда и обратно |
currency | EUR · GBP · USD · TRY … | По умолчанию EUR |
lang | en · tr · de · ru | Язык названий и ссылок |
- Цены рассчитываются по тем же правилам, что и на сайте. Ничего не бронируется.
payment_methodsпоказывает доступные способы оплаты для каждого автомобиля.booking_urlоткрывает оформление с вашим партнёрским кодом. Бронирования в течение 30 дней засчитываются вам.
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=bookСоздать бронирование
Бронируйте автомобиль из свежего расчёта цены. Минимальный срок и проверки маршрута такие же, как на сайте.
| Параметр | Тип | |
|---|---|---|
vehicle_idобязательно | int | Из quote |
from, to, date, timeобязательно | Как в quote | |
customerобязательно | object | first_name, last_name, email, phone |
adults, children, infants | int | Состав пассажиров |
round_trip, return_date, return_time | Туда и обратно | |
flight_number, hotel, notes | string | Помогает водителю |
payment_method | string | Один из payment_methods из quote |
partner_reference | string ≤ 64 | Ваш собственный id. При повторе возвращается существующее бронирование. |
- Создаётся бронирование со своим
reference. С sandbox-ключом это бронированиеTEST-…, видимое только вам. - Сейчас бронирования через API оплачиваются картой полностью. Статус остаётся
pending_payment, пока путешественник не оплатит наpayment_url(3-D Secure), затем становитсяconfirmed. - Путешественник получает наше письмо-подтверждение. Наша команда назначает водителя.
- Повтор с тем же
partner_referenceникогда не создаёт второе бронирование.
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=bookingПолучить бронирование
Одно ваше бронирование с актуальным статусом каждого участка (туда и обратно).
| Параметр | Тип | |
|---|---|---|
referenceобязательно | string | Или partner_reference |
- Только чтение. Ничего не сохраняется.
- Для каждого участка видны
status,can_modifyиhours_until_pickup. - Опрашивайте этот метод или используйте синхронизацию набора Supabase, чтобы следить за статусом.
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=bookingsСписок бронирований
Ваши бронирования по дате подачи, по 50 на странице.
| Параметр | Тип | |
|---|---|---|
from, to | YYYY-MM-DD | По умолчанию −30 / +365 дней |
page | int | По умолчанию 1 |
- Только чтение. Ничего не сохраняется.
- Показываются только бронирования, сделанные вашими ключами.
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=updateИзменить бронирование
Измените дату или время подачи, номер рейса, отель или примечания участка.
| Параметр | Тип | |
|---|---|---|
referenceобязательно | string | Или partner_reference |
leg_id | int | По умолчанию: участок туда |
pickup_date, pickup_time, flight_number, hotel, notes | Изменяемые поля |
- Участок обновляется сразу.
- Путешественник, водитель и наша команда уведомляются автоматически.
- Возможно, пока не закрылось окно изменений (по умолчанию за 24 ч до подачи). Затем возвращается
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=cancelОтменить бронирование
Отмените один участок (leg_id) или всё бронирование (без leg_id).
| Параметр | Тип | |
|---|---|---|
referenceобязательно | string | Или partner_reference |
leg_id | int | Отменить только этот участок |
- Участок или бронирование получает статус
cancelled, водитель освобождается. - Бесплатно, пока не закрылось окно отмены. Оплата картой возвращается по нашей политике возврата.
- Путешественник получает уведомление.
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
Набор с открытым кодом (MIT), который добавляет трансферы из аэропорта в любое приложение на Supabase. Бронирования хранятся в вашей базе Supabase с Row Level Security, а каждое изменение статуса приходит в приложение через Supabase Realtime. Свой бэкенд бронирования не нужен.
Бронирования в вашей базе
Миграция создаёт transferise_bookings и таблицу истории статусов. Запрашивайте их как любые таблицы.
Статус в реальном времени
Функция по расписанию обновляет открытые бронирования. Realtime передаёт confirmed → assigned → completed владельцу.
Безопасно по умолчанию
RLS позволяет пользователям читать только свои строки, запись из браузера невозможна. API-ключ хранится как секрет Edge Function. E-mail и телефон путешественника не сохраняются.
1. Установка
Получите sandbox-ключ, примените миграцию, задайте секреты и разверните две функции.
- В проект добавляются две таблицы с RLS, триггерами и Realtime.
- Разворачиваются
transferise(нужен JWT) иtransferise-sync(общий секрет). - Ключ хранится только как секрет функции.
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. Цена и бронирование из приложения
Вызывайте Edge Function через supabase.functions.invoke. Владельцем бронирования становится вошедший пользователь.
- Функция проверяет JWT пользователя и вызывает API Transferise с вашим секретным ключом.
- В
transferise_bookingsзаписывается строка с номером, маршрутом, временем, ценой и статусом. - Если нужна оплата картой, возвращается
payment_urlдля путешественника.
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. Показывайте статус
Подпишитесь на изменения. RLS гарантирует, что каждый получает только свои бронирования.
transferise-syncзапускается через pg_cron каждые 5 минут и обновляет открытые бронирования.- Каждое изменение статуса записывается в таблицу и в
transferise_booking_events. - Realtime отправляет обновление в браузер. Опрос в приложении не нужен.
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
Ошибки
Ошибки возвращают {"ok": false, "error": "…"} с HTTP-статусом. Некоторые содержат понятное message.
| HTTP | error | Значение |
|---|---|---|
| 401 | invalid_api_key | Ключ отсутствует или неверен, либо запрос идёт с домена, к которому рабочий ключ не привязан. |
| 400 | from_to_required · reference_required · q_too_short | Не хватает обязательного параметра. |
| 404 | booking_not_found · leg_not_found | Это не ваше бронирование или неверный id участка. |
| 405 | use_post | Для book, update и cancel нужен POST. |
| 409 | not_modifiable · already_cancelled | Окно изменения или отмены закрыто, либо бронирование уже отменено. |
| 422 | booking_rejected | message объясняет причину: цена изменилась (запросите снова), слишком поздно, нет контактных данных… |
| 429 | rate_limited | 120 запросов/мин на ключ; 30 бронирований/час на рабочий ключ. |
Правила бронирования
- Оплата:
cash_driver(водителю),iyzico_split(предоплата картой, остальное наличными),iyzico_full(полностью картой). Принимаются толькоpayment_methodsиз quote. Сейчас бронирования через API используютiyzico_full. - Изменение и отмена: бесплатно, пока окно открыто (по умолчанию за 24 ч до каждой подачи). Затем используйте
manage_urlили поддержку. - Связь с путешественником: он получает наше письмо-подтверждение с данными водителя и ссылкой «Моё бронирование». Изменения через API сообщаются путешественнику и водителю.
- Атрибуция: бронирования вашим ключом и в течение 30 дней после перехода по вашему
booking_urlполучают ваш партнёрский код. - Добросовестное использование: Политика допустимого использования
Готовы начать?
Получите sandbox-ключ за несколько минут и сделайте первое бронирование сегодня. Рабочие ключи выдаются после короткой проверки.
