Câu hỏi thường gặp
Giới hạn số tiền đặt lệnh
1. Giới hạn số tiền tối thiểu:
Gate Payment: 0.0001 (tất cả đơn vị tiền tệ)
Thanh toán Web3 On-Chain: 0.01 USDT (hoặc giá trị tương đương bằng các loại tiền tệ khác)
Số tiền tối thiểu cho Flash Exchange: API truy vấn cặp tiền tệ sẽ trả về giá trị tối đa và tối thiểu.
Số tiền đặt lệnh không được thấp hơn số tiền tối thiểu đã quy định. Ví dụ, nếu giới hạn số tiền tối thiểu là 0.0001, số tiền đặt lệnh phải ≥ 0.0001, như 0.0001, 0.00011, v.v.
2. Giới hạn độ chính xác:
Số chữ số thập phân trong số tiền đặt lệnh không được vượt quá độ chính xác đã quy định. Ví dụ, nếu độ chính xác được đặt là 0.0001 (tức tối đa 4 chữ số thập phân), 0.001 là hợp lệ, nhưng 0.00011 sẽ báo lỗi và không được làm tròn.
Số tiền đặt lệnh phải đồng thời đáp ứng cả yêu cầu về số tiền tối thiểu và độ chính xác, nếu không sẽ không thể gửi lệnh. Ví dụ, nếu số tiền tối thiểu là 0.0001 và giới hạn độ chính xác là 0.1, 0.01 vẫn không đáp ứng yêu cầu về độ chính xác và sẽ báo lỗi.
Mô tả phí rút tiền
API phí rút tiền
https://docs.gate.com/api-reference/version/100/en/endpoint/withdraw/withdrawStatus
Mô tả
Gọi API “Withdrawal Fee Query” sẽ trả về mức phí cần thiết cho từng mạng blockchain mà loại tiền đó hỗ trợ. Người dùng có thể lựa chọn mạng lưới phù hợp với nhu cầu của mình.
Vui lòng tham khảo hai tham số sau:
Tham số phí
- withdraw_fix_on_chains : Phí rút cố định
- withdraw_percent_on_chains : Phí rút tính theo phần trăm
(Với một số loại tiền đặc biệt, phí rút được tính bằng số tiền rút × tỷ lệ phần trăm này)
Phương pháp tính phí
Phí rút tiền là tổng của hai phần sau:
Phí cố định + (tỷ lệ phần trăm × số tiền rút)
Lưu ý khác
Hiện tại, hầu hết các mạng phổ biến chỉ thu phí cố định
(phí cố định được cập nhật hàng giờ).
Khuyến nghị nên gọi API này mỗi lần thực hiện rút tiền để xác nhận mức phí mới nhất, vì phí rút tiền được cập nhật mỗi giờ.
Tại sao thanh toán thực hiện trong thời hạn hợp lệ lại bị đánh dấu là đơn hàng hết hạn?
Thời gian thanh toán được xác định dựa trên thời điểm giao dịch được phát hiện trên chuỗi, không phải khi người dùng bắt đầu thanh toán. Có thể xảy ra độ trễ giữa hai thời điểm này.
Tại sao ghi nhận thu chi trong ứng dụng Gate và Bảng điều khiển Merchant lại không đồng nhất
Thông tin giao dịch hiển thị trên bảng điều khiển merchant của Gate Pay tương ứng với tài khoản số dư merchant
(tài khoản này chỉ dành cho các merchant đã đăng ký Gate Pay). Chủ yếu dùng cho hoạt động thu và chi quỹ của merchant.
Còn ứng dụng Gate là tài khoản cá nhân trên sàn Gate.
Vì tài khoản số dư merchant và tài khoản cá nhân là độc lập, nên quỹ và lịch sử giao dịch không được chia sẻ giữa hai tài khoản này. Do đó, thông tin giao dịch hiển thị trên ứng dụng Gate hoặc nền tảng Web có thể khác với ghi nhận thực tế của tài khoản merchant.
Ý nghĩa của merchantTradeNo và merchantUserId trong API Tạo Đơn Hàng
- merchantTradeNo: Số đơn hàng trong hệ thống của merchant, tối đa 32 ký tự.
- merchantUserId: ID tài khoản người dùng trong hệ thống của merchant. Đây phải là ID người dùng hợp lệ; nếu không, việc hoàn tiền liên quan đến thanh toán về địa chỉ này sẽ thất bại do hệ thống không thể xác định người dùng.
Thông tin callback cho thanh toán qua địa chỉ on-chain
Tại sao có hai thông báo callback cho thanh toán?
- Thông báo nhận tiền (TRANSFER_ADDRESS): Thông báo về việc tiền đã được nhận.
- Thông báo thay đổi trạng thái đơn hàng (PAY_ADDRESS): Thông báo về thay đổi trạng thái đơn hàng.
Merchant cần dựa vào hai loại thông tin này để xác định đơn hàng thành công để tiến hành giao hàng hoặc xử lý đơn hàng thất bại.
Khi nào gửi thông báo callback?
- Thông báo nhận tiền
Được gửi sau khi thanh toán được xác nhận trên chuỗi, cho phép tiền được ghi nhận vào tài khoản merchant theo thời gian thực và thông báo cho merchant. - Thông báo thay đổi trạng thái đơn hàng
Được kích hoạt khi trạng thái đơn hàng thay đổi.
Giải thích trạng thái callback
1. Thông báo nhận tiền (biztype = TRANSFER_ADDRESS)
- TRANSFERRED_ADDRESS_IN_TERM: Tiền được ghi nhận theo thời gian thực trong thời hạn hiệu lực của đơn hàng.
- TRANSFERRED_ADDRESS_DELAY: Tiền nhận sau thời hạn hiệu lực sẽ được ghi vào tài khoản thanh toán của merchant (ghi nhận theo thời gian thực sau khi hết hạn).
- TRANSFERRED_ADDRESS_BLOCK: Giao dịch có nguy cơ bảo mật và bị từ chối. Vui lòng liên hệ Gate Pay để được hỗ trợ hoàn tiền.
2. Thông báo thay đổi trạng thái đơn hàng (biztype = PAY_ADDRESS)
- PAY_SUCCESS: Thanh toán thành công.
- PAY_CLOSE: Đơn hàng đã hết hạn.
- PAY_EXPIRED_IN_PROCESS: Đang chờ xác nhận tiền trên chuỗi.
Các trường hợp thanh toán và xác định trạng thái đơn hàng qua địa chỉ on-chain
1. Thanh toán đủ hoặc vượt mức trong thời hạn hiệu lực
Mô tả: Nếu người dùng thanh toán đủ hoặc hơn số tiền yêu cầu trong thời hạn hiệu lực, sau khi được xác nhận trên chuỗi, cả hai callback sẽ được kích hoạt.
Thông báo trạng thái đơn hàng:
- Ban đầu: bizStatus = PAY_EXPIRED_IN_PROCESS
- Sau xác nhận: bizStatus = PAY_SUCCESS, doneAmountOnChain được bao gồm.
Thông báo nhận tiền: bizStatus = TRANSFERRED_ADDRESS_IN_TERM, số tiền ghi nhận = transferAmount.
2. Thanh toán một phần trong thời hạn hiệu lực
Mô tả: Người dùng thanh toán ít hơn số tiền đơn hàng trong thời hạn hiệu lực. Sau khi xác nhận trên chuỗi, số tiền được ghi nhận và gửi thông báo nhận tiền.
Thông báo trạng thái đơn hàng: Không được kích hoạt.
Thông báo nhận tiền: bizStatus = TRANSFERRED_ADDRESS_IN_TERM, số tiền = transferAmount.
3. Thanh toán một phần nhưng không bổ sung thêm
Mô tả: Đã thanh toán một phần, nhưng không bổ sung thêm trước khi hết hạn.
Thông báo trạng thái đơn hàng: Gửi khi đơn hàng hết hạn: bizStatus = PAY_CLOSE, số tiền = doneAmountOnChain.
Thông báo nhận tiền: Đã gửi trước đó khi tiền về. Không gửi lại callback.
4. Thanh toán một phần và có bổ sung
4.1 Bổ sung trong thời hạn hiệu lực
Thông báo trạng thái đơn hàng:
- Khi bổ sung: bizStatus = PAY_EXPIRED_IN_PROCESS
- Sau xác nhận: bizStatus = PAY_SUCCESS, doneAmountOnChain phản ánh tổng số tiền đã nhận.
Thông báo nhận tiền: Chỉ gửi sau khi xác nhận: bizStatus = TRANSFERRED_ADDRESS_IN_TERM, số tiền = transferAmount.
4.2 Bổ sung sau thời hạn hiệu lực
Thông báo trạng thái đơn hàng:
- Khi hết hạn: bizStatus = PAY_CLOSE, số tiền = doneAmountOnChain.
- Không có thông báo trạng thái đơn hàng bổ sung sau khi bổ sung muộn.
Thông báo nhận tiền:
- Khi bổ sung muộn: bizStatus = TRANSFERRED_ADDRESS_DELAY, số tiền = transferAmount.
- doneAmountOnChain sẽ không được bao gồm. Merchant cần tự cộng dồn nhiều giá trị transferAmount.
5. Thanh toán sau khi hết hạn
Mô tả: Người dùng thanh toán sau khi đơn hàng đã hết hạn, bất kể số tiền.
Thông báo trạng thái đơn hàng: Khi hết hạn: bizStatus = PAY_CLOSE.
Thông báo nhận tiền: Khi thanh toán muộn: bizStatus = TRANSFERRED_ADDRESS_DELAY, số tiền = transferAmount. Không có doneAmountOnChain và không có callback trạng thái đơn hàng cho các khoản thanh toán sau khi hết hạn. Merchant cần tự cộng dồn tất cả giá trị transferAmount đã nhận.
Merchant nên xác định thành công của đơn hàng dựa trên cả trạng thái đơn hàng và thông báo callback nhận tiền.
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.
