DevVN Docs GHN

Kết nối API GHN

Một ô duy nhất quyết định plugin có nói chuyện được với GHN hay không: Token Key. Lấy nó từ tài khoản GHN của bạn, dán vào, lưu lại là xong.

Bắt buộc Bước 3 / 8 Cập nhật 06.09.2026

Mở tab Cài đặt GHN

Vào WooCommerce → Cài đặt GHN, tab Cài đặt GHN.

Tab Cài đặt GHN với lựa chọn môi trường, ô Token Key và ô Ghi chú bắt buộc
Token Key trong ảnh là giá trị mẫu. Bấm vào ảnh để phóng to.
  1. Cài đặt GHN — tab thứ hai.
  2. Môi trường — chọn một trong hai:
    Product dùng tài khoản thật tại khachhang.ghn.vn. Đây là lựa chọn khi bán hàng thật.
    Test dùng tài khoản thử tại 5sao.ghn.dev. Vận đơn tạo ở đây không phát sinh chi phí và không có shipper tới lấy.
  3. Token Key — dán mã lấy từ tài khoản GHN. Mỗi môi trường có token riêng, đừng dán nhầm token Test vào khi đang chạy Product.
  4. Ghi chú bắt buộc — quy định shipper có cho khách xem hàng hay không: Cho xem hàng, không cho thử · Cho thử hàng · Không cho xem hàng. Đây là giá trị mặc định cho mọi vận đơn; lúc tạo từng đơn vẫn đổi được.

Bấm Lưu thay đổi ở cuối trang.

Token Key là chìa khoá tài khoản GHN

Ai có token này là tạo được vận đơn dưới tên tài khoản của bạn và cước tính vào tài khoản đó. Khi chụp màn hình nhờ hỗ trợ, che ô này lại. Lỡ lộ thì vào tài khoản GHN tạo lại token rồi cập nhật vào đây.

Lấy Token Key ở đâu

  1. Đăng nhập khachhang.ghn.vn bằng tài khoản của cửa hàng.
  2. Vào mục quản lý tài khoản / tích hợp API, tìm phần Token.
  3. Chép nguyên chuỗi đó, đừng chép thừa dấu cách.

Không tìm thấy mục token thì tài khoản của bạn chưa được GHN bật quyền tích hợp — liên hệ nhân viên kinh doanh GHN phụ trách cửa hàng.

Không cần thêm vào khu vực giao hàng

Phí GHN tự hiện ở trang thanh toán ngay khi kết nối xong. Bạn sẽ không thấy GHN trong danh sách Thêm phương thức vận chuyển của một khu vực giao hàng — đó là bình thường, không phải lỗi.

Muốn bật/tắt hẳn việc tính phí, hoặc đổi dòng chữ khách nhìn thấy, vào WooCommerce → Cài đặt → Vận chuyển → Giao hàng nhanh (GHN). Mặc định đã bật sẵn.

Cách kiểm tra đã nối được chưa

  1. Lưu Token Key xong, sang tab Cửa hàng/Kho.
  2. Bấm Đồng bộ kho hàng từ GHN — phải thấy cửa hàng của bạn hiện ra.
  3. Không ra kho nào nghĩa là token sai hoặc chưa lưu.

Lỗi thường gặp

Hiện tượngCách xử lý
Đồng bộ kho không ra gìToken sai, chưa bấm Lưu thay đổi, hoặc đang chọn nhầm môi trường so với token đang dùng.
Phí ship không hiện dù token đúngChưa có kho, hoặc sản phẩm chưa khai khối lượng. Xem bảng lưu ý.
Đang chạy tốt bỗng lỗi xác thựcToken bị thu hồi hoặc tạo lại bên GHN. Lấy token mới dán vào đây.
Tạo vận đơn ở Test mà GHN vẫn tính tiềnĐang ở môi trường Product. Đổi sang Test và dán token của 5sao.ghn.dev.

Tiếp theo: khai cửa hàng / kho.

Hỗ trợ Zalo