Tích hợp tùy chỉnh

Để bắt đầu, vui lòng liên hệ với đội bán hàng của chúng tôi để tạo tài khoản và ký một thỏa thuận. Sau khi thỏa thuận được ký, bạn sẽ nhận được hai lần gửi tiền nhỏ vào tài khoản của mình cần được xác minh.

Vui lòng gửi email những số tiền gửi tiền nhỏ này đến accounting@zonos.com với ID cửa hàng Dashboard của bạn (CC đại diện bán hàng của bạn).

Sau khi xác minh, chi tiết ngân hàng của bạn sẽ hiển thị trong Dashboard -> Settings -> Billing.

Sau khi tạo tài khoản Zonos, bạn sẽ cần cấu hình cài đặt trong Dashboard để đảm bảo Checkout hoạt động đúng cách với cửa hàng của bạn. Phần này bao gồm tất cả các cấu hình Dashboard cần thiết.

Thiết lập chi trả 

Kết nối tài khoản ngân hàng để nhận các khoản chi trả kịp thời từ Checkout. Các khoản chi trả được xử lý hàng ngày với độ trễ 2 ngày kể từ khi thanh toán được ghi nhận. Để làm điều này, vui lòng làm theo các bước sau:

1. Điều hướng đến Dashboard -> Settings -> Checkout settings .
2. Nhấp vào Add bank account
3. Bạn sẽ được dẫn đến cổng thông tin Stripe để hoàn thành thiết lập và cung cấp các thông tin sau:
   • Thông tin tài khoản ngân hàng.
   • Company EIN.
   • Số An sinh xã hội của người sở hữu 25% công ty. Để biết thêm chi tiết về lý do điều này là bắt buộc, hãy xem tài liệu của Stripe.

Ghi chú: Nếu bạn cần cập nhật lịch chi trả của mình, vui lòng liên hệ support@zonos.com

Thiết lập các miền được phép 

Tập lệnh JS của Zonos yêu cầu một danh sách các miền được phép cho các mục đích bảo mật. Điều này ngăn ngừa các trang web trái phép tải tập lệnh và đảm bảo nó chỉ chạy trên các miền được phê duyệt của bạn. Nếu không cấu hình này, tập lệnh sẽ trả về lỗi quyền.

Để thiết lập điều này:

1. Điều hướng đến Dashboard -> Settings -> Checkout settings
2. Dưới URLs, thêm miền đầy đủ và bất kỳ miền phụ nào nơi Checkout sẽ được sử dụng. Ví dụ: nếu miền của bạn là example.com, bạn nên thêm example.com và test.example.com.

Tùy chỉnh cài đặt thương hiệu 

Định cấu hình cài đặt thương hiệu của bạn trong Dashboard để phù hợp với giao diện và cảm nhận của cửa hàng bạn.

Để làm điều này, vui lòng làm theo các bước sau:

1. Điều hướng đến Dashboard -> Settings -> Checkout settings -> Branding
2. Cấu hình các cài đặt sau:
   • Logo.
   • Màu thương hiệu và nhấn mạnh.
   • Chủ đề, Kiểu dáng và Phông chữ.

Để biết thêm thông tin về cài đặt thương hiệu, hãy xem tài liệu của chúng tôi.

Kết nối một nhà cung cấp dịch vụ vận chuyển 

Để báo giá vận chuyển tại Checkout, bạn sẽ cần kết nối một nhà cung cấp dịch vụ vận chuyển với tài khoản Zonos của bạn. Điều này sẽ cho phép bạn bật các mức dịch vụ vận chuyển cụ thể tại Checkout.

Để kết nối nhà cung cấp dịch vụ vận chuyển, vui lòng làm theo các bước sau:

1. Điều hướng đến Dashboard -> Settings -> Shipping -> Rates
2. Nhấp vào Add carrier
3. Làm theo hướng dẫn thiết lập nhà cung cấp dịch vụ.

Để biết thêm chi tiết về kết nối các tài khoản nhà cung cấp dịch vụ, hãy xem tài liệu của chúng tôi.

Thiết lập các vùng vận chuyển 

Các vùng vận chuyển cho phép bạn định cấu hình các nhà cung cấp dịch vụ vận chuyển và mức dịch vụ nào có sẵn cho các vùng khác nhau trên thế giới.

Để thiết lập các vùng vận chuyển, vui lòng làm theo các bước sau:

1. Điều hướng đến Dashboard -> Settings -> Shipping -> Locations
2. Nhấp vào New zone
3. Nhập tên vùng và chọn các quốc gia bạn muốn vận chuyển.
4. Chọn nhà cung cấp dịch vụ và mức dịch vụ bạn muốn cung cấp.

Để biết thêm chi tiết về các vùng vận chuyển, hãy xem tài liệu của chúng tôi.

Thiết lập quốc gia gốc dự phòng và mã HS 

Quốc gia gốc và mã HS được sử dụng để tính toán thuế suất và thuế chính xác.

Nếu bạn không cung cấp quốc gia gốc hoặc mã HS cụ thể, chúng tôi sẽ sử dụng các giá trị dự phòng được thiết lập trong Dashboard.

Để đặt quốc gia gốc và mã HS dự phòng của bạn:

1. Điều hướng đến Dashboard -> Settings -> Shipping -> Catalog.
2. Đối với quốc gia gốc, chọn quốc gia nơi phần lớn các sản phẩm của bạn được sản xuất.
3. Đối với mã HS, nhập mã HS của sản phẩm phổ biến nhất của bạn. Nếu bạn không có mã HS, điều hướng đến Classify trong Dashboard và nhập tên và mô tả sản phẩm của bạn để tạo mã HS chính xác.

Đoạn mã JS Zonos là một tích hợp JavaScript phía máy khách cho phép chức năng checkout toàn cầu trên trang web của bạn. Nó hoạt động như là cầu nối giữa nền tảng thương mại điện tử của bạn và các dịch vụ Zonos, xử lý:

• Trải nghiệm Checkout: Kết xuất giao diện Checkout và xử lý thanh toán.
• Dịch vụ Vị trí: Phát hiện vị trí của khách truy cập và quản lý chuyển đổi tiền tệ.
• Tích hợp Giỏ hàng: Kết nối với hệ thống giỏ hàng và đơn hàng hiện có của bạn.
• Bảo mật: Xác thực các miền và xác thực các yêu cầu API.

Đoạn mã được tải không đồng bộ để ngăn chặn bất kỳ tác động nào đến hiệu suất trang web của bạn. Nó khởi tạo với thông tin đăng nhập API của cửa hàng của bạn và xử lý tất cả các tương tác phía máy khách một cách an toàn. Việc triển khai được thiết kế để không xâm nhập, yêu cầu những thay đổi tối thiểu đối với luồng thanh toán hiện có của bạn.

Dưới đây là một ví dụ hoàn chỉnh bao gồm tải tập lệnh, khởi tạo và xử lý sự kiện để tham khảo khi tích hợp Checkout.

4. Chuyển các ID tương ứng thông qua customHTML Checkout của bạn để tập lệnh relay biết cần gửi sự kiện tới property/pixel nào:

Để biết hướng dẫn từng bước cho iframe, tài liệu tham khảo đầy đủ về sự kiện (bao gồm ánh xạ payload purchase / Purchase) và mẹo gỡ lỗi, xem:

• Google Analytics 4 cho Checkout dạng iframe
• Facebook Pixel cho Checkout dạng iframe

Để đồng bộ hóa đơn hàng giữa hệ thống của bạn và Dashboard Zonos, hãy triển khai các lệnh gọi API và webhook này:

Mutation bắt buộc 

Webhook bắt buộc 

Trước khi đi vào hoạt động với tích hợp Checkout của bạn, điều quan trọng là phải kiểm tra kỹ lưỡng tất cả các khía cạnh của tích hợp để đảm bảo trải nghiệm khách hàng suôn sẻ. Điều này bao gồm kiểm tra luồng thanh toán, xử lý thanh toán, tạo đơn hàng và chức năng webhook.

Làm theo hướng dẫn kiểm tra của chúng tôi để xác minh rằng tích hợp của bạn đang hoạt động đúng cách và xác định và khắc phục bất kỳ vấn đề nào trước khi khởi chạy vào sản xuất.

Dưới đây là một số câu hỏi thường gặp về quá trình tích hợp.

Zonos xử lý xác nhận đơn hàng như thế nào? 

Định cấu hình trải nghiệm sau khi mua trong Dashboard -> Settings -> Checkout settings dưới Success page type. Ba tùy chọn có sẵn:

• Show Zonos success page (mặc định, được đề xuất) — Zonos hiển thị trang cảm ơn tích hợp sẵn sau khi đặt hàng. Trang luôn được hiển thị, ngay cả khi đơn hàng không nhập vào hệ thống của bạn, vì vậy người mua hàng luôn nhận được xác nhận.
• Redirect to a success page — Zonos chờ trên màn hình "Đơn hàng hoàn thành" ngắn cho đến khi đơn hàng được tạo, sau đó chuyển hướng tới URL thành công được cấu hình của bạn với zOrderNumber (và orderId cho giỏ hàng kế thừa) được nối thêm dưới dạng tham số truy vấn.
• Close the checkout modal — Zonos đóng hộp thoại của nó sau khi thanh toán được ghi nhận. Nếu bạn cũng cấu hình URL thành công, Zonos chuyển hướng đến URL đó ngay lập tức sau khi Stripe thu thập thanh toán — mà không chờ đơn hàng được tạo — và nối thêm zonosCheckoutSessionId dưới dạng tham số truy vấn. Sử dụng tùy chọn này khi bạn muốn bàn giao nhanh nhất trở lại trang thành công của riêng bạn.

Tra cứu đơn hàng từ zonosCheckoutSessionId 

Khi bạn sử dụng Close the checkout modal với URL chuyển hướng, đơn hàng có thể mất vài giây để được gắn với phiên Checkout sau khi chuyển hướng. Đọc zonosCheckoutSessionId từ URL và thăm dò truy vấn checkoutSession GraphQL từ máy chủ của bạn bằng mã thông báo thông tin đăng nhập bí mật của bạn cho đến khi đơn hàng sẵn sàng. Không bao giờ gọi điều này từ trình duyệt — mã thông báo thông tin đăng nhập bí mật phải ở phía máy chủ.

Gửi truy vấn tới https://api.zonos.com/graphql với mã thông báo thông tin đăng nhập bí mật của bạn từ Dashboard -> Settings -> Integrations được chuyển làm tiêu đề yêu cầu credentialToken.

Tôi có thể được thông báo khi đơn hàng được tạo không? 

Vâng. Nếu bạn muốn nhận thông báo khi đơn hàng được tạo, trong Dashboard dưới phần Email của Checkout settings, bạn có thể nhập địa chỉ email của các thành viên nhóm nên được thông báo khi đơn hàng được tạo, gửi hoặc hủy.