JetWize Partner API

Integrasikan sistem Anda dengan platform pemesanan tiket penerbangan JetWize. API ini memungkinkan Anda mencari penerbangan, membuat booking, dan memproses pembayaran secara programatik.

Overview

Endpoint sandbox dan production menggunakan URL yang sama. Perbedaannya ditentukan oleh jenis API key yang digunakan (jwz_test_* atau jwz_live_*).

Environments

Authentication

Semua request ke Partner API memerlukan API key. Gunakan salah satu metode berikut:

X-API-Key: jwz_test_a1b2c3d4e5f6...

Authorization: Bearer jwz_test_a1b2c3d4e5f6...

Mendapatkan API Key

API key dikelola melalui dashboard JetWize oleh admin agensi Anda:

1. Login ke jetwize.com
2. Buka Settings → API Keys
3. Klik Buat API Key Baru
4. Pilih environment: Sandbox atau Production

Common Errors

Semua error mengembalikan format JSON yang konsisten:

{
  "error": {
    "code": "BOOKING_EXPIRED",
    "message": "Booking hold telah kadaluarsa",
    "details": { "bookingId": "..." },
    "traceId": "req-abc123"
  }
}

Tabel di bawah ini berisi error yang bisa terjadi di endpoint mana pun (auth, rate-limit, server-side). Untuk error spesifik per-endpoint, lihat bagian Possible Errors di setiap endpoint.

GET /me — Info API Key

{
  "apiKey": {
    "id": "clx123...",
    "name": "My Integration",
    "environment": "SANDBOX"
  },
  "agency": {
    "id": "clx456...",
    "name": "PT Maju Travel"
  },
  "wallet": {
    "balance": 999999999,
    "holdBalance": 0,
    "currency": "IDR"
  },
  "sandbox": true
}

Flight Search

Cari penerbangan tersedia berdasarkan rute, tanggal, dan jumlah penumpang. Endpoint ini di-aggregate dari semua supplier aktif (JGT, FR24, dll.) dan return list offer yang siap di-booking.

Request Body

POST /api/v1/partner/v1/flights/search
X-API-Key: jwz_test_...

{
  "origin": "CGK",
  "destination": "DPS",
  "departDate": "2026-06-15",
  "passengers": { "adult": 2, "child": 0, "infant": 0 },
  "cabinClass": "ECONOMY"
}

{
  "results": [
    {
      "id": "MOCK-CGK-DPS-2026-06-15-1",
      "supplierCode": "MOCK",
      "segments": [
        {
          "flightNumber": "GA405",
          "carrier": "GA",
          "carrierName": "Garuda Indonesia",
          "origin": "CGK",
          "destination": "DPS",
          "departureTime": "2026-06-15T06:00:00.000Z",
          "arrivalTime": "2026-06-15T08:55:00.000Z",
          "duration": 115,
          "cabinClass": "ECONOMY",
          "baggageAllowance": "20kg"
        }
      ],
      "stops": 0,
      "totalDuration": 115,
      "basePrice": 850000,
      "tax": 93500,
      "totalPrice": 943500,
      "currency": "IDR",
      "seatsAvailable": 9
    }
  ],
  "count": 5,
  "sandbox": true
}

Price Check

Verifikasi ulang harga + availability offer sebelum buat booking. Wajib dipanggil antara flights/search dan POST /bookings — harga supplier bisa berubah dalam hitungan menit. Kalau priceChanged: true, tampilkan harga baru ke user untuk konfirmasi sebelum booking.

Request Body

POST /api/v1/partner/v1/flights/price-check
X-API-Key: jwz_test_...

{ "offerId": "MOCK-CGK-DPS-2026-06-15-1" }

{
  "offerId": "MOCK-CGK-DPS-2026-06-15-1",
  "priceChanged": false,
  "previousPrice": null,
  "currentPrice": 943500,
  "currency": "IDR",
  "stillAvailable": true
}

Response Fields

Bookings

Request Body

Passenger Object

POST /api/v1/partner/v1/bookings
X-API-Key: jwz_test_...

{
  "offerId": "MOCK-CGK-DPS-2026-06-15-1",
  "passengers": [
    {
      "title": "MR",
      "firstName": "BUDI",
      "lastName": "SANTOSO",
      "dateOfBirth": "1990-01-15",
      "nationality": "ID",
      "passportNo": "A1234567",
      "passportExpiry": "2030-01-01",
      "type": "ADULT"
    }
  ],
  "contact": {
    "name": "BUDI SANTOSO",
    "phone": "+6281234567890",
    "email": "[email protected]"
  }
}

{
  "id": "clx789...",
  "bookingCode": "JWZ-20260615-ABC123",
  "status": "PENDING_PAYMENT",
  "expiresAt": "2026-06-15T07:30:00.000Z",
  "totalAmount": 943500,
  "currency": "IDR"
}

Query Parameters

Request Body

{
  "url": "https://storage.jetwize.com/eticket/...?signature=...&expires=...",
  "expiresAt": "2026-06-15T12:15:00.000Z"
}

Wallet

{
  "balance": 5000000,
  "holdBalance": 943500,
  "currency": "IDR",
  "sandbox": false
}

Booking Flow

1. POST /flights/search          → Dapat daftar offer + offerId
2. POST /flights/price-check     → Verifikasi harga masih valid
3. POST /bookings                → Buat booking (hold 30 menit)
   └─ Response: bookingId, expiresAt, totalAmount
4. GET  /wallet                  → Cek saldo cukup
5. POST /bookings/:id/pay        → Bayar dengan wallet
   └─ Jika bayar dari luar → topup wallet dulu via dashboard
6. GET  /bookings/:id            → Poll status (PAID → ISSUED)
7. GET  /bookings/:id/ticket     → Download e-ticket

Webhooks

JetWize mengirimkan notifikasi ke URL webhook Anda saat status booking berubah. Daftarkan webhook URL di dashboard Settings → Webhooks.

Event Types

POST https://your-server.com/webhook
Content-Type: application/json
X-JetWize-Signature: sha256=...

{
  "event": "booking.issued",
  "bookingId": "clx789...",
  "bookingCode": "JWZ-20260615-ABC123",
  "status": "ISSUED",
  "tickets": ["0123456789"],
  "issuedAt": "2026-06-15T07:15:00.000Z"
}

Code Examples

JavaScript / Node.js

const API = 'https://api.jetwize.com/api/v1/partner/v1';
const KEY = process.env.JETWIZE_API_KEY; // jwz_test_... atau jwz_live_...

async function searchFlights(origin, destination, date) {
  const res = await fetch(`${API}/flights/search`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': KEY,
    },
    body: JSON.stringify({
      origin, destination,
      departDate: date,
      passengers: { adult: 1, child: 0, infant: 0 },
      cabinClass: 'ECONOMY',
    }),
  });
  if (!res.ok) throw new Error(await res.text());
  return res.json();
}

// Full booking flow
async function bookFlight() {
  // 1. Search
  const { results } = await searchFlights('CGK', 'DPS', '2026-06-15');
  const offer = results[0];

  // 2. Price check
  const priceCheck = await fetch(`${API}/flights/price-check`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-API-Key': KEY },
    body: JSON.stringify({ offerId: offer.id }),
  }).then(r => r.json());
  if (!priceCheck.stillAvailable) throw new Error('Penerbangan tidak tersedia');

  // 3. Create booking
  const booking = await fetch(`${API}/bookings`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-API-Key': KEY },
    body: JSON.stringify({
      offerId: offer.id,
      passengers: [{ title: 'MR', firstName: 'BUDI', lastName: 'SANTOSO',
        dateOfBirth: '1990-01-15', nationality: 'ID', type: 'ADULT' }],
      contact: { name: 'BUDI SANTOSO', phone: '+6281234567890' },
    }),
  }).then(r => r.json());

  // 4. Pay
  const payment = await fetch(`${API}/bookings/${booking.id}/pay`, {
    method: 'POST',
    headers: { 'X-API-Key': KEY },
  }).then(r => r.json());

  return { booking, payment };
}

Python

import os, requests

API = 'https://api.jetwize.com/api/v1/partner/v1'
HEADERS = {
    'Content-Type': 'application/json',
    'X-API-Key': os.environ['JETWIZE_API_KEY']
}

def search_flights(origin, destination, depart_date):
    r = requests.post(f'{API}/flights/search', json={
        'origin': origin, 'destination': destination,
        'departDate': depart_date,
        'passengers': {'adult': 1, 'child': 0, 'infant': 0},
        'cabinClass': 'ECONOMY'
    }, headers=HEADERS)
    r.raise_for_status()
    return r.json()['results']

def create_booking(offer_id, passengers, contact):
    r = requests.post(f'{API}/bookings', json={
        'offerId': offer_id,
        'passengers': passengers,
        'contact': contact
    }, headers=HEADERS)
    r.raise_for_status()
    return r.json()

def pay_booking(booking_id):
    r = requests.post(f'{API}/bookings/{booking_id}/pay', headers=HEADERS)
    r.raise_for_status()
    return r.json()

# Usage
offers = search_flights('CGK', 'DPS', '2026-06-15')
booking = create_booking(offers[0]['id'],
    [{'title': 'MR', 'firstName': 'BUDI', 'lastName': 'SANTOSO',
      'dateOfBirth': '1990-01-15', 'nationality': 'ID', 'type': 'ADULT'}],
    {'name': 'BUDI SANTOSO', 'phone': '+6281234567890'}
)
payment = pay_booking(booking['id'])

PHP

<?php
$API = 'https://api.jetwize.com/api/v1/partner/v1';
$KEY = getenv('JETWIZE_API_KEY');

function jetwize_request($method, $path, $body = null) {
    global $API, $KEY;
    $ch = curl_init("$API$path");
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST  => $method,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            "X-API-Key: $KEY",
        ],
        CURLOPT_POSTFIELDS => $body ? json_encode($body) : null,
        CURLOPT_TIMEOUT    => 30,
    ]);
    $res  = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($code >= 400) throw new Exception("API Error $code: $res");
    return json_decode($res, true);
}

// Search
$result = jetwize_request('POST', '/flights/search', [
    'origin' => 'CGK', 'destination' => 'DPS',
    'departDate' => '2026-06-15',
    'passengers' => ['adult' => 1, 'child' => 0, 'infant' => 0],
]);
$offer = $result['results'][0];

// Book & Pay
$booking = jetwize_request('POST', '/bookings', [
    'offerId'    => $offer['id'],
    'passengers' => [['title'=>'MR','firstName'=>'BUDI','lastName'=>'SANTOSO',
                      'dateOfBirth'=>'1990-01-15','nationality'=>'ID','type'=>'ADULT']],
    'contact'    => ['name'=>'BUDI SANTOSO','phone'=>'+6281234567890'],
]);
$payment = jetwize_request('POST', "/bookings/{$booking['id']}/pay");

JetWize Partner API v1 · jetwize.com · Support: [email protected]