Tổng Quan Sản Phẩm
Thanh toán Định kỳ Gate Pay cung cấp cho bạn khả năng tự động trừ stablecoin dựa trên blockchain, cho phép bạn tự động thu USDT hoặc USDC từ người dùng trên các chuỗi tương thích EVM theo lịch trình đã định. Giải pháp này lý tưởng cho các dịch vụ SaaS, thành viên, quyên góp định kỳ và các kịch bản tương tự.
Ưu điểm cốt lõi:
- Người dùng chỉ cần ủy quyền một lần, hệ thống sẽ tự động trừ tiền định kỳ—không cần thao tác lặp lại từ phía người dùng
- Cấu hình linh hoạt cho giai đoạn dùng thử và giá ưu đãi ban đầu giúp giảm rào cản chuyển đổi cho người dùng
- Tự động thử lại khi trừ tiền thất bại, giảm thiểu mất đơn hàng
- Hỗ trợ bốn mạng EVM lớn: Ethereum, Arbitrum, Polygon và BSC
Quy Trình Tích Hợp
Tài liệu API: https://docs.gate.com/api-reference/version/100/en/endpoint/subscription/productCreate
Bước 1: Tạo Thông Tin Sản Phẩm
Tạo sản phẩm của bạn qua API, cung cấp các thông tin như tên sản phẩm, mô tả, hình ảnh, v.v.
Bước 2: Tạo Gói Giá
Tạo các gói giá cho sản phẩm, với các tham số cấu hình sau:
| Tham số | Mô tả |
|---|---|
| Số tiền trừ | Số tiền mỗi lần trừ, tối thiểu 0.01 |
| Loại tiền trừ | USDT hoặc USDC |
| Chu kỳ trừ | Hàng ngày / Hàng tuần / Hàng tháng / Hàng năm, hỗ trợ tùy chỉnh số ngày lặp lại |
| Giá ưu đãi ban đầu (Tùy chọn) | Hỗ trợ số tiền cố định hoặc tỷ lệ chiết khấu, chỉ áp dụng cho lần trừ đầu tiên |
| Giai đoạn dùng thử miễn phí (Tùy chọn) | Thiết lập số ngày dùng thử; không trừ tiền trong giai đoạn này |
Lưu ý:
FIX_AMOUNT: Trừ số tiền cố định—hệ thống tự động trừ số tiền cố định mỗi chu kỳ
ACCOUNT_AUTH: Thanh toán được ủy quyền—người dùng ủy quyền một hạn mức, và thương nhân có thể trừ bất kỳ khoản nào trong phạm vi đó
Bước 3: Tạo Gói Đăng Ký
Liên kết sản phẩm với gói giá, thiết lập hạn mức trừ tối đa mà người dùng ủy quyền, và tạo gói đăng ký.
Bước 4: Tạo và Gửi Liên Kết Đăng Ký
Sử dụng API để tạo đơn đăng ký cho người dùng và nhận liên kết thanh toán đăng ký.
⚠️ Liên kết đăng ký có hiệu lực trong 24 giờ. Vui lòng gửi liên kết cho người dùng trong thời gian hiệu lực. Nếu hết hạn, bạn cần tạo lại liên kết mới qua API.
Gửi liên kết cho người dùng; sau khi nhấp vào, người dùng có thể kết nối ví, ủy quyền hạn mức trừ và tự thực hiện thanh toán lần đầu.
Bước 5: Nhận Thông Báo Trừ Tiền
Sau khi cấu hình URL callback, hệ thống sẽ chủ động thông báo cho bạn khi xảy ra các sự kiện sau:
- Người dùng hoàn tất ủy quyền
- Trừ tiền lần đầu thành công
- Mỗi lần trừ định kỳ thành công hoặc thất bại
Giải Thích Các Quy Tắc Chính
Thời Gian Trừ Tiền
Hệ thống xử lý các khoản trừ định kỳ theo lô mỗi ngày vào lúc 09:00 giờ Bắc Kinh (UTC 01:00).
Quy Tắc Kích Hoạt Lần Trừ Đầu Tiên
- Không có giai đoạn dùng thử: Lần trừ đầu tiên được kích hoạt ngay lập tức sau khi người dùng ủy quyền
- Có giai đoạn dùng thử: Người dùng vào giai đoạn dùng thử sau khi ủy quyền; lần trừ đầu tiên sẽ tự động kích hoạt sau khi kết thúc giai đoạn dùng thử
- Cấu hình giá ưu đãi ban đầu: Lần trừ đầu tiên sử dụng giá ưu đãi; các lần tiếp theo sử dụng giá thông thường
Xử Lý Khi Trừ Tiền Thất Bại
Nếu trừ tiền thất bại do số dư hoặc hạn mức ủy quyền của người dùng không đủ:
- Hệ thống tự động thử lại mỗi 6 giờ, tối đa 2 lần
- Nếu tất cả các lần thử lại đều thất bại, đơn đăng ký sẽ tự động đóng
- Để tiếp tục, bạn cần tạo liên kết đăng ký mới cho người dùng
Giải Thích Trạng Thái Đơn Hàng
td {white-space:nowrap;border:0.5pt solid #dee0e3;font-size:10pt;font-style:normal;font-weight:normal;vertical-align:middle;word-break:normal;word-wrap:normal;}
| Trạng thái | Ý nghĩa |
|---|---|
| Pending Authorization | Đơn đã tạo, chờ người dùng ủy quyền |
| Authorized | Người dùng đã ủy quyền, chờ trừ tiền lần đầu |
| In Trial | Người dùng đang trong giai đoạn dùng thử, chưa trừ tiền |
| Confirming | Đang xử lý trừ tiền lần đầu (khi không có giai đoạn dùng thử) |
| Active | Đang trừ tiền tự động định kỳ bình thường |
| Completed | Đăng ký kết thúc bình thường sau khi đạt số chu kỳ hoặc ngày kết thúc đã đặt |
| Canceled | Thương nhân chủ động hủy đăng ký |
| Unpaid | Trừ tiền thất bại, chờ hệ thống thử lại |
| Closed | Đã đạt giới hạn thử lại, đăng ký bị đóng |
| Intercepted | Giao dịch on-chain thành công, nhưng kiểm soát rủi ro KYT thất bại |
Tra Cứu & Quản Lý Đơn Hàng
Bạn có thể kiểm tra lịch sử trừ tiền bằng các cách sau:
Bảng điều khiển thương nhân: Đăng nhập bảng điều khiển → Đơn thanh toán → Lọc loại đơn “Thanh toán Đăng ký”
API: Tra cứu chi tiết đơn đăng ký qua endpoint /open/v1/order/detail.
https://docs.gate.com/api-reference/version/100/en/endpoint/subscription/deductionOrderDetail
Giao Diện Đăng Ký
Lưu Ý
- Hiện tại chưa hỗ trợ chỉnh sửa các gói đăng ký đã tạo (số tiền, chu kỳ, v.v.). Nếu muốn thay đổi, vui lòng tạo gói đăng ký mới.
- Cấu trúc phí giống với giải pháp thanh toán Web3 Gate Pay hiện tại. Mức phí riêng cho thanh toán đăng ký sẽ được cập nhật ở các phiên bản sau.
- Người dùng chịu phí gas khi ủy quyền; phí gas cho mỗi lần trừ tự động sẽ do nền tảng chi trả.
Miễn trừ trách nhiệm
Nội dung được cung cấp ở đây chỉ mang tính chất tham khảo và cung cấp kiến thức, không cấu thành bất kỳ lời khuyên tài chính, đầu tư, giao dịch hoặc pháp lý nào, cũng như không phải là lời đề nghị hoặc lời mời mua hoặc bán bất kỳ tài sản kỹ thuật số nào. Gate không đưa ra bất kỳ tuyên bố hoặc bảo đảm nào, dù rõ ràng hay ngụ ý, về tính chính xác, đầy đủ hoặc kịp thời của thông tin được cung cấp ở đây. Các tính năng sản phẩm, giao diện, quy tắc và cấu trúc phí có thể được cập nhật hoặc điều chỉnh bất cứ lúc nào. Vui lòng tham khảo các thông báo mới nhất và thông tin thực tế được hiển thị trên nền tảng Gate để biết chi tiết chính xác nhất.
Đầu tư vào tài sản kỹ thuật số tiềm ẩn rủi ro đáng kể và giá cả có thể biến động mạnh. Bạn có thể mất toàn bộ số tiền đầu tư. Vui lòng đưa ra quyết định thận trọng dựa trên tình hình tài chính và khả năng chấp nhận rủi ro của riêng bạn sau khi hiểu đầy đủ các rủi ro liên quan. Nếu cần, bạn nên tham khảo ý kiến của cố vấn tài chính hoặc pháp lý chuyên nghiệp độc lập.
Để biết thêm thông tin về các rủi ro tiềm ẩn, vui lòng tham khảo Tuyên bố về Rủi ro và Thỏa thuận Người dùng của Gate.
