API Partner OTA · Pra-rilis

Jual tiket travel
Indonesia dari
platform Anda

Satu API untuk banyak operator travel & shuttle. Inventori kursi realtime — tanpa overbooking, tanpa sinkronisasi manual.

Realtime
Inventori kursi multi-operator
Multi-operator
Banyak operator travel & shuttle
REST
Search · booking · issue · refund
Anti dobel
Single-flight per kursi
REST API

Semua yang Anda butuhkan, satu base URL

Autentikasi tunggal, satu domain. Mulai dari cari jadwal hingga tiket terbit.

Base URL: https://api.sistembusonline.com
GET
/ota/operators
Daftar operator mitra yang terhubung ke API key Anda
GET
/ota/catalog/pickups
Katalog titik pickup per operator
POST
/ota/search/fare
Cari jadwal & harga lintas operator
GET
/ota/seatmap
Peta kursi untuk jadwal tertentu
POST
/ota/booking
Buat booking & hold kursi
GET
/ota/booking/:code
Detail pemesanan
POST
/ota/booking/:code/issue
Terbitkan tiket (potong saldo)
POST
/ota/booking/:code/cancel
Batalkan pemesanan hold
POST
/ota/booking/:code/refund
Proses pengembalian dana tiket terbit
Alur Integrasi

Dari credential ke tiket terbit

Empat langkah untuk mulai menjual tiket travel door-to-door dari platform Anda.

01

Dapatkan API Key

Hubungi tim Sistem Transport untuk menerbitkan X-Ota-Key beserta daftar Operator ID mitra yang bisa Anda akses.

02

Panggil dengan API Key

Sertakan header X-Ota-Key di setiap request — tanpa login atau refresh token.

03

Search & Hold Kursi

Cari jadwal tersedia, pilih kursi, buat booking. Hold berlaku sampai batas waktu operator.

04

Issue Tiket

Setelah pembayaran dikonfirmasi, terbitkan tiket. Nomor tiket di-generate otomatis.

Referensi API

Dokumentasi Endpoint

Kirim X-Ota-Key: {'{API_KEY}'} di setiap request.

POST/ota/search/fare

Cari jadwal & harga lintas operator berdasarkan kota asal-tujuan (mode kota) atau pasangan pickup eksplisit (mode presisi). Mengembalikan daftar trip dari seluruh operator mitra yang terhubung ke API key Anda.

Request Body

FieldTipeKeterangan
dep_datestringTanggal keberangkatan (YYYY-MM-DD) — wajib
paxnumberJumlah penumpang — wajib
from_city / to_citystringMode kota: nama kota asal & tujuan — dicari lintas semua operator mitra Anda
from_kota_id / to_kota_idstringAlternatif from_city/to_city — FK master kota, lebih presisi lintas ejaan
pairs{operatorId,from,to}[]Mode presisi: pasangan pickup eksplisit per operator (alternatif mode kota)
curl -X POST \
  'https://api.sistembusonline.com/ota/search/fare' \
  -H 'X-Ota-Key: {API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "from_city": "Jakarta",
    "to_city": "Surabaya",
    "dep_date": "2026-07-15",
    "pax": 2
  }'
Autentikasi

Autentikasi dengan API key

Partner OTA diautentikasi lewat satu API key statis — bukan login/password. Admin Sistem Transport menerbitkan X-Ota-Key khusus untuk platform Anda, dipetakan ke satu atau lebih operator mitra.

  • Admin Sistem Transport menerbitkan X-Ota-Key untuk platform Anda
  • Satu key bisa dipetakan ke beberapa Operator ID mitra
  • Tidak ada login/expiry/refresh — key berlaku sampai dicabut admin Sistem Transport
  • Kirim key di header: X-Ota-Key: {API_KEY}
Autentikasi
# Autentikasi partner OTA — header X-Ota-Key
# Key diterbitkan oleh admin Sistem Transport per-partner OTA, dipetakan ke satu atau
# lebih operator mitra. Tidak ada login/password — sertakan key di header
# tiap request, tidak ada expiry/refresh.

curl -X GET \
  'https://api.sistembusonline.com/ota/operators' \
  -H 'X-Ota-Key: {API_KEY}'

# Response
{
  "error": 0,
  "data": [
    {
      "operatorId": "op_contoh_travel",
      "operatorName": "Contoh Travel Nusantara",
      "status": "aktif"
    }
  ]
}

# Key salah / tidak ada → 401 UNAUTHENTICATED
# Panggil operatorId di luar mapping key Anda → 403 FORBIDDEN

Format Response

Semua endpoint mengembalikan JSON dengan field error (0 = sukses, 1 = error) dan data. Error detail ada di field message.

Error Codes

SEAT_UNAVAILABLE (kursi habis), FORBIDDEN (scope tidak diizinkan), BOOKING_NOT_FOUND, INSUFFICIENT_CREDIT (saldo kurang).

Rate & Timeout

Search: max 10 req/dtk per agen. Booking: single-flight per kursi, aman dari double-booking. Timeout API: 30 detik.

Siap Berintegrasi?

Mulai jual tiket travel dari platform Anda hari ini

Hubungi tim Sistem Transport untuk mendapatkan X-Ota-Key. Kami akan memetakan key Anda ke OPERATOR_ID mitra yang ingin Anda integrasikan.