Hỏi và đáp
Những gì người tích hợp hỏi trước đơn hàng đầu tiên — chia nhóm và trả lời ngắn. Chỗ nào câu trả lời thuộc về hợp đồng chứ không phải thói quen của chúng tôi, tài liệu API nói đúng điều đó một cách đầy đủ hơn.
Năng lượng và giá
Năng lượng TRON là gì?
Một tài nguyên mạng dùng để trả cho việc chạy hợp đồng thông minh. Khi ví gửi có đủ năng lượng, một lần chuyển USDT gần như không đốt TRX nào.
Vì sao nó rẻ hơn đốt?
Việc đốt định giá năng lượng theo mức của giao thức, ~210 sun mỗi đơn vị — một con số không bao giờ nhúc nhích. Chúng tôi gom năng lượng ủy quyền theo khối lượng lớn rồi bán lại với một phần nhỏ của mức đó; giá đang có hiệu lực lúc này nằm ở trang giá.
Xem toàn bộ bảng giá →
Nếu tôi lỡ mất cửa sổ 4 phút thì sao?
Ở mode A khoản tiền vẫn bị tính: năng lượng đã được giao, và cái bạn trả tiền là việc giao đó. Ở mode B, một khi cửa sổ đã đóng thì chúng tôi không phát đi gì nữa, nên mục đó hỏng và phần giữ lại trả về nguyên vẹn. Cửa sổ đi kèm mọi đơn hàng — hãy dựng quy trình của bạn quanh nó.
Lỡ cửa sổ gửi có tốn như nhau ở cả hai chế độ không?
Không. Ở mode A năng lượng đã được giao, nên khoản tiền vẫn bị tính — ở mode C cũng vậy, nơi không có lần chuyển nào để chờ và mục đó chỉ đơn giản là hết hạn khi cửa sổ đóng. Ở mode B, một khi cửa sổ đã đóng thì chúng tôi không phát đi nữa: một lần chuyển đi muộn sẽ gặp cái ví mà năng lượng ủy quyền đã rời khỏi, và đốt TRX của bạn. Mục đó đóng lại ở trạng thái failed với broadcast_window_missed, phần giữ lại trả về nguyên vẹn, còn năng lượng chúng tôi mua cho nó là tổn thất của chúng tôi.
Tiền và hoàn trả
Tôi trả tiền thế nào?
Số dư dịch vụ trả trước, tính bằng TRX: gửi TRX tới địa chỉ riêng của bạn rồi tiêu cho dịch vụ. Giá được chốt ngay khi tạo đơn hàng.
Tôi được gửi token nào tới địa chỉ nạp tiền?
TRX, và chỉ TRX. USDT gửi tới địa chỉ nạp tiền không được ghi có tự động: chúng tôi không nhận rủi ro tỷ giá và không làm dịch vụ quy đổi, nên khoản đó được để riêng cho người xem, và ghi có hay không là quyết định của chúng tôi trong từng trường hợp. Gửi nhầm token? Hãy viết cho chúng tôi, và đừng gửi thêm.
Bao lâu thì tiền nạp tiêu được?
Sau 3 xác nhận — khoảng mười giây. Sau đó số dư hiện ra làm ba phần: tổng số, phần đang giữ cho các đơn hàng đang chạy, và phần khả dụng. Đơn hàng được tạo từ phần khả dụng, không phải từ tổng số.
Tôi hủy đơn hàng được không?
Chỉ trước khi việc mua bắt đầu; sau đó câu trả lời là order_not_cancelable, vì năng lượng đã được mua rồi. Đơn hàng bị hủy nhả toàn bộ phần giữ lại và không tính tiền gì cả.
Còn chuyện hoàn tiền thì sao?
Việc nhả tiền diễn ra tự động và không bao giờ cần mở phiếu yêu cầu. Quy tắc chỉ có một: năng lượng chúng tôi không giao thì không tính tiền, và phần giữ lại quay về số dư của bạn dưới dạng số dư dịch vụ — một lần giao hỏng, một đơn hàng hủy trước khi việc mua bắt đầu, phần chưa tiêu của một ngày Auto-refill. Năng lượng đã giao thì vẫn tính tiền, dù bạn có dùng hay không.
An toàn và khóa
Các bạn cần những khóa nào?
Không khóa nào. Mode A không bao giờ nhìn thấy giao dịch của bạn. Mode B nhận giao dịch bạn đã ký sẵn, và chúng tôi không sửa nổi một byte trong đó.
Các bạn có nhận người gửi dùng đa chữ ký không?
Ở mode B thì không: giao dịch phải mang đúng một chữ ký của chủ sở hữu, với Permission_id 0. Bộ khóa của một tài khoản đa chữ ký nằm trên mạng và thay đổi mà chúng tôi không hay biết, nên chúng tôi không thể hứa rằng lần phát đi sẽ được chấp nhận. Ở mode A thì không gì về cách bạn ký đến được chỗ chúng tôi — lần chuyển đó do chính bạn phát đi.
Các bạn giữ những gì, và giữ bao lâu?
Ở mode B, giao dịch bạn đã ký được giữ ở dạng mã hóa và bị xóa 7 ngày sau khi đơn hàng đạt trạng thái cuối. Đơn hàng, các bút toán sổ cái và các lần nạp tiền thì ở lại: đó là sổ sách, và đó là phần chúng tôi buộc phải lưu. Ngoài ra ở đây không có gì của bạn — không khóa riêng, không cụm từ khôi phục, không giữ hộ tiền.
Tích hợp
Có hạn mức nào không?
120 đơn hàng mỗi phút cho mỗi khóa, tối đa 500 lần chuyển trong một đơn hàng gộp. Vượt hạn mức thì bạn nhận Retry-After, chứ không bị chặn lặng lẽ.
completed thực ra nghĩa là gì?
Là năng lượng đã được giao — không phải là lần chuyển của bạn đã gửi đi. Nghĩa vụ là việc giao, và đơn hàng đóng lại ở đó: ở mode A, completed có thể đến trước khi bạn gửi bất cứ thứ gì. Hãy canh send_before xuất hiện trong đơn hàng chứ đừng canh chữ ready: hỏi hai giây một lần, bạn có thể không thấy ready lần nào.
Tính idempotent hoạt động ra sao?
Idempotency-Key gắn với đúng chuỗi byte thô của phần thân đã đi cùng nó. Cùng một khóa với phần thân giống nhau từng byte sẽ trả lại đúng đơn hàng đó; cùng một khóa với phần thân khác là xung đột; một yêu cầu bị khâu kiểm tra chặn lại thì không tiêu tốn khóa, nên sửa phần thân xong bạn vẫn dùng lại khóa ấy được. Hãy tuần tự hóa phần thân một lần rồi gửi lại đúng những byte đó — thứ tự khóa khác đi hay thừa một dấu cách đã là phần thân khác.
Tôi kiểm tra một địa chỉ mà không phải trả gì được không?
Được, và miễn phí. GET /v1/address-check cho biết chúng tôi biết gì về một chiếc ví, còn POST /v1/estimate tính giá cho tối đa 500 người nhận theo đúng các quy tắc mà một đơn hàng sẽ dùng — kể cả ai trong số đó bị hợp đồng token đưa vào danh sách đen. Cả hai đều không giữ gì và không tính tiền gì.
Tài khoản của bạn
Ví có thể tự giữ mình luôn đầy năng lượng không?
Có — một quy tắc Auto-refill: một địa chỉ cộng một ngân sách mỗi ngày. Năng lượng được nạp lại sau mỗi lần chuyển; ngân sách là cái trần cứng của ngày.
Nên đặt balance.low ở mức nào?
Con số này là thiết lập của riêng bạn — balance_low_threshold_trx trong PATCH /v1/settings; balance.low là sự kiện chạy theo nó. Mức hữu ích khoảng bằng lượng giao dịch một ngày của bạn: khi đó cảnh báo đến trước một ngày so với lúc các đơn hàng bắt đầu nhận insufficient_balance, chứ không đến thay cho lần từ chối đầu tiên. Thấp hơn hẳn thì sự kiện thành lời báo sau khi mọi chuyện đã rồi; cao hơn hẳn thì thành tiếng ồn. Số không sẽ tắt nó.
Có môi trường thử nghiệm hay mức tối thiểu nào không?
Không có mức tối thiểu, không thuê bao, và không phải trả tiền cho thời gian nhàn rỗi. Cũng không có môi trường thử nghiệm: base URL là bản chạy thật, và chỉ có mỗi một cái đó. Các endpoint tra cứu, một lần ước tính và một lần thử webhook đều không mất gì, nên phần lớn việc tích hợp có thể dựng xong trước khi có bất kỳ đơn hàng nào.