Câu hỏi thường gặp
Giới hạn số lượng lệnh
1. Giới hạn số tiền tối thiểu: Gate Payment: 0.0001 (tất cả các đơn vị tiền tệ)
Thanh toán On-Chain Web3: 0.01 USDT (hoặc tương đương bằng các loại tiền tệ khác)
Số lượng trao đổi Flash tối thiểu: 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 lệnh không được thấp hơn số tiền tối thiểu đã đặt. Ví dụ, nếu giới hạn số tiền tối thiểu là 0.0001, số lượng lệnh phải là ≥ 0.0001, chẳng hạn như 0.0001, 0.00011, v.v.
2. Giới hạn độ chính xác: Số lượng chữ số thập phân trong số tiền lệnh không được vượt quá độ chính xác đã đặt. Ví dụ, nếu độ chính xác được đặt là 0.0001 (tức là, tối đa 4 chữ số thập phân), 0.001 là hợp lệ, nhưng 0.00011 sẽ dẫn đến một lỗi và sẽ không được làm tròn.
Số lượng lệnh phải gặp cả hai số tiền tối thiểu và yêu cầu độ chính xác, nếu không, nó sẽ không thể được gửi. 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 độ chính xác và sẽ dẫn đến một lỗi.
Giải thích phí rút tiền
API để Kiểm Tra Tình Trạng Rút Tiền
https://www.gate.com/docs/developers/apiv4/vi/#retrieve-withdrawal-status
Mô tả
The “Kiểm tra trạng thái rút tiền” API cho phép người dùng truy xuất thông tin phí rút tiền cho các token khác nhau trên các chuỗi được hỗ trợ. Người dùng có thể chọn chuỗi theo nhu cầu.
Tham số phí
rút_fix_on_chains: Phí rút tiền cố định
rút_pha_phan_tram_tren_chuoi: Phí rút tiền dựa trên tỷ lệ phần trăm (áp dụng cho một số token đặc biệt nhất định, được tính như Số tiền rút × Tỷ lệ phần trăm)
Công thức tính toán
Phí rút tiền = Phí cố định + ( Tỷ lệ phí phần trăm × Số tiền rút)
Ghi chú thêm
Các chuỗi được sử dụng phổ biến nhất chỉ tính một phí funding phí rút tiền cố định, cái nào cập nhật mỗi giờ.
Xin vui lòng Thực hiện một yêu cầu API trước mỗi lần rút tiền để lấy dữ liệu phí mới nhất và đảm bảo tính toán chính xác.
Tại sao một khoản thanh toán thực hiện trong thời gian hiệu lực lại được đánh dấu là lệnh đã 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 on-chain, không phải khi người dùng khởi tạo thanh toán. Có thể xảy ra sự chậm trễ giữa hai thời điểm này.
Tại sao các hóa đơn hiển thị trên ứng dụng hoặc trang web Gate lại khác với khoản thanh toán thực tế nhận được?
Ứng dụng hoặc trang web hiển thị số tiền lệnh, không phải số tiền thực tế mà người dùng đã thanh toán. Ngay cả khi số tiền thanh toán của người dùng khác với số tiền lệnh, số tiền lệnh vẫn sẽ được hiển thị. Để biết chi tiết về hóa đơn, luôn tham khảo backend của merch.
Ý nghĩa của merchantTradeNo và merchantUserId trong API Tạo Lệnh
- merchantTradeNo: Số lệnh trong hệ thống của merch, với độ dài tối đa là 32 ký tự.
- merchantUserId: ID tài khoản người dùng trong hệ thống của merch. Đây phải là một ID người dùng hợp lệ; nếu không, các khoản hoàn tiền liên quan đến thanh toán đến địa chỉ sẽ thất bại vì hệ thống không thể xác định người dùng.
Thông tin Callback cho thanh toán Địa chỉ on-chain
Tại sao lại có hai thông báo callback cho các khoản thanh toán?
- Thông báo Nhận tiền (TRANSFER_ADDRESS): Thông báo về khoản phí funding đã nhận.
- Thông báo thay đổi trạng thái lệnh (PAY_ADDRESS): Thông báo về sự thay đổi trong trạng thái lệnh.
Các nhà buôn cần dựa vào hai loại thông tin này để xác định xem lệnh có thành công để tiến hành vận chuyển hay xử lý các lệnh thất bại.
Khi nào thông báo callback được gửi?
- Thông báo về việc tiền vào tài khoản Gửi sau khi thanh toán được xác nhận trên chuỗi, cho phép tiền được ghi có vào tài khoản của merch theo thời gian thực trong khi thông báo cho merch.
- Thông báo thay đổi trạng thái lệnh Kích hoạt khi trạng thái lệnh thay đổi.
Hiểu về 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 có ngay lập tức trong thời gian hợp lệ của lệnh.
- TRANSFERRED_ADDRESS_DELAY: Tiền nhận được sau thời gian hợp lệ sẽ được ghi có vào tài khoản thanh toán của thương nhân (ghi có ngay lập tức sau thời gian hợp lệ).
- TRANSFERRED_ADDRESS_BLOCK: Giao dịch có nguy cơ bảo mật tiềm ẩn và bị từ chối. Vui lòng liên hệ với Gate Pay để được hỗ trợ hoàn tiền.
2. Thông báo thay đổi trạng thái lệnh (biztype = PAY_ADDRESS)
- PAY_SUCCESS: Thanh toán thành công.
- PAY_CLOSE: Lệnh đã hết hạn.
- PAY_EXPIRED_IN_PROCESS: Đang chờ xác nhận on-chain của quỹ.
Kịch bản thanh toán và xác định trạng thái lệnh cho thanh toán Địa chỉ on-chain
1. Thanh toán đầy đủ hoặc thừa trong Thời gian Hiệu lực
Mô tả : Nếu một người dùng thanh toán đầy đủ hoặc nhiều hơn số tiền yêu cầu trong thời gian hiệu lực, một khi được xác nhận on-chain, cả hai callback sẽ được kích hoạt.
Thông báo trạng thái lệnh :
- Ban đầu: bizStatus = PAY_EXPIRED_IN_PROCESS
- Sau khi xác nhận: bizStatus = PAY_SUCCESS, doneAmountOnChain đã bao gồm.
Thông báo về việc tiền đã đến : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, số tiền đã ghi có = transferAmount.
2. Thanh toán một phần trong thời gian hiệu lực
Mô tả : Người dùng thanh toán ít hơn số tiền lệnh trong thời gian hiệu lực. Một khi được xác nhận on-chain, số tiền sẽ được ghi có và một thông báo về việc tiền đã đến sẽ được gửi.
Thông báo trạng thái lệnh : Chưa được kích hoạt.
Thông báo về việc tiền đã đến : bizStatus = ĐỊA_CHỈ_CHUYỂN_NHƯỢNG_TRONG_THỜI_HẠN, amount = transferAmount.
3. Thanh toán một phần không có bổ sung
Mô tả : Thanh toán một phần đã được thực hiện, nhưng không có số tiền nào khác được thêm vào trước khi hết hạn.
Thông báo trạng thái lệnh : Gửi khi lệnh hết hạn: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.
Thông báo về việc tiền đã đến : Đã gửi trước đó khi tiền đã đến. Không gọi lại lặp lại.
4. Thanh toán một phần với bổ sung
4.1 Bổ sung trong thời gian hiệu lực Thông báo trạng thái lệnh :
- Khi bổ sung: bizStatus = PAY_EXPIRED_IN_PROCESS
- Sau khi xác nhận: bizStatus = PAY_SUCCESS, doneAmountOnChain phản ánh tổng số đã nhận.
Thông báo về việc tiền đến : Gửi chỉ sau khi xác nhận: bizStatus = ĐỊA_CHỈ_CHUYỂN_NHƯỢNG_TRONG_THỜI_HẠN, amount = transferAmount.
4.2 Bổ sung sau thời gian hiệu lực
Thông báo trạng thái lệnh :
- Khi hết hạn: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.
-
Không có thông báo trạng thái lệnh bổ sung nào sau khi bổ sung muộn.
Thông báo về việc đến của quỹ :
- Khi bổ sung muộn: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount.
-
doneAmountOnChain sẽ không được bao gồm. Các thương nhân cần phải tổng hợp nhiều giá trị transferAmount một cách thủ công.
5. Thanh toán thực hiện sau khi hết hạn
Mô tả : Người dùng thanh toán sau khi lệnh đã hết hạn, bất kể số tiền.
Thông báo trạng thái lệnh : Khi hết hạn: bizStatus = PAY_CLOSE.
Thông báo về việc tiền đã đến :Khi thanh toán muộn: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount. Không có doneAmountOnChain và không có callback trạng thái lệnh cho các khoản thanh toán sau khi hết hạn. Các thương nhân phải tổng hợp tất cả các giá trị transferAmount đã nhận..
Người bán nên xác định thành công của một lệnh dựa trên cả trạng thái lệnh và thông báo gọi lại về việc tiền đã đến.
