Câu hỏi thường gặp
Tài liệu này hướng dẫn các câu hỏi thường gặp cho Đối tác khi tích hợp Pango API. Bạn có thể nhúng phần này vào trang docs hoặc portal đối tác.
🔎 Câu hỏi chung
| Câu hỏi | Trả lời |
|---|---|
| Pango có những loại dịch vụ gì? | - Dịch vụ xe máy: Giao hàng nhanh (Siêu tốc, Siêu tốc - Đồ ăn, 2H, 4H). - Dịch vụ xe tải: Xe tải, van, bán tải, ba gác với nhiều tải trọng (500kg → 2000kg). Xem chi tiết ở Bảng giá dịch vụ Pango trên Partner Portal. |
| Có thể theo dõi & quản lý đơn hàng ở đâu? | Đối tác dùng Partner Portal STG (test) và Partner Portal PROD (thực tế). Liên hệ hỗ trợ Pango để được cấp quyền truy cập tài khoản Partner. |
| Làm thế nào để test trạng thái đơn hàng? | 1. Cài app Pango Driver (STG). 2. Đăng ký & xác thực tài khoản. 3. Tạo đơn hàng với khoảng cách lấy < 1km. 4. Đăng nhập app, bật Online, chấp nhận đơn (hoặc gán từ Portal). 5. Làm theo hướng dẫn để cập nhật trạng thái. |
⚙️ API
| Câu hỏi | Trả lời |
|---|---|
| Bao lâu thì token hết hạn? | Token Production hết hạn sau 1 năm. Nếu gặp lỗi Not authorized/Token not found, hãy refresh/generate token mới. |
| Tại sao gặp lỗi 401 Not authorized khi gọi API Đăng ký tài khoản? | - SĐT chưa đăng ký trên hệ thống. - SĐT chưa liên kết đúng với Partner (apiKey). - SĐT chưa liên kết POS. |
Trường price trong items đã là tổng giá chưa? | Đúng. price đã nhân với số lượng. Không cần multiply thêm. Không ảnh hưởng phí ship. |
Lỗi COD is not valid, INVALID_MAX_COD là gì? | Tài khoản chưa xác minh COD. Liên hệ nhân viên BD/Support để được hỗ trợ. |
| Làm thế nào để chỉ lấy dịch vụ xe máy hoặc xe tải? | Khi gọi API Lấy danh sách dịch vụ, thêm param: - delivery_type=INSTANT → xe máy. - delivery_type=TRUCK → xe tải. |
📦 Đơn hàng
| Câu hỏi | Trả lời |
|---|---|
| Giá Ước tính phí & Tạo đơn hàng có luôn bằng nhau không? | - Nếu gọi ngay sau khi ước tính: bằng nhau. - Nếu để lâu: giá có thể thay đổi do thời tiết, cao điểm, ngày lễ,… |
| Có tính thêm phí cho COD cao không? | Có. Xem trường fee_description_vi_vn khi gọi API dịch vụ. Ví dụ (BIKE): - COD < 2 triệu: miễn phí. - COD ≥ 2 triệu: 0.8% x COD. |
| Số tiền COD có bao gồm phí vận chuyển không? | - CASH_BY_RECIPIENT: COD = giá trị hàng (không gồm ship). - CASH/BALANCE: COD = hàng + phí ship theo bảng giá riêng. |
| Hệ thống chờ bao lâu trước khi auto-cancel? | Tuỳ môi trường & service_id. Xem trường timeout khi tạo đơn. Ví dụ (STG, SGN-BIKE): chờ 600s (10 phút), nếu không có tài xế → CANCELLED. |
| Đơn IDLE có thể đẩy sớm hơn không? | Không. Phải huỷ đơn IDLE và tạo đơn giao ngay mới. |