Tích hợp nạp tiền

Quy trình tích hợp nạp tiền qua WeChat: người dùng nạp, xác nhận thanh toán và ghi có số dư

“Nạp tiền qua WeChat” ở đây là người dùng thanh toán bằng WeChat để nạp vào website hoặc ứng dụng của bạn: 稳付pay xác nhận kết quả rồi thông báo đến máy chủ của bạn; hệ thống của bạn xác minh thông báo và tăng số dư nội bộ cho đúng người dùng. Xác nhận thanh toán và ghi sổ số dư có trách nhiệm riêng; khi tích hợp cần kết nối thành quy trình đầy đủ có thể đối chiếu, thử lại và không nạp trùng.

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

1. Làm rõ tiền được nạp vào đâu và ai ghi sổ

Người dùng mua khoản nạp trong website hoặc ứng dụng của bạn, không nạp vào chính ví WeChat. 稳付pay chịu trách nhiệm kết nối kênh WeChat đã mở, xác nhận kết quả trả tiền và gửi thông báo đơn; đơn vị kinh doanh quản lý tài khoản người dùng, sổ giao dịch số dư và quy tắc chi tiêu tiếp theo.

Trang nạp cần nêu rõ số dư có thể dùng cho những gì, hạn dùng và quy tắc hậu mãi. Nếu có tiền tặng, ghi riêng tiền thực trả và phần tặng; không suy ngược số tiền thanh toán từ số dư cuối cùng được cộng. Chi tiêu, hoàn tiền và điều chỉnh thủ công cũng phải tạo bản ghi riêng, giữ lý do cùng đơn liên quan; không xóa bản ghi nạp gốc để sửa sổ.

Mỗi lần nạp phải truy được từ tài khoản người dùng đến đơn của đơn vị kinh doanh rồi đến bản ghi thanh toán nền tảng. Không gán số dư chỉ theo biệt danh, ảnh chụp hay khoản trả cùng số tiền, cũng không coi “đã tạo đơn” là “đã nạp thành công”. Bài này không có nghĩa đã cung cấp rút tiền WeChat hoặc đổi USDT; API chi hộ độc lập hiện chưa mở.

2. Sáu bước của một lần nạp qua WeChat

  1. Người dùng bắt đầu nạpChọn số tiền, máy chủ đơn vị kinh doanh gắn người dùng và tạo đơn nạp duy nhất.
  2. Hiển thị đầu vào thanh toán WeChatMáy chủ gọi kênh đã mở và hiển thị thông tin thanh toán thực tế được trả về.
  3. 稳付pay xác nhận thanh toánLiên kết đơn gốc và xác minh kết quả trả tiền thành công.
  4. Gửi callback đến máy chủGửi thông báo thanh toán tiêu chuẩn đến địa chỉ đã cấu hình của đơn vị kinh doanh.
  5. Đơn vị kinh doanh xác minh chữ ký và kiểm traXác minh chữ ký, đơn vị kinh doanh, đơn, số tiền, loại tiền và trạng thái thành công.
  6. Cộng số dư người dùng nguyên tửTrong cùng giao dịch, lưu thanh toán, bản ghi số dư duy nhất và cập nhật số dư, rồi mới xác nhận thông báo.
Người dùng nhìn thấy trang trả tiền chỉ là một phần quy trình; ghi có số dư phải dựa vào việc máy chủ đơn vị kinh doanh ghi sổ tin cậy.

3. Cố định người dùng và số tiền phải trả trước khi tạo đơn

Lưu đơn nạp nội bộ trước, ghi ID người dùng, mã đơn của đơn vị kinh doanh, số tiền phải trả, loại tiền và bản chụp quy tắc nạp. Đây là dữ liệu nghiệp vụ riêng của đơn vị kinh doanh, không có nghĩa API nhận thêm tham số cùng tên. Số tiền do máy chủ tính; không để giao diện sửa giá hoặc dùng callback chỉ định lại người được nạp.

Theo Tài liệu tạo đơn thu hộ để truyền mã đơn vị kinh doanh, mã kênh đã mở, mã đơn, số tiền, địa chỉ thông báo, dấu thời gian mili giây hiện tại và chữ ký. Số tiền tạo đơn tính bằng fen, ví dụ 1000 biểu thị 10.00 nhân dân tệ. Mã tổng hợp WeChat là 90001, nhưng có sử dụng được hay không phụ thuộc quyền của đơn vị kinh doanh và cấu hình thực tế.

Đội kỹ thuật xác nhận khi tích hợp cách hiển thị, giới hạn thiết bị và các bước thao tác của kênh mã cá nhân WeChat và kênh gốc; không tự dựng đầu vào thanh toán. Tài liệu chính thức WeChat Mô tả sản phẩm Native giúp hiểu thuật ngữ quét mã, nhưng không được dùng giao thức tổng hợp MD5 của 稳付pay như API chính thức của WeChat.

4. Nhận callback: xác minh trước rồi chuẩn bị ghi có

Theo Tài liệu callback tiêu chuẩn để xác minh sign trong Body: ưu tiên CALLBACK_SECRET đã cấu hình, chỉ dùng MD5_SECRET nếu chưa cấu hình riêng. Giữ nguyên giá trị thông báo trước khi xác minh chữ ký, không chuyển 00 thành 0 hay 10.00 thành 10 trước; khóa chỉ đặt ở máy chủ.

Chữ ký hợp lệ vẫn cần kiểm tra mã đơn vị kinh doanh, loại nghiệp vụ, mã đơn gốc, mã đơn nền tảng, số tiền và loại tiền, đồng thời xác nhận trạng thái thành công. amount trong callback tính bằng fen và phải bằng số tiền phải trả nội bộ. Người dùng được xác định từ đơn gốc đã lưu, không thay bằng giá trị bổ sung tùy ý trong thông báo.

Đơn không biết, lệch số tiền hoặc xung đột trạng thái cần được ghi nhận và liên hệ kỹ thuật để xác minh, không tự cộng số dư. Trình duyệt trả thành công hoặc người dùng nhấn “đã trả tiền” chỉ có thể khiến giao diện hỏi máy chủ của mình về tiến độ nạp.

5. Bản ghi giao dịch duy nhất và cập nhật số dư phải commit cùng nhau

Đặt ràng buộc duy nhất trong cơ sở dữ liệu cho bản ghi nạp, ví dụ dùng “đơn vị kinh doanh + đơn nạp” làm khóa nghiệp vụ duy nhất; cập nhật đơn, bản ghi giao dịch và số dư người dùng trong cùng giao dịch. Kiểm tra có chưa rồi mới ghi không ngăn được hai callback đồng thời.

Xác minh thông báo thanh toán và kiểm tra đơn gốc
Bắt đầu giao dịch cơ sở dữ liệu
  Khóa đơn nạp và bản ghi tài khoản liên quan
  Nếu đơn đã có bản ghi nạp thành công: không cộng số dư nữa
  Nếu chưa: lưu bản ghi duy nhất, tăng số dư đúng người dùng và cập nhật trạng thái nạp
Commit giao dịch
Trả về HTTP 200, văn bản thuần OK

Trên đây là mã giả ghi sổ của đơn vị kinh doanh, không phải API mới của 稳付pay. Nếu cơ sở dữ liệu lỗi thì rollback, không phản hồi thành công trước. Thông báo trùng đã xác nhận xử lý có thể trả OK; sổ số dư, bản ghi thanh toán và cập nhật tài khoản phải luôn nhất quán. Tra cứu bù cũng gọi cùng hàm này, không viết nhánh cộng tiền khác bỏ qua kiểm tra lũy đẳng.

6. Xử lý hết thời gian chờ, thông báo trùng và thanh toán đến muộn

Tình huốngCách xử lý đúng
Yêu cầu tạo đơn hết thời gian chờTra cứu bằng mã đơn gốc, không đổi thẳng mã rồi nạp lại.
Đã trả tiền nhưng số dư chưa tăngKiểm tra thanh toán, xử lý callback và bản ghi nội bộ; không cộng tiền trực tiếp theo ảnh chụp.
Callback trùng hoặc truy vấn đồng thờiThống nhất đi vào giao dịch ghi sổ được ràng buộc bản ghi duy nhất bảo vệ.
Nhận thanh toán hợp lệ sau khi đơn hết hạnLưu sự kiện thanh toán, ghi có bổ sung hoặc xử lý hoàn tiền theo thỏa thuận, không bỏ qua.

Thông báo tiêu chuẩn 稳付pay tối đa tổng cộng 3 lần, gồm lần đầu; sau hai lần đầu thất bại, thử lại sau khoảng 60 giây và 300 giây, nên vẫn cần chủ động tra cứu bù. Xác nhận đơn vị số tiền trong phản hồi truy vấn khi mở dịch vụ rồi mới quy đổi so sánh. Hướng dẫn chính thức WeChat Hướng dẫn callback và tra cứu cũng nhấn mạnh thông báo có thể chậm hoặc thiếu, máy chủ vẫn phải xác minh sau khi trang quay về; bài này không sao chép trường API hay quy tắc phản hồi của họ.

7. Kiểm tra riêng số dư người dùng và quyết toán USDT của đơn vị kinh doanh

“Người dùng nạp thành công” nghĩa là số dư của người dùng trong hệ thống đơn vị kinh doanh được cộng đúng; “đơn vị kinh doanh đã quyết toán” nghĩa là khoản liên quan đã được thanh toán cho đơn vị kinh doanh theo thỏa thuận. Đây không phải cùng một số dư tài khoản hay một trạng thái.

Sau thu hộ qua kênh có thể quyết toán USDT T0 theo thời gian thực theo thỏa thuận hai bên; mạng, địa chỉ, quy đổi và phí được xác nhận riêng. Quyết toán còn xác nhận không phải lý do đổi khoản người dùng đã trả thành thất bại; người dùng đã được cộng số dư cũng không có nghĩa ví đơn vị kinh doanh đã nhận USDT. Xem chi tiết tại Toàn bộ quy trình quyết toán cho đơn vị kinh doanh。

8. Câu hỏi thường gặp và nghiệm thu trước vận hành

Người dùng đóng trang rồi còn được ghi có khoản nạp không?

Có thể tiếp tục xử lý theo kết quả máy chủ, không cần người dùng quay về trang. Đơn vị kinh doanh phải nhận thông báo đúng cách và thực hiện tra cứu bù.

Callback trùng có cộng số dư hai lần không?

Nếu triển khai đúng bản ghi nạp duy nhất và giao dịch nguyên tử, cùng khoản thanh toán chỉ ghi có một lần; chỉ vô hiệu hóa nút trên trang không ngăn được ghi sổ trùng đồng thời.

Bắt đầu tích hợp 稳付pay thế nào?

Liên hệ đội kỹ thuật, trình bày website hoặc ứng dụng, quy tắc nạp và nhu cầu thanh toán, xác nhận kênh cùng cấu hình đơn vị kinh doanh rồi kiểm thử tích hợp theo tài liệu phát triển.

Trước vận hành, ít nhất xác minh nạp bình thường, thông báo trùng, thông báo và truy vấn đồng thời, rollback khi cơ sở dữ liệu lỗi, đóng trang và thanh toán đến muộn. Mỗi kiểm thử đều phải đối chiếu đơn, bản ghi thanh toán, sổ số dư và số dư cuối cùng, bảo đảm đúng số tiền và chỉ cộng một lần.

Nguồn tham khảo

Tài liệu chính thức dùng để kiểm tra thuật ngữ thông báo thanh toán và quét mã; trường API, chữ ký và phản hồi thông báo của 稳付pay theo tài liệu phát triển trên website này cùng cấu hình 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 ↗