Tích hợp WeChat H5: mở thanh toán, kiểm tra đơn và cộng số dư
WeChat H5 bắt đầu trên website trong trình duyệt điện thoại rồi mở trang thanh toán WeChat. Tích hợp hoàn chỉnh nối chuyển trang với xác nhận tiền trên máy chủ và sổ số dư. Bài viết giải thích luồng chính thức; khi dùng 稳付pay, kỹ thuật phải xác nhận khả năng H5, quyền thương nhân và API áp dụng.
Đọc tiếp theo chủ đề
1. Phân biệt H5, trang trong WeChat và thanh toán APP
H5 chính thức dành cho trang web trên trình duyệt điện thoại nằm ngoài trình duyệt tích hợp của WeChat. Trang bên trong WeChat thường dùng JSAPI, còn ứng dụng gốc dùng APP. Nhúng trang web vào ứng dụng không biến nó thành tình huống H5 được hỗ trợ. Liên kết tham khảo thứ hai là hướng dẫn APP: OpenSDK, sendReq và onResp thuộc phương thức riêng đó.
Thương nhân tích hợp trực tiếp phải đáp ứng điều kiện chủ thể, có quyền H5, liên kết mã thương nhân với APPID và cấu hình tên miền H5. Xem yêu cầu chính thức hiện hành. Nếu dùng 稳付pay, cung cấp tên miền, nội dung kinh doanh và môi trường mở trang để kỹ thuật xác nhận kênh được cấp có hỗ trợ H5 không. Xuất bản bài này không có nghĩa H5 đã được mở cho mọi thương nhân.
Không chọn giao thức chỉ từ tên trình duyệt hay cho rằng mọi kênh WeChat nguyên bản đều có cùng khả năng H5. Xác định môi trường, quyền và kênh trước khi triển khai.
2. Tích hợp 稳付pay: từ cấp kênh đến vận hành
Bước 1: liên hệ @tonyyyds, cung cấp tên miền, lĩnh vực, môi trường trình duyệt hoặc ứng dụng, luồng nạp tiền hay đăng ký, lượng đơn và nhu cầu quyết toán USDT. Kỹ thuật xác nhận H5, kênh, phí, quy tắc quyết toán và cách thử. Tên kênh không có nghĩa đã được kích hoạt.
Bước 2: nhận gateway thực tế, mchId, wayCode được cấp và khóa phía máy chủ. Chuẩn bị notifyUrl công khai cùng bảng đơn nội bộ; giữ khóa ở backend. Mã tổng hợp minh họa là 90001 cho WeChat và 80001 cho Alipay, chỉ dùng khi được cấp quyền; cũng có thể được chỉ định mã kênh riêng.
Bước 3: lưu outTradeNo duy nhất và giá tin cậy, rồi backend gửi JSON tới POST /api/pay/collect/create. amount là số nguyên fen CNY, 1000 tương đương 10 CNY. reqTime phải là thời gian Unix hiện tại tính bằng mili giây dạng số nguyên; sign tạo theo quy tắc MD5 trong tài liệu. Ví dụ bên dưới là các trường cho phương thức này, cần thay giá trị giữ chỗ và ký trên máy chủ.
{
"mchId": "YOUR_MERCHANT_ID",
"wayCode": "90001",
"outTradeNo": "YOUR_UNIQUE_ORDER_NO",
"amount": 1000,
"currencyCode": "CNY",
"notifyUrl": "https://merchant.example.com/pay/notify",
"subject": "WENFUPAY_H5_DEMO",
"reqTime": "CURRENT_UNIX_MILLISECONDS",
"sign": "GENERATE_MD5_ON_SERVER"
}Bước 4: lưu mã đơn nền tảng và chỉ hiển thị hoặc chuyển tới payUrl hợp lệ được trả về theo phương án thống nhất. Không tự ghép URL thanh toán. code=0 là yêu cầu được tiếp nhận, chưa phải tiền đã trả nên không cộng số dư. Khả năng mở ứng dụng trực tiếp phụ thuộc thử nghiệm kênh và trình duyệt.
Bước 5: nhận thông báo JSON thống nhất của 稳付pay, xác thực chữ ký và đối chiếu thương nhân, đơn, tiền, tiền tệ trước khi ghi nhận một lần. Sau khi lưu bền vững, trả HTTP 200 với văn bản thuần OK. Nếu thiếu callback hoặc chưa rõ kết quả tạo đơn, backend kiểm tra đơn gốc qua GET /api/pay/collect/query. Xác nhận đơn vị số tiền truy vấn khi tích hợp.
Bước 6: theo bố trí của kỹ thuật, thử thanh toán, hủy, hết thời gian, callback lặp và cập nhật số dư; đối soát các đơn thật đầu tiên rồi tăng lưu lượng dần. Các liên kết dưới dẫn tới tư vấn và tài liệu đầy đủ.
Liên hệ 稳付pay · Quy trình tích hợp · Tạo và truy vấn đơn · Quy tắc chữ ký · Callback thanh toán
3. Lợi thế kênh và hỗ trợ của 稳付pay
Nhiều lựa chọn: hiện có thu hộ mã cá nhân WeChat, WeChat nguyên bản và Alipay nguyên bản, cùng tích hợp tổng hợp. Thương nhân chọn phương thức phù hợp để giảm công việc nối riêng từng kênh. H5 vẫn phụ thuộc kênh đã mở. Hiệu suất hiện tại ổn định nhưng kết quả phụ thuộc đơn, môi trường người dùng và trạng thái kênh; không cam kết tỷ lệ thành công cố định.
Thống nhất đơn và callback: dùng điểm thanh toán trả về cùng quy trình tạo đơn, truy vấn và thông báo JSON để nối nạp tiền, hội viên, giao mã hoặc đơn TG bot vào hệ thống riêng. Nền tảng thông báo trạng thái tiền; thương nhân cập nhật số dư và quyền từ kết quả đã xác minh. Nhận callback không đồng nghĩa mọi thao tác nghiệp vụ đã tự hoàn tất.
Quyết toán USDT thời gian thực T0: sau khi xác nhận khách trả tiền, có thể quyết toán USDT theo thỏa thuận. Khi mở dịch vụ cần xác nhận số tiền đủ điều kiện, phí, cách quy đổi, mạng và địa chỉ. Xử lý và tiền đến trên chuỗi vẫn có điều kiện và xác nhận, không có nghĩa miễn phí, không cần xác nhận hay mọi đơn luôn đến ngay.
Hỗ trợ kỹ thuật: đội ngũ giúp xác nhận cấu hình thương nhân, kênh, chữ ký, truy vấn và lỗi thông báo. Thu hộ WeChat hoặc Alipay rồi quyết toán USDT khác với giám sát USDT tại địa chỉ thương nhân. Ở dịch vụ sau, khách chuyển thẳng vào ví thương nhân, 稳付pay giám sát xác nhận và gửi callback; không gộp hai luồng tiền thành một.
4. Phân biệt tham số H5 chính thức và liên kết 稳付pay
Backend tạo đơn nội bộ gắn với người dùng đã đăng nhập, sản phẩm hoặc gói nạp, số tiền và tiền tệ dự kiến. Giá lấy từ máy chủ, không tin giá trình duyệt gửi lên. Với API v3 trực tiếp, gọi POST /v3/pay/transactions/h5 bằng out_trade_no duy nhất và trường bắt buộc như notify_url, amount, scene_info. amount.total là số nguyên tính bằng fen CNY: 10 CNY ghi 1000. Khóa riêng và ký yêu cầu nằm trên máy chủ. Kênh 稳付pay dùng trường, đơn vị và quy tắc ký theo tài liệu thực tế, không chép nguyên giao thức chính thức.
Từ trang thuộc tên miền H5 đã cấu hình, chuyển đến h5_url nhận được. Để chọn trang quay lại, thêm redirect_url dưới dạng tham số truy vấn, giữ nguyên tham số thanh toán và mã hóa URL quay lại đúng một lần. Tên miền quay lại cũng phải được cấu hình cho H5. Tránh mã hóa hai lần khi dùng thư viện dựng URL. redirect_url đưa trình duyệt về website; notify_url nhận thông báo giữa máy chủ, không thay thế nhau.
Theo hướng dẫn H5 chính thức, h5_url có hiệu lực năm phút, khác hạn thanh toán của đơn. Khi liên kết hết hạn, kiểm tra đơn trước; nếu còn được trả thì lấy liên kết mới bằng tham số ban đầu theo tài liệu. Khi quá hạn nghiệp vụ, truy vấn rồi đóng hoặc tạo lại theo quy tắc API. Đồng hồ đếm ngược trên trang không chứng minh thanh toán thất bại.
5. Xác minh tiền trước callback và cộng số dư
Khách hoàn tất hoặc hủy đều có thể về cùng trang. Đến redirect_url, thông báo thành công hoặc ảnh thanh toán chưa đủ để cộng tiền. Thêm nút kiểm tra kết quả để backend truy vấn đơn mà người dùng có quyền xem, rồi hiển thị kết quả xác minh hoặc chờ xác nhận. Không cộng từ số tiền hay cờ success trong URL quay lại.
API v3 chính thức cần xác thực thông báo và giải mã đúng quy định. Thương nhân 稳付pay làm theo tài liệu callback thực tế. Cả hai đối chiếu bên nhận, mã đơn, mã giao dịch, số tiền và tiền tệ dự kiến. Truy vấn và callback đi vào cùng bộ xử lý trạng thái; kết quả chưa trả đến muộn không ghi đè trạng thái đã trả.
Với nạp tiền, tạo bản ghi cộng tiền duy nhất cho đơn và cập nhật đơn cùng sổ số dư trong một giao dịch cơ sở dữ liệu. Callback lặp, kiểm tra nhiều lần hay tải lại trang không được cộng thêm. Kích hoạt hội viên và giao hàng cũng cần chống lặp. Nếu đã nhận tiền nhưng cấp quyền lỗi, giữ tác vụ thử lại thay vì đòi trả thêm. Phản hồi theo quy định API sau khi lưu thông báo bền vững.
6. Nghiệm thu lỗi mở ứng dụng và tiền chậm cập nhật
Khi không mở WeChat được, lưu mã đơn, thời gian, hệ điều hành, trình duyệt, môi trường thực tế, lỗi và mã yêu cầu đã che dữ liệu nhạy cảm. Kiểm tra quyền H5, tên miền, hạn liên kết, chuỗi chuyển hướng và quyền mở WeChat. Không giả nguồn hoặc vượt kiểm tra tên miền, cũng không hứa mọi trình duyệt đều tự mở được.
Nếu trang quay lại trắng, kiểm tra mã hóa redirect_url, tên miền, định tuyến và khôi phục đăng nhập. Tiền đã xác nhận nhưng số dư chưa đổi thì lần theo giao dịch, xác thực callback, trạng thái đơn và sổ cộng tiền. Có thể truy vấn bù khi thiếu callback, nhưng không tự tạo lại đơn đã trả. Che nhật ký, không đưa liên kết thanh toán hay khóa vào trang hoặc phiếu hỗ trợ công khai.
Kiểm thử thành công, hủy, hết hạn, đóng trang, callback chậm hoặc lặp, truy vấn đồng thời và phục hồi sau lỗi ghi số dư. Mỗi đơn chỉ cộng một lần và truy vết được từ thanh toán đến sổ. 稳付pay hỗ trợ xác nhận tích hợp; phí, phạm vi kênh và điều kiện quyết toán USDT thỏa thuận riêng. Mở trang thanh toán không chứng minh đã trả tiền hay quyết toán.
Câu hỏi thường gặp
H5 bỏ yêu cầu tư cách thương nhân và tên miền không?
Không. H5 chính thức cần điều kiện chủ thể, quyền sản phẩm và tên miền đã cấu hình. Với 稳付pay, kỹ thuật kiểm tra kinh doanh, tên miền, tình huống và tham số. Tích hợp tổng hợp không miễn xét duyệt hay vượt quy tắc WeChat.
Khách bấm hoàn tất nhưng chưa có callback thì cộng luôn không?
Không dựa riêng thao tác đó. Backend xác minh kết quả, bên nhận, số tiền và tiền tệ rồi dùng cùng luồng chống cộng lặp. Nếu chưa xác nhận được, hiển thị chờ kiểm tra và dùng mã đơn đối chiếu để tránh trả lần hai.
Tài liệu tham khảo
- WeChat Pay: mở thanh toán H5
- WeChat Pay: hướng dẫn APP, phương thức tích hợp riêng
- WeChat Pay: tổng quan thanh toán H5
- WeChat Pay: chuẩn bị tích hợp H5
- WeChat Pay: hướng dẫn phát triển H5
- WeChat Pay: tham số tạo đơn H5
- Tạo và tra cứu đơn thu hộ: trường, số tiền và trạng thái đơn
- Quy tắc ký yêu cầu: sắp xếp tham số và tính MD5
- Các kênh thanh toán hiện có của 稳付pay: mã cá nhân WeChat, WeChat gốc, Alipay gốc và quyết toán USDT T0 theo thời gian thực