Callback
ACI memberi tahu perubahan status order dengan memanggil URL callback yang kamu daftarkan — bukan kamu yang polling ke ACI. Endpoint ini diimplementasikan di server kamu, bukan disediakan oleh ACI.
Kontrak
- Method:
POST - Header:
Authorization: Bearer <ACCESS_TOKEN> - Wajib balas
200untuk konfirmasi callback diterima. - Jika response ditolak (selain
200) atau timeout, ACI retry tiap 30 detik.
Contoh payload
{
"orderId": 3341647,
"duration": 4000,
"serviceTypeId": 9,
"orderState": "03",
"orderStatus": "Driver mengirim barang ke tujuan penerima ke 2",
"notificationType": "update",
"paymentStatus": -1,
"type": 4,
"driverStatus": 0,
"unreadCount": 0,
"driverInfo": {
"driverId": 11,
"driverName": "Rambo Markimbo",
"driverRating": 4.9,
"licensePlate": "W 4 AJA",
"vehicleCategory": "RODA 2",
"vehicleType": "Honda Genio",
"vehicleColor": "Hitam Legam",
"phoneNumber": "<PHONE>",
"profilePhoto": "<DRIVER_PHOTO_URL>"
},
"routeInfo": {
"polyline": "<ENCODED_POLYLINE>",
"completePolyline": "<ENCODED_POLYLINE>",
"driverLocation": "-7.3601965,112.7430698",
"driverActualLocation": "-7.3601965,112.7430698",
"driverPredictionLocation": "-7.36767,112.72907",
"distance": 1.75,
"distanceStatus": "Above 1 KM",
"statusId": 1
},
"totalDistance": 4084,
"cancellationDetail": "",
"isEtaChange": 0,
"minEta": "14:41",
"maxEta": "14:51",
"orderTime": "2026-09-22 13:57:14.564487",
"reffIdUserPartner": "10069",
"reffOrderTrxPartner": ""
}
Respons yang diharapkan dari server kamu
{
"message": "OK"
}
Tabel orderState
Field orderState di payload adalah kode dua karakter yang menandai posisi order dalam alurnya:
| Kode | Arti |
|---|---|
00 | Sukses / order selesai |
01 | Driver menuju lokasi penjemputan |
02 | On progress / barang diterima, siap diantar |
03 | Driver mengantar ke tujuan |
04 | Menunggu pembayaran |
05 | Order berhasil dibuat, sedang mencari driver |
X1 | Driver tidak ditemukan |
X2 | Cancel by driver |
X3 | Cancel by user |
X4 | Pembayaran gagal / kedaluwarsa |
Kode berawalan X menandai order gagal/dibatalkan — kelompokkan penanganannya terpisah dari alur sukses di sistem kamu.
Langkah berikutnya
Kalau butuh melihat status order tanpa menunggu callback (misal setelah restart service), pakai Detail order atau Riwayat order.