Tích hợp
Tích hợp liền mạch Checkout với cửa hàng BigCommerce của bạn bằng cách làm theo các bước trong phần này:
Bắt đầu
Bắt đầu bằng cách hoàn thành mẫu đăng ký. Quá trình onboarding sẽ bắt đầu khi thỏa thuận tài khoản của bạn được thiết lập.
Onboarding
Trong vòng 24 giờ sau khi đăng ký, một đại diện onboarding chuyên trách sẽ liên hệ với bạn để khởi động quá trình tích hợp tùy chỉnh.
Quan trọng: Các bước được liệt kê dưới đây chỉ để tham khảo và bạn sẽ được hướng dẫn qua chúng bởi đại diện onboarding của bạn.
Cài đặt ứng dụng
Cả Checkout và Hello đều phải được cài đặt để Checkout hoạt động đúng cách, vì Hello sẽ thông báo khi nào chuyển hướng khách hàng quốc tế đến Checkout của chúng tôi.
- Cài đặt ứng dụng Checkout từ BigCommerce Marketplace bằng cách nhấp vào Nhận ứng dụng này.
- Cài đặt ứng dụng Hello từ BigCommerce Marketplace bằng cách nhấp vào Nhận ứng dụng này.
Cấu hình Checkout
Khi bạn đã cài đặt cả hai ứng dụng, hãy cấu hình cài đặt của bạn:
- Trong backend BigCommerce của bạn, đi đến Apps → My apps → Zonos Checkout.
- Nhập thông tin xác thực tích hợp của bạn để liên kết cài đặt Dashboard của bạn với trang web BigCommerce của bạn.
- Kích hoạt ứng dụng ở chế độ thử nghiệm hoặc trực tiếp:
- Dưới Zonos Checkout, chọn Kích hoạt.
- Dưới Chế độ thử nghiệm, chọn Kích hoạt. Khi chế độ này được kích hoạt, bạn phải thêm
?zonos=true
vào URL để kích hoạt chức năng Zonos, cho phép bạn thử nghiệm Zonos trong khi người mua sắm của bạn vẫn trải nghiệm quy trình bản địa của bạn. Thay đổi điều này thành Vô hiệu hóa khi bạn sẵn sàng để đi trực tiếp.
- Tùy chỉnh ứng dụng của chúng tôi để hoạt động theo cách mà trang web của bạn cần:
- Dưới Tạo khách hàng khi nhập đơn hàng, chọn sở thích của bạn.
- Dưới Duy trì hàng hóa trong kho trong quá trình checkout, chọn Kích hoạt nếu bạn muốn Zonos giữ hàng hóa trong kho trong khi nó ở trong Checkout của chúng tôi. Tìm hiểu cách điều này hoạt động trong phần Câu hỏi thường gặp ở cuối trang này.
- Dưới Hiển thị nhà cung cấp thanh toán là tùy chỉnh, chọn Kích hoạt nếu bạn muốn tất cả các đơn hàng Zonos của bạn hiển thị Tùy chỉnh là nhà cung cấp thanh toán trong BigCommerce.
- Nhấp vào Cập nhật cài đặt để lưu lựa chọn của bạn.
Cấu hình Hello
- Trong backend BigCommerce của bạn, đi đến Apps → My apps → Zonos Hello.
- Sao chép API key Hello của bạn từ Dashboard và nhập nó làm Site Key.
- Kích hoạt ứng dụng Hello bằng cách chuyển Zonos Hello sang kích hoạt. Hello có thể được kích hoạt trước Checkout và sẽ không chuyển hướng đến Zonos Checkout trừ khi Checkout cũng được kích hoạt.
- Chuyển Báo giá thuế và phí sang kích hoạt.
- Nếu bạn muốn Zonos tận dụng việc chuyển đổi tiền tệ của BigCommerce, hãy chuyển Chuyển đổi tiền tệ sang kích hoạt. Làm như vậy sẽ cho phép Hello kích hoạt các loại tiền tệ cho bạn trong Cài đặt → Tiền tệ. Kiểm tra cài đặt tiền tệ của bạn ở đó để đảm bảo rằng các khoản thanh toán sẽ được thực hiện bằng loại tiền tệ mà bạn ưa thích.
- Nhấp vào Cập nhật cài đặt để lưu lựa chọn của bạn.
Thêm thông tin sản phẩm còn thiếu
Các phiên bản của BigCommerce trước V3 có những hạn chế với dữ liệu mà chúng truyền đến Zonos để báo giá landed cost. Tìm hiểu thông tin sản phẩm nào mà Zonos nhận được từ mỗi phiên bản của BigCommerce và khi nào bạn phải sử dụng Zonos Catalog để thêm thông tin cụ thể về sản phẩm cần thiết cho các phép tính của chúng tôi.
Thông tin sản phẩm tùy chọn
Thông tin cụ thể về sản phẩm không bắt buộc để Zonos trả về một báo giá. Zonos có thể sử dụng các mặc định tài khoản của bạn cho mã HS và Quốc gia xuất xứ, ước lượng trọng lượng với một yếu tố tùy chỉnh, và báo giá mà không cần kích thước. Tuy nhiên, càng nhiều thông tin cụ thể về sản phẩm được cung cấp, các phép tính của chúng tôi sẽ càng chính xác hơn.
Thông tin sản phẩm được truyền từ BigCommerce
- Trọng lượng
- Kích thước
- Mã HS*
- Quốc gia xuất xứ*
*Chỉ nhập nếu sử dụng trải nghiệm sản phẩm BigCommerce V3
Nếu bạn không sử dụng BigCommerce V3, hãy thêm sản phẩm của bạn với mã HS và Quốc gia xuất xứ vào Catalog. Tìm hiểu cách sử dụng Catalog.
Nếu bạn thêm trọng lượng, kích thước, mã HS hoặc quốc gia xuất xứ vào Catalog, Catalog sẽ luôn sử dụng các trường đó. Nếu bất kỳ thông tin nào có mặt cả trên nền tảng thương mại điện tử của bạn và Catalog, thông tin trong Catalog sẽ ghi đè thông tin được gửi từ nền tảng thương mại điện tử khi thực hiện các phép tính của chúng tôi. Ví dụ, giả sử trọng lượng của một sản phẩm có mặt trong Shopify và Catalog. Trong trường hợp đó, Zonos sẽ sử dụng trọng lượng trong Catalog để tính toán phí vận chuyển.
Kiểm tra tích hợp của bạn
Bây giờ bạn đã thiết lập tài khoản và ứng dụng của mình, bạn đã sẵn sàng để kiểm tra tích hợp của bạn. Bạn sẽ cần kích hoạt Checkout và Hello trong BigCommerce trong khi kiểm tra. Để làm điều này:
- Trong bảng điều khiển BigCommerce của bạn, đi đến Apps → My apps → Zonos Hello.
- Chuyển Zonos Hello sang kích hoạt.
- Sau đó, đi đến Apps → My apps → Zonos Checkout.
- Dưới Zonos Checkout, chọn Kích hoạt.
- Dưới Chế độ thử nghiệm, chọn Kích hoạt.
Khi chế độ này được kích hoạt, bạn phải thêm ?zonos=true
vào URL để kích hoạt chức năng Zonos, cho phép bạn kiểm tra Zonos trong khi người mua của bạn vẫn trải nghiệm quy trình bản địa của bạn.
Sau khi hoàn tất kiểm tra, hãy kích hoạt Zonos bằng cách đặt Chế độ thử nghiệm thành Vô hiệu hóa.
Một số điều cần nhớ:
- De minimis—Nếu tổng giá trị giỏ hàng của bạn dưới mức De minimis của quốc gia giao hàng, có thể không có bất kỳ thuế hoặc phí nào phải trả. Điều này được phản ánh trong các phép tính của chúng tôi.
- Hoàn tiền và hủy bỏ—Chúng tôi đang thu tiền, vì vậy nếu bạn cần thực hiện bất kỳ hoàn tiền hoặc hủy bỏ nào, vui lòng xử lý chúng trong Dashboard.
- Nhãn—In nhãn cho tất cả các đơn hàng quốc tế trong Dashboard, trừ khi bạn đã được chứng nhận để in nhãn bên ngoài Dashboard. Điều này cho phép chúng tôi thanh toán thuế và phí thay mặt bạn.
Lưu ý: Nếu bạn cần chúng tôi thực hiện điều chỉnh, vui lòng liên hệ với hỗ trợ Zonos để được trợ giúp.
Tùy chọn thiết lập nâng cao
Ẩn các yếu tố nội địa
Nếu bạn có các yếu tố cần ẩn cho người dùng quốc tế chỉ, ví dụ như nhà cung cấp thanh toán chỉ dành cho Mỹ, ước lượng vận chuyển, banner với thông điệp chỉ dành cho Mỹ, v.v., thì hãy sử dụng các bước tiếp theo để ẩn chúng khi quốc gia của Zonos Hello là quốc tế. Để khắc phục điều này, hãy đi đến Bảng điều khiển BigCommerce -> Storefront -> Script Manager -> Tạo Script.
Để ẩn các yếu tố nội địa, hãy làm theo các bước dưới đây:
-
Đi đến BigCommerce Storefront -> Script Manager -> Tạo Script.
-
Tạo một script tùy chỉnh mới cho Zonos bằng cách sử dụng các thông tin sau:
- Tên script: Zonos Tùy chỉnh - [tên script liên quan]
- Mô tả: [Script này làm gì]
- Vị trí: Chân trang
- Địa điểm: Tất cả các trang
- Danh mục script: Cần thiết
- Loại script: Script
- Nội dung script: Sao chép và dán các thông tin sau vào nội dung script.
-
Trong script dưới đây, chỉnh sửa các bộ chọn trong
var domesticElements =
bằng cách làm như sau:- Tìm các bộ chọn yếu tố mà bạn muốn ẩn cho người dùng quốc tế trên trang BigCommerce hiện tại của bạn.
- Khi bạn đã có các bộ chọn đó, hãy thêm chúng vào nơi có ghi là
.hide-me
. - Đảm bảo bao quanh mỗi bộ chọn bằng dấu ngoặc kép và phân tách bằng dấu phẩy, xem ví dụ sau:
[".hide-1", ".hide-2", ".hide-3", ".hide-4"]
- Khi script đã sẵn sàng và được lưu, hãy kiểm tra bằng cách đi đến trang mà các yếu tố đã bị ẩn và chuyển đổi quốc gia của Zonos Hello từ Mỹ sang quốc tế, và quay lại Mỹ. Các yếu tố đó nên bị ẩn khi một quốc gia quốc tế được chọn.
Zonos integration script
<script>
var domesticElements = ['.hide-me'];
let cssElement = document.createElement('style'),
sheet;
document.head.appendChild(cssElement);
sheet = cssElement.sheet;
let count = 0;
for (let domesticHide of domesticElements) {
sheet.insertRule(`.z-intl ${domesticHide} { display:none; }`, count);
count++;
}
</script>
Khắc phục sự cố
Các nút Checkout không chuyển hướng
Nếu Zonos Checkout đang ở chế độ thử nghiệm hoặc đã được đặt ở chế độ trực tiếp (và các nút checkout không chuyển hướng đến Zonos), có thể là do các bộ chọn nút checkout. Ứng dụng Zonos Checkout của chúng tôi sử dụng một danh sách bộ chọn nút checkout mặc định. Nếu một người dùng quốc tế không được chuyển hướng, các bộ chọn đó có thể cần được điều chỉnh.
Để khắc phục sự cố này, hãy làm theo các bước dưới đây:
-
Đi đến Bảng điều khiển quản trị BigCommerce -> Giao diện cửa hàng -> Trình quản lý kịch bản -> Tạo kịch bản.
-
Tạo một kịch bản tùy chỉnh mới cho Zonos bằng cách sử dụng các thông tin sau:
- Tên: Zonos Tùy chỉnh - [tên kịch bản liên quan]
- Mô tả: [Kịch bản này làm gì]
- Vị trí trên trang: Chân trang
- Chọn các trang mà kịch bản sẽ được thêm vào: Tất cả các trang
- Nội dung kịch bản: Sao chép đoạn mã sau và dán vào nội dung kịch bản.
-
Khi bạn đã có mã bên dưới trong nội dung kịch bản, bạn sẽ cần điều chỉnh một trong các bộ chọn để phù hợp với các nút checkout hiện tại của bạn hoặc bạn có thể thêm một bộ chọn mới vào danh sách.
-
Đảm bảo lưu kịch bản mới này và kiểm tra trang web.
Zonos tích hợp kịch bản
<script>
window.onload = () => {
selectors = {
'.previewCartCheckout .button--primary': 'checkout',
'.cart-actions .button--primary': 'Check out',
'.previewCartAction-checkout': 'Check out now',
'.ProceedToCheckout .btn': 'Proceed To Checkout',
'.CheckoutLink': 'Checkout',
'.button--primary': 'Checkout',
'.button-checkout': 'Checkout',
'.btn': 'Proceed To Checkout',
'.CheckoutButton': 'Proceed To Checkout',
};
for (let key in selectors) {
let button = contains(key, selectors[key]);
for (i = 0; i < button.length; i++) {
button[i].addEventListener('click', function (e) {
zonosCheckout(e);
});
}
}
};
</script>
Câu hỏi thường gặp
Làm thế nào để tôi biết mình đang sử dụng chủ đề Stencil?
Để xác định xem bạn có đang sử dụng chủ đề Stencil hay không, trong Bảng điều khiển Quản trị BigCommerce, nếu Cửa hàng -> Mã chân trang là một tùy chọn, cửa hàng của bạn đang sử dụng chủ đề Stencil.
Thông tin sản phẩm nào tôi nên cung cấp để có báo giá chính xác nhất về thuế, phí và chi phí vận chuyển?
Thông tin sản phẩm có thể ảnh hưởng đến số tiền thuế và phí phải trả cũng như chi phí vận chuyển. Càng nhiều thông tin sản phẩm bạn cung cấp cho Zonos, báo giá trả về sẽ càng chính xác. Zonos có thể tạo ra một báo giá ngay cả khi thông tin này không có sẵn, nhưng khuyến nghị cung cấp các chi tiết sản phẩm chính sau đây để cải thiện độ chính xác:
- Trọng lượng: Trọng lượng ảnh hưởng đến chi phí vận chuyển của bạn, điều này có thể ảnh hưởng đến thuế hoặc phí. Trọng lượng trong danh sách sản phẩm BigCommerce của bạn sẽ tự động được Zonos sử dụng khi có.
- Kích thước: Kích thước có thể ảnh hưởng đến chi phí vận chuyển của bạn, điều này có thể ảnh hưởng đến thuế hoặc phí. Zonos có thể sử dụng kích thước sản phẩm (chiều dài, chiều rộng và chiều cao) được thiết lập trên mỗi sản phẩm trong BigCommerce.
- Mã HS: Mã HS ảnh hưởng đến tỷ lệ thuế và đôi khi có thể ảnh hưởng đến thuế. BigCommerce không thể gửi mã HS đến Zonos nên chúng phải được thêm vào bằng cách sử dụng Zonos Catalog. Nếu bạn đang sử dụng trải nghiệm sản phẩm BigCommerce V3, mã HS sẽ được nhận.
- Quốc gia xuất xứ: Quốc gia xuất xứ của sản phẩm ảnh hưởng đến tỷ lệ thuế và có thể ảnh hưởng đến thuế. BigCommerce không thể gửi mã HS đến Zonos nên chúng phải được thêm vào bằng cách sử dụng Zonos Catalog. Nếu bạn đang sử dụng trải nghiệm sản phẩm BigCommerce V3, Quốc gia xuất xứ sẽ được nhận.
Chi tiết sản phẩm được truyền đến Zonos bởi BigCommerce
Chi tiết sản phẩm | Trọng lượng | Kích thước | Mã HS | Quốc gia xuất xứ |
---|---|---|---|---|
Tự động truyền | ||||
Thêm với Catalog |
Chi tiết sản phẩm được truyền đến Zonos bởi BigCommerce V3
Chi tiết sản phẩm | Trọng lượng | Kích thước | Mã HS | Quốc gia xuất xứ |
---|---|---|---|---|
Tự động truyền |
Lưu ý: Ngoài ra, bạn có thể nhập bất kỳ thông tin nào ở trên vào Catalog, ghi đè thông tin đã được lưu trữ và truyền từ BigCommerce.
Tìm hiểu thêm về thông tin sản phẩm theo nền tảng.
Checkout cho BigCommerce
Tích hợp plugin Checkout cho BigCommerce.Trước khi tích hợp Checkout, hãy đảm bảo rằng nó sẽ hoạt động như bạn mong đợi. Khi bạn sử dụng Checkout: