API Partner OTA · Pra-rilis

Jual tiket bus AKAP
Indonesia dari
platform Anda

Satu API untuk banyak operator AKAP. Inventori kursi realtime — tanpa overbooking, tanpa sinkronisasi manual.

Realtime
Inventori kursi multi-operator
Multi-PO
Banyak operator AKAP
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 bus AKAP dari platform OTA Anda.

01

Dapatkan API Key

Hubungi tim SBO 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 SBO menerbitkan X-Ota-Key khusus untuk platform Anda, dipetakan ke satu atau lebih operator mitra.

  • Admin SBO 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 SBO
  • Kirim key di header: X-Ota-Key: {API_KEY}
Autentikasi
# Autentikasi partner OTA — header X-Ota-Key
# Key diterbitkan oleh admin SBO 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_pahala_akap",
      "operatorName": "Pahala Kencana",
      "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 bus dari platform Anda hari ini

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