Nạp tiền on-chain

Quy trình tích hợp nạp USDT: thu qua TRC20 và ERC20, xác nhận on-chain và ghi sổ số dư

Nạp USDT nghĩa là người dùng trả vào địa chỉ blockchain riêng của đơn vị kinh doanh, rồi hệ thống của đơn vị kinh doanh tăng số dư nội bộ cho người dùng. 稳付pay giám sát giao dịch, kiểm tra điều kiện xác nhận và gửi callback nghiệp vụ; tiền đi thẳng vào ví đơn vị kinh doanh, không thu hộ và không lưu ký. Khi tích hợp cần ghi riêng khoản thu on-chain thực tế với số dư nội bộ, kết nối hai phần bằng liên kết đơn tin cậy và ghi sổ lũy đẳng.

Mục lục bài viết

1. Hai mạng và ví riêng của đơn vị kinh doanh

Mạng được hỗ trợ trên website nàyDạng tài sảnKiểm tra khi tích hợp
TronUSDT TRC20Mạng Tron, hợp đồng USDT đã xác minh và địa chỉ nhận của đơn vị kinh doanh.
EthereumUSDT ERC20Mạng Ethereum, hợp đồng USDT đã xác minh và địa chỉ nhận của đơn vị kinh doanh.

Không chỉ nhìn tên “USDT” hoặc biểu tượng token. Danh sách giao thức và hợp đồng chính thức của Tether giúp đối chiếu tài sản trên đúng mạng; token cùng tên không tự động là USDT được hỗ trợ. Kiểm tra địa chỉ đầy đủ, không chỉ so vài ký tự cuối.

Khách trả trực tiếp vào ví do đơn vị kinh doanh kiểm soát. Để mở giám sát, chỉ cung cấp thông tin nhận theo yêu cầu, không giao khóa riêng hoặc cụm từ khôi phục cho 稳付pay. Số dư USDT nội bộ là sổ nghiệp vụ của đơn vị kinh doanh, còn số dư ví là tài sản on-chain; không gộp thành cùng một tài khoản.

2. Gắn đơn với người dùng trước, rồi xác nhận cách nhận diện

Đơn vị kinh doanh lưu trước ID người dùng, mã đơn nạp gốc, mạng chọn, tài sản, địa chỉ nhận, lượng phải trả, hạn dùng và quy tắc ghi có. Nếu nội bộ dùng điểm hoặc đơn vị định giá khác, còn cần lưu bản chụp quy đổi, độ chính xác và quy tắc tiền tặng lần này, không tùy ý thay đổi sau khi khách trả.

Cách gắn một giao dịch chuyển với đơn gốc phải xác nhận cùng đội kỹ thuật khi mở dịch vụ; không mặc định nền tảng cấp địa chỉ mới mỗi đơn, yêu cầu memo hay tự điều chỉnh nhẹ số tiền. Khi nhiều người cùng trả số tiền giống nhau vào một địa chỉ, chỉ số tiền và thời gian gần đúng không đủ nhận diện; đối chiếu theo phương án đã xác nhận, chuyển kiểm tra thủ công nếu không xác định duy nhất được.

Mạng, địa chỉ đơn vị kinh doanh và lượng phải trả hiển thị cho người dùng phải lấy từ đơn đã lưu ở máy chủ. Bài này chỉ dùng giá trị giữ chỗ như MERCHANT_WALLET_ADDRESS, ORDER_ID, không cung cấp địa chỉ ví dụ có thể chuyển tiền trực tiếp.

Khi thay địa chỉ, giữ phiên bản và phạm vi hiệu lực; đơn cũ vẫn kiểm tra theo cấu hình gốc. Có nhận trả nhiều phần không, cộng dồn thế nào và xử lý sau khi đơn hết hiệu lực cũng cần thỏa thuận trước, không tự gộp vài giao dịch cùng số tiền cho một người dùng.

3. Sáu bước từ thanh toán on-chain đến số dư nội bộ

  1. Tạo đơn nạpGắn người dùng với mạng, tài sản, địa chỉ nhận và lượng phải trả.
  2. Người dùng kiểm tra và trả tiềnChọn đúng mạng, gửi USDT đến địa chỉ riêng của đơn vị kinh doanh.
  3. Giám sát giao dịch ứng viênNhận diện sự kiện chuyển liên quan, giữ định danh giao dịch và sự kiện.
  4. Xác minh thực thi và xác nhậnKiểm tra thực nhận, chờ điều kiện xác nhận được cấu hình cho mạng đã chọn.
  5. Đơn vị kinh doanh xác thực callbackXác minh nguồn và nội dung theo thỏa thuận riêng, khớp với đơn gốc.
  6. Ghi sổ nguyên tửLưu bền vững cùng nhau việc gán sự kiện, bản ghi nạp và số dư người dùng.
Callback nghiệp vụ được gửi trong vài giây sau khi đạt điều kiện xác nhận đã cấu hình; không có nghĩa xác nhận khối luôn chỉ mất vài giây.

4. Thấy giao dịch chuyển không có nghĩa đã đạt điều kiện xác nhận

Ví hiển thị “đã gửi”, có hash giao dịch, phát giao dịch thành công hay lắng nghe được Transfer đều không đủ làm căn cứ ghi có riêng lẻ. Cần đối chiếu kết quả thực thi thực tế trên đúng mạng, hợp đồng token đã xác minh, địa chỉ thực nhận và lượng USDT, rồi kiểm tra đạt điều kiện xác nhận chưa. Cũng không được nhầm hợp đồng đích được giao dịch gọi với người nhận trong sự kiện.

Tài liệu ngữ nghĩa xác nhận của TRON phân biệt phát giao dịch, biên nhận thực thi và trạng thái solidify; giao dịch đã vào chuỗi solidify vẫn phải kiểm tra thực thi thành công hay không. Tài liệu Ethereum về Tính chung cuộc cũng cho thấy vào khối và đạt tính chung cuộc là hai giai đoạn khác nhau.

Điều kiện xác nhận cụ thể được xác định theo mạng và cấu hình tích hợp, không viết chung thành một số giây cố định. Khi nút lập chỉ mục chậm hoặc truy vấn tạm thất bại, giữ bản ghi gốc để tiếp tục xác minh, không vì thế kết luận chuyển tiền thất bại hoặc yêu cầu người dùng gửi thêm lần nữa.

5. Giao thức callback USDT cần được xác nhận riêng

Khi mở dịch vụ, kỹ thuật viên làm rõ cách xác thực callback, định nghĩa trường, quy tắc xác nhận, lịch thử lại, nội dung phản hồi và cách chủ động kiểm tra. Không dùng trực tiếp tài liệu thu hộ Alipay, WeChat hiện có trên website làm giao thức USDT, cũng không áp dụng trường MD5, số lần thông báo, phản hồi OK hoặc tập trạng thái của các tài liệu đó.

Sau khi xác minh thông báo là thật, máy chủ đơn vị kinh doanh kiểm tra đơn gốc, mạng, hợp đồng token, địa chỉ nhận, lượng USDT thực tế, định danh giao dịch và tình hình xác nhận. Người dùng sở hữu được xác định từ đơn đã lưu, không tin lời “thanh toán thành công” gửi từ trình duyệt hay thông báo chưa xác thực. Nếu thiếu thông tin thì kiểm tra trước, không cộng số dư ngay.

Nếu thông báo đã đến nhưng ghi cơ sở dữ liệu thất bại, xử lý lỗi và bù theo thỏa thuận; thông báo trùng cùng kết quả kiểm tra chủ động dùng chung một đầu vào ghi sổ. Giữ bản ghi xác thực và xử lý, không ghi khóa hoặc bí mật ví vào log công khai.

6. Loại trùng theo sự kiện chuyển tiền và cập nhật số dư nguyên tử

Một giao dịch on-chain có thể chứa nhiều sự kiện chuyển; chỉ loại trùng bằng hash giao dịch có thể bỏ sót hoặc nhận nhầm. Có thể thiết kế khóa sự kiện nội bộ duy nhất bằng “mạng + txHash + logIndex hoặc số thứ tự sự kiện”; đây là ví dụ định danh nghiệp vụ, không phải trường nền tảng đã công bố. Thống nhất quy ước chỉ mục, giữ bằng chứng khối và sự kiện tương ứng để cùng sự kiện nhận tiền không được gán trả trùng cho nhiều đơn.

Giải thích log của Ethereum bao gồm hash giao dịch, chỉ mục log và cờ bị loại bỏ do tái tổ chức. Khi xác nhận bị lùi hoặc sự kiện thay đổi, dừng tự động xử lý và kiểm tra lại bản ghi gốc, không coi đó là khoản chuyển mới rồi cộng tiền lần nữa.

Cũng cần khóa và đối chiếu mức được phép ghi có cùng trạng thái của đơn gốc; thanh toán trùng, trả dư hoặc chia nhiều khoản được xử lý theo quy tắc đã thỏa thuận, không cộng lại toàn bộ số tiền đơn chỉ vì thấy một sự kiện mới.

Xác thực thông báo và xác minh sự kiện nhận tiền đã được xác nhận
Bắt đầu giao dịch cơ sở dữ liệu
  Khóa đơn nạp gốc và tài khoản người dùng
  Kiểm tra khóa sự kiện duy nhất cùng đơn đã liên kết
  Nếu sự kiện này đã ghi có cho đơn này: không cộng tiền nữa
  Nếu sự kiện đã được đơn khác nhận: ghi xung đột, không gán trả trùng
  Nếu chưa: lưu việc gán sự kiện, bản ghi nạp duy nhất và cập nhật số dư
Commit giao dịch
Trả kết quả xử lý theo thỏa thuận

Xử lý số nguyên ở đơn vị nhỏ nhất theo decimals của hợp đồng token đã xác minh, dùng số điểm cố định hoặc thập phân chính xác để tính, không dùng float cho lượng USDT. Lưu riêng số lượng gốc, kết quả quy đổi và tiền tặng; nếu giao dịch lỗi thì rollback toàn bộ, xử lý lặp hoặc đồng thời dựa vào ràng buộc duy nhất của cơ sở dữ liệu, không chỉ kiểm tra trước rồi ghi.

Ví dụ sự kiện EVENT_A đã được ghi vào ORDER_A, khi nhận lại thông báo hoặc kết quả kiểm tra thì trả kết quả xử lý gốc; nếu đơn khác ORDER_B tìm cách nhận EVENT_A, giữ xung đột để xác minh. Có ghi nhận sự kiện khác trong cùng giao dịch không có nghĩa tất cả đều thuộc đơn nạp hiện tại.

7. Xử lý trả muộn, chênh lệch số tiền và phí mạng

Tình huốngNguyên tắc xử lý
Thanh toán đến muộnGiữ khoản thực nhận, kiểm tra theo quy tắc hạn dùng đơn rồi ghi có bổ sung hoặc xử lý hậu mãi.
Trả thiếu, trả dưGhi chênh lệch phải trả và thực nhận, xác minh theo thỏa thuận, không tự ghép thành đơn khác.
Sai mạng, sai tokenDừng ghi có tự động, xác minh tài sản, địa chỉ và quyền kiểm soát rồi liên hệ kỹ thuật xử lý.
Xác nhận bị lùi hoặc kết quả chưa rõGiữ sự kiện và đơn gốc để kiểm tra lại, không cộng trùng hay yêu cầu chuyển lại ngay.

Hoàn tiền cần xác nhận riêng người nhận, mạng, số lượng, phí và quyền phê duyệt, không mặc định dịch vụ giám sát sẽ tự hoàn. Điều chỉnh đảo bút toán nội bộ phải có bản ghi riêng, không sửa sổ bằng cách xóa bản ghi gốc; giao dịch on-chain không tự hủy do đổi trạng thái nội bộ.

Gửi giao dịch TRC20 từ ví riêng liên quan băng thông, năng lượng của Tron và có thể tiêu thụ TRX; phí gas giao dịch Ethereum trả bằng ETH. Nếu rút từ sàn, còn cần kiểm tra phí rút và số lượng thực gửi. Xác nhận phí theo mạng và công cụ gửi tại thời điểm đó, không áp một mức phí cố định cho mọi đơn.

8. Đối soát từng khoản và nghiệm thu tích hợp

Liên kết mạng, hợp đồng, địa chỉ, sự kiện giao dịch, đơn nạp, bản ghi ghi có và số dư người dùng. Tổng số dư ví có thể gồm các khoản thu chi khác, không cộng tiền cho một người dùng chỉ vì số dư ví tăng; cũng không gộp nhận trực tiếp vào ví riêng của đơn vị kinh doanh với quyết toán USDT sau thu hộ WeChat, Alipay thành cùng dòng tiền.

Khi kiểm thử tích hợp, ít nhất xác minh thanh toán bình thường, thông báo trùng, kiểm tra chủ động đồng thời, nhiều sự kiện cùng giao dịch, đơn cùng số tiền cùng địa chỉ, trả thiếu dư, trả muộn, rollback cơ sở dữ liệu và xác nhận bất thường. Kiểm tra từng mục về việc gán sự kiện và số dư cuối cùng, bảo đảm không bỏ sót, không trùng và không cấp cùng sự kiện cho hai người dùng.

Tiền có vào ví 稳付pay trước không?

Không. Khách trả trực tiếp đến địa chỉ riêng của đơn vị kinh doanh; nền tảng chỉ giám sát và callback, không thu hộ và không lưu ký.

Thấy giao dịch on-chain là cộng số dư ngay sao?

Xác minh thực thi, tài sản, địa chỉ, số tiền và điều kiện xác nhận đã cấu hình trước, rồi máy chủ ghi sổ lũy đẳng.

Xác nhận mạng hiện hỗ trợ và phí thế nào?

Giám sát và callback trên hai mạng Tron, Ethereum được mở miễn phí cho quản trị website vừa và nhỏ; dịch vụ cấp doanh nghiệp tính phí riêng. Liên hệ đội kỹ thuật để xác nhận cách nhận diện đơn và cấu hình callback; API chi hộ độc lập hiện chưa mở.

Nguồn tham khảo

Tài liệu chính thức dùng để kiểm tra tài sản, xác nhận on-chain và phí mạng; giao thức thực tế, điều kiện xác nhận và quy tắc nhận diện đơn của dịch vụ giám sát USDT và callback theo cấu hình được đội kỹ thuật xác nhận khi mở dịch vụ.

Xác nhận tích hợp theo tình huống kinh doanh của bạn

Trình bày sản phẩm, số lượng đơn, phương thức thanh toán và nhu cầu quyết toán; lần lượt xác nhận API, dòng tiền và xử lý bất thường.

Liên hệ 稳付pay ↗