Lewati ke konten utama

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:

  1. Kredensial sandbox (client_id dan client_secret) — hubungi Tim ACI. untuk diterbitkan.
  2. 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.

Butuh bantuan?​

Pertanyaan integrasi: Tim ACI. atau halaman Dukungan.