Thu tiền on-chain

Tích hợp USDT cho nền tảng bán mã: địa chỉ riêng, xác nhận on-chain và callback tin cậy

Thấy chuyển tiền on-chain chưa có nghĩa đơn đã thu tiền tin cậy; nhận callback một lần cũng không cho phép phát mã lặp. Tách ví, bằng chứng giao dịch, trạng thái thanh toán và giao tồn kho giúp đơn vị kinh doanh tự nắm tiền và truy vết giao hàng số.

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

1. Xác định ranh giới tiền: địa chỉ thuộc đơn vị kinh doanh, dịch vụ giám sát không giữ tài sản

Nền tảng bán mã ở đây là hệ thống giao tự động hàng số, mã bản quyền hoặc mã đổi. Khi tích hợp USDT, khách phải trả thẳng tới địa chỉ nhận riêng của đơn vị kinh doanh. 稳付pay theo dõi, nhận diện giao dịch, kiểm tra trạng thái nhận rồi callback hệ thống nghiệp vụ; tiền không đi qua 稳付pay, nền tảng không thu hộ và không lưu ký.

Đơn vị kinh doanh tự giữ ví và quyền ký. Chỉ cần địa chỉ nhận công khai để giám sát chỉ đọc, không giao cụm khôi phục, khóa riêng, tệp ví hay quyền điều khiển từ xa cho người giám sát. “Giúp cấu hình” cũng không phải lý do xin các thông tin này. Tự nắm tiền còn có nghĩa tự chịu trách nhiệm sao lưu địa chỉ, kiểm tra thanh toán và duyệt hoàn tiền.

2. Cố định mạng, token và điều kiện xác nhận lúc tạo đơn

稳付pay hiện hỗ trợ USDT trên Tron (TRC20) và Ethereum (ERC20). USDT là tên tài sản; TRC20, ERC20 là tiêu chuẩn token trên mạng khác nhau, không được trộn đơn và địa chỉ của tài sản cùng tên. Trang thu tiền phải hiển thị rõ mạng và yêu cầu khách xác nhận, không chỉ ghi “trả USDT”.

Mục kiểm traTron / TRC20Ethereum / ERC20
Bằng chứng giao dịch on-chainKiểm tra sự kiện chuyển tiền của hợp đồng đích đã thực thi thành côngKiểm tra log Transfer của hợp đồng đích trong biên nhận thành công
Căn cứ xác nhậnKiểm tra dữ liệu đã xác nhận, đã cố định theo thỏa thuậnTheo xác nhận khối hoặc chính sách safe/finalized đã thỏa thuận
Yêu cầu chungKiểm tra mạng, hợp đồng đích, địa chỉ đơn vị kinh doanh, số tiền và kết quả ghép đơn

Tài liệu giao dịch TRON phân biệt đưa vào khối và cố định; tài liệu Ethereum JSON-RPC cũng phân biệt trạng thái khối. Hai bên tích hợp phải thỏa thuận chính sách xác nhận, không thay bằng số giây cố định. Callback mức giây của 稳付pay là tốc độ thông báo sau khi đủ điều kiện xác nhận đã thỏa thuận, không cam kết blockchain tự xác nhận trong vài giây.

3. Ghép đơn không thể chỉ dựa vào “cùng số tiền”

Hai khách có thể đồng thời mua hàng cùng giá; một giao dịch cũng có thể chứa nhiều sự kiện chuyển token. Đơn ít nhất gắn mã nội bộ, định danh mạng (như chainId với Ethereum), hợp đồng token đích, địa chỉ nhận, số tiền nguyên và hạn. Bằng chứng giao dịch ghi riêng hash giao dịch, số thứ tự sự kiện, số khối và hash khối. Không coi hash khách nhập là bằng chứng đã nhận tiền.

Có thể cấp trước địa chỉ riêng do đơn vị kinh doanh kiểm soát cho từng đơn, hoặc đặt phiên thanh toán và quy tắc xung đột rõ khi dùng chung địa chỉ. Kể cả dùng số tiền khác biệt, vẫn phải kết hợp mạng, hợp đồng, địa chỉ, phiên còn hiệu lực và giao dịch thuộc về ai; nếu nhiều đơn phù hợp, chuyển kiểm tra thủ công, không “chọn đơn đầu tiên”.

Một log Ethereum thường được định vị bằng mạng, hash giao dịch và logIndex; TRON dùng số sự kiện do API cung cấp để tạo ánh xạ ổn định. Giữ sự kiện gốc và hash khối, tái kiểm tra chuỗi chuẩn khi tái tổ chức. Chỉ định vị sự kiện trên chuỗi chuẩn hiện tại, không coi logIndex bất biến qua mọi lần tái tổ chức; riêng hash giao dịch cũng không thay tính duy nhất cấp sự kiện.

4. Dùng đơn vị nhỏ nhất, kiểm tra riêng địa chỉ và hợp đồng

Không dùng dấu phẩy động so số tiền. Xác nhận độ chính xác từ cấu hình token đích đáng tin, rồi lưu số nguyên đơn vị nhỏ nhất. Ví dụ độ chính xác 6 thì 12.34 tương ứng 12340000 đơn vị; đây là ví dụ quy đổi, không khiến mọi hợp đồng tên USDT đáng tin. Mạng, hợp đồng và độ chính xác phải từ danh sách cho phép được quản lý, không lấy token cùng tên khách gửi.

Kiểm tra định dạng địa chỉ theo mạng và đối chiếu đầy đủ trên trang xác nhận. Phân biệt tiền chuyển và phí mạng ví trả: phí khách chịu không tự được tính vào giá hàng. Lần đầu tích hợp thử số tiền nhỏ, kiểm tra địa chỉ nhận và sự kiện thực, tránh coi trang hiển thị thành công là đã thu tiền on-chain.

5. Giữ trạng thái rõ giữa theo dõi giao dịch và giao mã

  1. Tạo phiên thanh toánCố định đơn, mạng, địa chỉ, số tiền và thời hạn
  2. Phát hiện và kiểm chứng chuyển tiềnKiểm tra sự kiện token đích thực thi thành công
  3. Chờ xác nhận đã thỏa thuậnGiữ thông tin khối và kiểm tra giao dịch thuộc về đâu
  4. Lưu bền vững thông báo thu tiềnHệ thống nghiệp vụ xác minh chữ ký, khử trùng và cập nhật đơn
  5. Giao tồn khoGhi riêng kết quả phát mã và tác vụ bù trừ
Phát hiện giao dịch, xác nhận, nhận callback và giao sản phẩm là các trạng thái khác nhau, không gộp thành một “thành công”.

Trình theo dõi giữ con trỏ quét, quét bù đoạn bỏ lỡ sau mất kết nối và cho phép quét chồng một vùng nhỏ. Dùng ràng buộc duy nhất để khử trùng, không dựa vào “lý thuyết sẽ không gửi lại”. Khoản chuyển chưa đủ điều kiện giữ chờ xác nhận; dừng tiến trạng thái khi nút chậm hoặc sự kiện bị hủy, không tiếp tục giao.

Ví dụ đặt khóa duy nhất tổng hợp không rỗng cho sự kiện thanh toán trong cơ sở dữ liệu và một bản ghi giao hàng duy nhất mỗi đơn. Tài liệu ràng buộc PostgreSQL giải thích ràng buộc duy nhất tổng hợp; thiết kế khóa theo mô hình sự kiện của mạng, không áp dụng máy móc cho mọi chuỗi.

6. Callback tin cậy cần nguồn xác thực, lưu bền vững và tính lũy đẳng

Callback dùng HTTPS, kiểm tra chữ ký, dấu thời gian, danh tính sự kiện theo giao thức hai bên, đồng thời kiểm tra đơn nội bộ, tiền tệ, mạng và số tiền. Nếu ký thân yêu cầu gốc, giữ byte gốc trước khi phân tích hay sắp xếp JSON. Làm rõ xoay khóa, dung sai thời gian và thử lại khi tích hợp; bài không bịa URL API hay trường chữ ký của 稳付pay.

Có thể tham khảo hướng dẫn Webhook chính thức của Stripe về sự kiện trùng và xác minh chữ ký, nhưng đó không phải đặc tả API 稳付pay. Xác minh xong, ghi thông báo tin cậy vào cơ sở dữ liệu hoặc hàng đợi bền vững rồi nhanh chóng trả phản hồi thành công đã thỏa thuận; ghi thất bại không được xác nhận trước. Phát mã chậm do tác vụ nền xử lý.

Cùng callback gửi lại mười lần cũng chỉ tiến trạng thái thu tiền và giao hàng một lần. Ghi cập nhật thanh toán, tác vụ chờ giao trong cùng giao dịch; tác vụ khóa đơn, tồn kho, rồi thử lại chính tác vụ nếu lỗi, không tạo mã thứ hai. Callback tạm lỗi có thể thử lại và truy vấn bổ sung; chuyển trang trình duyệt không thay kiểm chứng máy chủ.

7. Hai sự cố: thông báo trùng và tái tổ chức trước xác nhận

Tình huống 1: đã phát mã nhưng callback hết thời gian chờ rồi gửi lại

Yêu cầu đầu có thể đã commit, chỉ mất phản hồi trên đường. Lần hai khử trùng theo sự kiện, đọc trạng thái giao và trả kết quả đã xử lý; không lấy thêm tồn kho chỉ vì “yêu cầu này mới”. Đối chiếu thông báo, giao dịch đơn và bản ghi giao để phân biệt yêu cầu lặp với bỏ sót thật.

Tình huống 2: thấy chuyển tiền là phát mã, sau đó khối chứa giao dịch thay đổi

Giao dịch chưa xác nhận có thể chịu tái tổ chức chuỗi. Trình theo dõi phải kiểm tra khối chứa; tài liệu đăng ký sự kiện Geth nêu log Ethereum có thể mang cờ removed. Khi thay đổi, trở về theo dõi chờ xác nhận, quét lại kiểm chứng. Nếu đã giao trước khi đủ xác nhận, xử lý sự cố thủ công và giữ bằng chứng, không tự động trừ ngược từ ví người dùng.

8. Quy tắc riêng cho trả quá hạn, hết hàng và hoàn tiền

Đơn hết hạn không khiến địa chỉ ngừng nhận tiền. Khoản trả phát hiện sau hạn phải ghi chờ kiểm tra, không tự chuyển sang đơn mới. Trả thiếu, dư hoặc nhiều lần cho một đơn cũng xử lý theo thỏa thuận trước. Nếu giữ tồn kho hết hạn rồi tiền mới xác nhận, kiểm tra lại tồn kho để giao hoặc chuyển hoàn tiền thủ công.

Ghi riêng thanh toán xong và giao thành công. Đã xác nhận trả nhưng hết hàng thì giữ sự thật thu tiền, báo khách chờ xử lý, không đổi về “chưa trả”. Hoàn tiền là giao dịch on-chain mới từ ví đơn vị kinh doanh, cần duyệt riêng, kiểm tra mạng, địa chỉ, lưu phí và hash. Không tự hoàn về địa chỉ gửi vì địa chỉ chi hộ của sàn có thể không phải nơi khách trực tiếp nhận được.

9. Kiểm tra trước ra mắt: chạy thông nhánh lỗi rồi mới tăng giao dịch

  • Xác nhận ví nhận do đơn vị kinh doanh kiểm soát; hồ sơ tích hợp không chứa khóa riêng hay cụm khôi phục.
  • Thử riêng hợp đồng, độ chính xác, địa chỉ và chính sách xác nhận của TRC20, ERC20.
  • Bao gồm đơn cùng giá, sự kiện trùng, callback hết giờ, quét bù và tái tổ chức trước xác nhận.
  • Diễn tập trả quá hạn, thiếu dư, hết hàng, phát mã lỗi, đối soát và hoàn tiền thủ công.
  • Nhật ký truy được từ đơn tới sự kiện thanh toán và tác vụ giao, đồng thời che khóa và mã bí mật.

稳付pay hiện miễn phí giám sát và callback hai mạng trên cho quản trị website vừa, nhỏ; dịch vụ doanh nghiệp tính phí riêng. Trang quản trị đang phát triển, hiện có thể liên hệ cấu hình tích hợp. Tiền luôn do ví riêng của đơn vị kinh doanh nắm giữ; hoàn tất thống nhất chính sách xác nhận, giao thức callback và xử lý lỗi qua kiểm thử tích hợp trước vận hành.

Nguồn tham khảo và tài liệu kỹ thuật

Các nguồn chính thức sau dùng để kiểm tra giao thức và nguyên lý triển khai. Mã và tình huống trong bài nhằm giải thích kỹ thuật; phải kiểm chứng riêng môi trường cụ thể và giao thức tích hợp chính thức.

  1. TRON chính thức: vòng đời giao dịch và cố định khối
  2. TRON chính thức: tiêu chuẩn token TRC-20
  3. Ethereum chính thức: JSON-RPC, log và trạng thái khối
  4. Geth chính thức: log đăng ký và cờ removed khi tái tổ chức
  5. Stripe chính thức: chữ ký Webhook, sự kiện trùng và phản hồi
  6. PostgreSQL chính thức: ràng buộc duy nhất và khóa tổng hợp

Tiếp tục hoàn thiện website của bạn

Từ mạng, đơn hàng đến thông báo dòng tiền, xác nhận từng bước theo tình huống nghiệp vụ. Nhu cầu tích hợp thanh toán và giám sát USDT có thể trao đổi qua trang liên hệ.

Liên hệ 稳付pay ↗