Hướng dẫn
Quy trình kết nối
Các bước từ đăng ký đến chạy thật trên production.
- Đăng ký. Gửi GOCheap thông tin doanh nghiệp, dịch vụ muốn dùng, khu vực hoạt động, người liên hệ kỹ thuật và (tuỳ chọn) danh sách IP máy chủ.
- Nhận key sandbox. GOCheap tạo tài khoản đối tác và gửi key
gc_test_...qua kênh an toàn. - Tích hợp trên sandbox.
- Tạo webhook, gọi
test-eventđể kiểm tra URL và chữ ký. - Chạy đủ luồng: báo giá, tạo chuyến, xem chuyến, huỷ chuyến.
- Xử lý đủ các sự kiện webhook và các mã lỗi thường gặp (
quote_expired,area_not_supported,duplicate_reference).
- Tạo webhook, gọi
- Nghiệm thu. GOCheap cùng bạn chạy thử một chuyến có tài xế nhận và hoàn thành.
- Lên production. Nhận key
gc_live_..., đổi base URL, tạo lại webhook trên production (webhook sandbox và production tách riêng). - Đối soát. Theo kỳ, dựa trên
partner_reference_idvàbooking_id(GET /bookings?status=completed&created_from=...&created_to=...).
Hỗ trợ
Khi báo lỗi, gửi kèm booking_id, partner_reference_id, thời điểm gọi và (với webhook) X-GoCheap-Delivery để GOCheap tra log nhanh.