Guides

Create Your First Shipment

End-to-end: dari API key sampai resi terbit (contoh memakai TEST key → provider simulator, AWB berawalan SIM).

1. API Key — Dashboard → API Keys → buat key TEST.
2. Rates — POST /api/v1/rates dengan origin/destination district_id + weight_grams.
3. Quote — POST /api/v1/quotes memilih courier_code + service_code → dapat quote_id (15 menit).
4. Shipment — POST /api/v1/shipments dengan quote_id + data pengirim/penerima + Idempotency-Key.
5. Payment — WALLET (butuh saldo; top up dulu) atau QRIS/manual.
6. Booking — setelah PAID, job booking jalan otomatis → AWB muncul di GET /shipments/{id}.
7. Tracking — GET /tracking/{awb} + webhook.

Sebelum payment, booking calls = 0 (dijamin oleh state guard). Setelah PAID, tepat satu booking per shipment.

Testing

Key ap_test_ memakai provider simulator — AWB SIM…, tracking berjalan bertahap (beberapa menit sampai DELIVERED). Tidak ada efek ke kurir asli.

Receiving Webhooks

Panduan lengkap menerima webhook: buat endpoint HTTPS, simpan secret, verifikasi HMAC terhadap raw body + timestamp, balas 2xx cepat, proses async, dedupe dengan Delivery ID, tangani retry & out-of-order.

← Kembali ke Overview