Lewati ke konten utama

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 200 untuk 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:

KodeArti
00Sukses / order selesai
01Driver menuju lokasi penjemputan
02On progress / barang diterima, siap diantar
03Driver mengantar ke tujuan
04Menunggu pembayaran
05Order berhasil dibuat, sedang mencari driver
X1Driver tidak ditemukan
X2Cancel by driver
X3Cancel by user
X4Pembayaran 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.