Mulai cepat
Panduan ini membawa kamu dari nol sampai memanggil endpoint pertama (ambil token) dalam hitungan menit. Cakupan rilis ini: produk Courier.
Langkah 0 — Kredensial dan akses
Dua hal yang perlu disiapkan sebelum menulis kode, keduanya tidak bisa didapat sendiri lewat portal ini:
- Kredensial sandbox (
client_iddanclient_secret) — hubungi Tim ACI. untuk diterbitkan. - Whitelist IP produksi — sebelum go-live, kirim IP publik server kamu ke tim yang sama. Tanpa whitelist, permintaan ke environment produksi ditolak. Detail lengkap ada di Environment.
Kalau dua hal di atas belum ada, langkah selanjutnya di bawah akan gagal dengan 401 Unauthorized.
Alur integrasi
flowchart LR
A[Ambil token] --> B[Cek ongkir]
B --> C[Buat order]
C --> D[Terima callback]
D --> E[Go-live:<br/>whitelist IP + kredensial prod]
Langkah 1 — Ambil token
curl -X POST https://sandbox-partner-gateaway-aci.bmsecure.id/api/v1/token \
-H "Authorization: Basic <BASE64(client_id:client_secret)>" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials"
Simpan access_token dari response — berlaku 7 hari, tidak perlu diminta ulang setiap request. Detail lengkap: Autentikasi.
Langkah 2 — Cek ongkir
Panggil POST /api/v1/courier/shipping-cost dengan alamat pickup dan tujuan. Response berisi shipping_cost_id yang dipakai di langkah berikutnya. Detail: Cek ongkir.
Langkah 3 — Buat order
Panggil POST /api/v1/courier/order dengan shipping_cost_id dari langkah sebelumnya. Detail: Buat order.
Langkah 4 — Terima callback status
ACI memanggil URL callback yang kamu daftarkan setiap status order berubah. Wajib dibalas 200. Detail kontrak dan tabel status: Callback.
Langkah 5 — Go-live
Setelah integrasi sandbox lancar, kirim IP produksi untuk di-whitelist dan minta kredensial produksi ke Tim ACI. Lihat perbedaan sandbox vs produksi di Environment.