Phiên bản: 1.0.0

Webhook & Luồng callback

Đối tác cần cung cấp một webhook URL để nhận các cập nhật trạng thái từ Ahamove. Ahamove sẽ callback đến URL này mỗi lần trạng thái của đơn hàng thay đổi.

Cách để test callback và Webhook

Thiết lập webhook url để nhận thông tin order_id & status, sau đó gửi URL để Ahamove cài đặt vào hệ thống
Tải về ứng dụng tài xế trên môi truờng test AhaDriver STG trên thiết bị có hệ điều hành Android
Đăng ký tài khoản, sau đó liên hệ với Ahamove để được xác thực tài khoản
Đăng nhập và bật trực tuyến
Sử dụng API Create Order để tạo đơn hàng trong vòng bán kính 1km kể từ địa chỉ của tài xế
App của tài xế sẽ nhận một thông báo, nhấn vào thông báo để chấp nhận đơn hàng
Hệ thống Ahamove sẽ bắn trạng thái ACCEPTED đến webhook URL
Cập nhật các trạng thái đơn hàng trên app tài xế, hệ thống Ahamove sẽ bắn những trạng thái tương ứng đến webhook URL

Phương pháp Authentication

Ahamove hỗ trợ 3 loại authorization header (API-KEY, BEARER-TOKEN, BASIC-AUTH)

API Key

Đối tác đặt API key vào Authorization header

 Header: { apikey: "auth_token" }

Ex: { "apikey": "KJhb4seu82dHe3hkDgyU7mQoh5AB1o" }

Bearer Token

Đối tác gửi token vào Authorization header khi tạo requests

 Header: { Authorization: "Bearer + auth_token" }

Ex: { "Authorization": "Bearer KJhb4seu82dHe3hkDgyU7mQoh5AB1o"}

Basic Auth

Với phương thức này, Đối tác để một username: password vài trong request header. Username and password được encoded với Base64

 Header: { Authorization: "Basic {b64.StdEncoding.EncodeToString([]byte({username}:{password}))}" }

Ex: { "Authorization": "Basic KJhb4seu82dHe3hkDgyU7mQoh5AB1o"}

Luồng Callback

Mẫu Callback

{
  "_id": "22VMV54W",
  "accept_time": 0,
  "board_time": 0,
  "cancel_by_user": false,
  "cancel_comment": "",
  "cancel_image_url": "",
  "cancel_time": 0,
  "city_id": "SGN",
  "complete_time": 0,
  "create_time": 1665742305.9305305,
  "currency": "VND",
  "order_time": 1665742305.9305305,
  "partner": "",
  "path": [
    {
      "address": "725 Hẻm số 7 Thành Thái, Phường 14, Quận 10, Hồ Chí Minh, Việt Nam",
      "cod": 0,
      "por_info": "",
      "short_address": "Quận 10",
      "formatted_address": "",
      "mobile": "09xxxxxxxx",
      "status": "",
      "complete_lat": 0,
      "complete_lng": 0,
      "fail_lat": 0,
      "fail_lng": 0,
      "complete_time": 0,
      "fail_time": 0,
      "return_time": 0,
      "pod_info": "",
      "fail_comment": "",
      "name": "Anh",
      "remarks": "call me"
    },
    {
      "address": "Chợ Bến Thành, Bến Thành, Quận 01, Hồ Chí Minh, Việt Nam",
      "cod": 0,
      "por_info": "",
      "short_address": null,
      "formatted_address": "",
      "mobile": "09xxxxxxxx",
      "status": "",
      "complete_lat": 0,
      "complete_lng": 0,
      "fail_lat": 0,
      "fail_lng": 0,
      "complete_time": 0,
      "fail_time": 0,
      "return_time": 0,
      "pod_info": "",
      "fail_comment": "",
      "name": "Bao"
    }
  ],
  "payment_method": "CASH",
  "pickup_time": 0,
  "service_id": "SGN-BIKE",
  "status": "ASSIGNING",
  "sub_status": "",
  "supplier_id": "",
  "supplier_name": "",
  "surcharge": 1.1,
  "user_id": "",
  "user_name": "",
  "total_pay": 33000,
  "promo_code": "",
  "stoppoint_price": 0,
  "special_request_price": 1000,
  "vat": 0,
  "distance_price": 32000,
  "voucher_discount": 0,
  "subtotal_price": 33000,
  "total_price": 33000,
  "surge_rate": 1.1,
  "api_key": "<API_KEY_STG>",
  "shared_link": "https://cloudstg.ahamove.com/share-order/22VMV54W/84911434061",
  "insurance_portal_url": "https://claim-dev.globalcare.vn/claim/ahamove/intransit?platform=app&code=22VMV54W&phone=84xxxxxxxxx",
  "app": "Ahamove",
  "store_id": 0,
  "distance": 4.68
}

Phương pháp Authentication​

API Key​

Bearer Token​

Basic Auth​

Luồng Callback​

Mẫu Callback​