Trang chủ
XtreamUIPro

Hướng dẫn

Kết nối cửa hàng bằng connector

Để nền tảng thanh toán hoặc cửa hàng của bạn tự tạo và gia hạn line: một khoá API, connector cho nền tảng của bạn, một đơn hàng thử, và webhook cho những gì xảy ra tiếp theo.

Kết thúc, một đơn hàng đã thanh toán trên nền tảng của bạn tạo ra một line và mỗi khoản thanh toán gia hạn nó, mà không cần dashboard. Bạn cần một tài khoản đối tác (reseller) có credit và các gói nó được bán, và một nền tảng có connector — WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress với WooCommerce hoặc Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, hoặc Shopify, Upmind và Invoice Ninja qua cầu nối webhook.

Tạo khoá API

Đăng nhập bằng tài khoản đối tác và mở API Key. Khoá chỉ hiển thị một lần, khi được tạo — hãy sao chép ngay. Tạo thêm một khoá cho mỗi hệ thống, với tên và các địa chỉ được phép dùng, để thu hồi một khoá mà không ảnh hưởng các khoá khác; connector cần khoá có quyền ghi, nên hãy để cờ chỉ đọc tắt.

Trang API Key của một tài khoản đối tác: khoá, các khoá bổ sung theo hệ thống, webhook và các lệnh gọi gần đây.
Trang API Key của một tài khoản đối tác: khoá, các khoá bổ sung theo hệ thống, webhook và các lệnh gọi gần đây.

Chọn connector

Mở Resources → All Connectors và chọn nền tảng của bạn. Trang của nó liệt kê thông tin kết nối, các bước cài đặt, nút Download, SHA-256 của tệp để kiểm tra, và mức độ connector đó đã được kiểm thử — một số chạy bên trong nền tảng thật, số khác chỉ kiểm thử phần lõi. Mã nguồn mở; các tệp giống hệt được đăng trên trang connectors.

Trang All Connectors: mỗi nền tảng một thẻ với phiên bản và mức độ đã được kiểm thử.
Trang All Connectors: mỗi nền tảng một thẻ với phiên bản và mức độ đã được kiểm thử.

Cài trên nền tảng của bạn

Kiểm tra checksum rồi cài tệp ở nơi trang của connector chỉ dẫn: thư mục module của WHMCS, Blesta hoặc FOSSBilling, mục tải plugin của WordPress, thư mục addons của Odoo, trình cài extension của OpenCart, v.v. Cầu nối webhook cho Shopify, Upmind và Invoice Ninja là một ứng dụng PHP nhỏ bạn tự host. Connector chỉ gọi Reseller API bằng khoá của bạn: nó làm được những gì tài khoản của bạn làm được, không hơn.

Trang của connector WHMCS: thông tin kết nối, các bước cài đặt, bản tải về và SHA-256 của nó.
Trang của connector WHMCS: thông tin kết nối, các bước cài đặt, bản tải về và SHA-256 của nó.

Cấu hình

Trong cài đặt của connector, nhập địa chỉ máy chủ API (đường dẫn /reseller/v1) và khoá, rồi ánh xạ mỗi sản phẩm của nền tảng sang một gói mà nhóm của bạn được bán. Giá và thanh toán ở lại nền tảng của bạn: panel không nhận tiền và không có cổng thanh toán.

Đặt một đơn hàng thử

Đặt sản phẩm trong môi trường thử của nền tảng. Connector gọi create_line với gói và một request id; line xuất hiện trong Lines với thời hạn của gói làm hạn dùng, và nền tảng của bạn nhận thông tin đăng nhập của nó. Một lần gia hạn gọi renew_line với request id riêng, nên thử lại sau lỗi mạng không bao giờ bị tính hai lần. Trang API Key liệt kê các lệnh gọi gần đây với hành động, kết quả, mã lỗi, địa chỉ và tên connector.

Trang Lines sau đơn hàng thử: line mới với gói, hạn dùng và số kết nối mà connector yêu cầu.
Trang Lines sau đơn hàng thử: line mới với gói, hạn dùng và số kết nối mà connector yêu cầu.

Thêm webhook (tuỳ chọn)

Trên trang API Key thêm một endpoint webhook (địa chỉ https của nền tảng bạn) cho các sự kiện bạn muốn: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Mỗi thông báo được ký bằng bí mật hiển thị một lần khi tạo (X-Xtream-Signature) và không bao giờ kèm mật khẩu; nút Test gửi một thông báo ngay lập tức.

Chủ đề trợ giúp liên quan

Hướng dẫn tiếp theo