TRANSFERISE PARTNER API · V1 · СПРАВОЧНИК

Документация API трансферов из аэропорта

Ищите места, получайте актуальные цены, создавайте, изменяйте и отменяйте частные трансферы из аэропорта через один JSON API. Для каждого запроса справа показаны вызов и точный ответ. Разрабатывайте с бесплатным sandbox-ключом: до запуска ничего не доходит до водителей и платежей.

27аэропортов
11стран
7endpoints
JSONREST · HTTPS
Бесплатноsandbox

Быстрый старт

Три вызова — от «куда едем?» до забронированного трансфера.

  1. 1
    Найдите местаplaces превращает «AYT» или название отеля в id места.
  2. 2
    Покажите ценыquote возвращает все автомобили с окончательной ценой.
  3. 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_…'
Без действующего ключа → 401
{
    "ok": false,
    "error": "invalid_api_key",
    "docs": "https://transferise.com/developers/docs"
}

Этапы бронирования

Бронирование проходит эти статусы. booking всегда возвращает текущий.

quoteцена показана
→
pending_paymentоплата на payment_url
→
confirmedписьмо путешественнику
→
assignedводитель назначен
→
completedтрансфер выполнен

cancelled возможен для участка или всего бронирования, пока окно отмены открыто.

GET?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);
Ответ · 200 OK
{
    "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
        }
    ]
}
GET?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Местное время подачи
passengersint1–30, по умолчанию 2
round, return_date, return_time1 + date/timeТуда и обратно
currencyEUR · GBP · USD · TRY …По умолчанию EUR
langen · 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&currency=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&currency=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&currency=GBP');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
Ответ · 200 OK
{
    "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"
}
POST?action=book

Создать бронирование

Бронируйте автомобиль из свежего расчёта цены. Минимальный срок и проверки маршрута такие же, как на сайте.

ПараметрТип
vehicle_idобязательноintИз quote
from, to, date, timeобязательноКак в quote
customerобязательноobjectfirst_name, last_name, email, phone
adults, children, infantsintСостав пассажиров
round_trip, return_date, return_timeТуда и обратно
flight_number, hotel, notesstringПомогает водителю
payment_methodstringОдин из payment_methods из quote
partner_referencestring ≤ 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);
Ответ · 201 Created
{
    "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
    }
}
GET?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);
Ответ · 200 OK
{ "ok": true, "booking": { … same shape as book … } }
GET?action=bookings

Список бронирований

Ваши бронирования по дате подачи, по 50 на странице.

ПараметрТип
from, toYYYY-MM-DDПо умолчанию −30 / +365 дней
pageintПо умолчанию 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);
Ответ · 200 OK
{ "ok": true, "page": 1, "per_page": 50, "bookings": [ … ] }
POST?action=update

Изменить бронирование

Измените дату или время подачи, номер рейса, отель или примечания участка.

ПараметрТип
referenceобязательноstringИли partner_reference
leg_idintПо умолчанию: участок туда
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);
Ответ · 200 OK
{ "ok": true, "booking": { … } }
POST?action=cancel

Отменить бронирование

Отмените один участок (leg_id) или всё бронирование (без leg_id).

ПараметрТип
referenceобязательноstringИли partner_reference
leg_idintОтменить только этот участок
Что происходит
  • Участок или бронирование получает статус 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);
Ответ · 200 OK
{ "ok": true, "booking": { "status": "cancelled", … } }
Интеграция

Transferise for Supabase

Набор с открытым кодом (MIT), который добавляет трансферы из аэропорта в любое приложение на Supabase. Бронирования хранятся в вашей базе Supabase с Row Level Security, а каждое изменение статуса приходит в приложение через Supabase Realtime. Свой бэкенд бронирования не нужен.

Ваше приложениеsupabase-js
invoke →
Edge Functiontransferise
X-Api-Key →
Transferise APIquote · book · cancel
Postgres + RLStransferise_bookings
pg_cron syncкаждые 5 минут
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-sync

2. Цена и бронирование из приложения

Вызывайте 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();
Событие Realtime в приложении
{
    "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.sql tables, triggers, RLS, Realtime
  • supabase/functions/transferise/ places · quote · book · status · cancel
  • supabase/functions/transferise-sync/ status sync
  • supabase/cron.sql pg_cron + Vault
  • tests/ SQL/RLS, unit, sandbox

Ошибки

Ошибки возвращают {"ok": false, "error": "…"} с HTTP-статусом. Некоторые содержат понятное message.

HTTPerrorЗначение
401invalid_api_keyКлюч отсутствует или неверен, либо запрос идёт с домена, к которому рабочий ключ не привязан.
400from_to_required · reference_required · q_too_shortНе хватает обязательного параметра.
404booking_not_found · leg_not_foundЭто не ваше бронирование или неверный id участка.
405use_postДля book, update и cancel нужен POST.
409not_modifiable · already_cancelledОкно изменения или отмены закрыто, либо бронирование уже отменено.
422booking_rejectedmessage объясняет причину: цена изменилась (запросите снова), слишком поздно, нет контактных данных…
429rate_limited120 запросов/мин на ключ; 30 бронирований/час на рабочий ключ.

Правила бронирования

  • Оплата: cash_driver (водителю), iyzico_split (предоплата картой, остальное наличными), iyzico_full (полностью картой). Принимаются только payment_methods из quote. Сейчас бронирования через API используют iyzico_full.
  • Изменение и отмена: бесплатно, пока окно открыто (по умолчанию за 24 ч до каждой подачи). Затем используйте manage_url или поддержку.
  • Связь с путешественником: он получает наше письмо-подтверждение с данными водителя и ссылкой «Моё бронирование». Изменения через API сообщаются путешественнику и водителю.
  • Атрибуция: бронирования вашим ключом и в течение 30 дней после перехода по вашему booking_url получают ваш партнёрский код.
  • Добросовестное использование: Политика допустимого использования

Готовы начать?

Получите sandbox-ключ за несколько минут и сделайте первое бронирование сегодня. Рабочие ключи выдаются после короткой проверки.

Получить sandbox-ключ →