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

Quy trình tích hợp nạp tiền qua Alipay: nạp vào website và ứng dụng, callback thanh toán và ghi sổ số dư

Nạp tiền qua Alipay nghĩa là người dùng dùng Alipay trả tiền để nạp vào website hoặc ứng dụng của bạn. Sau khi xác nhận kết quả thanh toán, 稳付pay gửi thông báo đơn tới máy chủ của bạn; hệ thống xác minh chữ ký và đối chiếu đơn rồi mới tăng số dư nội bộ cho đúng người dùng. Trọng tâm tích hợp là truy vết được giữa khoản thanh toán, thông báo và ghi sổ, đồng thời bảo đảm cùng khoản thanh toán không được nạp hai lần.

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

1. Phân biệt nạp tiền của người dùng, thu thanh toán và ghi sổ tài khoản

Người dùng nạp vào số dư trong hệ thống đơn vị kinh doanh, không nạp vào chính ví Alipay. 稳付pay phụ trách kênh thu hộ Alipay gốc đã mở, xác nhận kết quả thanh toán và thông báo; đơn vị kinh doanh quản lý tài khoản người dùng, sổ số dư, bản ghi chi tiêu và quy tắc hậu mãi.

Trang nạp cần giải thích mục đích dùng số dư, hạn dùng, số tiền tặng và điều kiện hoàn tiền. Ghi riêng tiền thực trả với 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 đều có bản ghi riêng; không xóa bản ghi nạp gốc để sửa sổ. Dịch vụ mô tả trong bài không có nghĩa đã mở rút tiền Alipay hoặc đổi USDT; API chi hộ độc lập hiện chưa mở.

2. Một lần nạp qua Alipay hoàn tất thế nào

  1. Người dùng gửi yêu cầu nạpMáy chủ gắn người dùng, xác định số tiền và lưu đơn nạp duy nhất.
  2. Tạo thanh toán AlipayGọi kênh đã mở, hiển thị thông tin thanh toán thực tế được trả về.
  3. Nền tảng xác nhận kết quả thu tiền稳付pay liên kết đơn gốc và xác nhận thanh toán thành công.
  4. Gửi thông báo đến máy chủGửi callback tiêu chuẩn đến notifyUrl được đơn vị kinh doanh cấu hình.
  5. Đơn vị kinh doanh xác minh chữ ký và đối chiếuKiểm tra chữ ký, đơn vị kinh doanh, đơn, số tiền, loại tiền và trạng thái thành công.
  6. Ghi có số dư nguyên tửLưu thanh toán, bản ghi nạp duy nhất và cập nhật số dư trong cùng giao dịch.
Thanh toán thành công và ghi có số dư nội bộ là hai sự kiện liền nhau nhưng độc lập; đơn vị kinh doanh phải hoàn thành ghi sổ tin cậy.

3. Cố định người nạp, số tiền và cấu hình kênh

Trước khi tạo đơn, lưu ID người dùng, mã đơn của đơn vị kinh doanh, số tiền, loại tiền và bản chụp quy tắc nạp. Đây là bản ghi nghiệp vụ riêng, không phải tham số API bổ sung. Tính số tiền phải trả từ dữ liệu đáng tin cậy ở máy chủ; không nhận trực tiếp giá bị sửa trên trình duyệt và không đổi người được nạp sau khi callback đến.

Theo Tài liệu tạo và truy vấn đơn thu hộ để điền các tham số mchId, wayCode, outTradeNo, amount, notifyUrl, reqTime và sign. amount tính bằng fen, ví dụ 1000 biểu thị 10.00 nhân dân tệ; reqTime dùng dấu thời gian mili giây hiện tại. Mã tổng hợp Alipay là 80001, chỉ dùng được khi đơn vị kinh doanh được cấp quyền và kênh thực tế được bật.

“Alipay gốc” là tên nghiệp vụ của một kênh hiện có trên website này. Đội kỹ thuật kiểm thử trang thanh toán cụ thể, yêu cầu thiết bị và tương tác tích hợp theo cấu hình; không cam kết mọi kênh đều hỗ trợ tất cả tình huống APP, H5 hoặc quét mã. Chỉ hiển thị đầu vào thanh toán thực tế được trả về và hợp lệ, không tự ghép địa chỉ trang thu ngân.

Sau khi vào trang thanh toán Alipay thực tế, người dùng cần kiểm tra bên nhận và số tiền phải trả hiển thị. Nếu không khớp đơn nạp hiện tại, tạm dừng thanh toán và liên hệ đơn vị kinh doanh để kiểm tra; không tự sửa số tiền rồi yêu cầu phía quản trị nhận khoản đó. Hướng dẫn thanh toán của đơn vị kinh doanh cũng cần nêu rõ cách liên kết đơn và đầu vào tra cứu để người dùng kiểm tra lại sau khi trả.

4. Xác minh callback theo giao thức 稳付pay

Theo Quy tắc chữ ký và Tài liệu callback để xử lý sign trong Body. Callback ưu tiên CALLBACK_SECRET, chỉ dùng MD5_SECRET nếu chưa cấu hình riêng; sắp xếp và ghép các trường thực tế không rỗng rồi tính MD5 chữ thường. Giữ nguyên chuỗi như 00, 10.00, không chuyển trước thành 0, 10 rồi xác minh chữ ký; khóa chỉ lưu ở máy chủ.

Sau khi chữ ký hợp lệ, kiểm tra đơn vị kinh doanh sở hữu, loại nghiệp vụ, đơn gốc, đơn nền tảng, số tiền fen và loại tiền, rồi xác nhận trạng thái thành công. Đơn không biết hoặc lệch số tiền không được tự cộng số dư; giữ bản ghi bất thường và liên hệ kỹ thuật kiểm tra. Chuyển trang thành công hoặc người dùng nhấn “đã trả tiền” chỉ được kích hoạt truy vấn tiến độ từ máy chủ của mình.

API tổng hợp trên website này khác giao thức kết nối trực tiếp chính thức của Alipay. Cách triển khai ký RSA2 trong SDK chính thức của Alipay không thay thế quy tắc MD5 ở đây; cũng không dùng ví dụ phản hồi success ở nơi khác làm quy trình xử lý trong bài này. Callback tiêu chuẩn 稳付pay khuyến nghị trả HTTP 200, văn bản thuần OK sau khi dữ liệu đã được lưu tin cậy.

5. Bảo vệ số dư tài khoản bằng bản ghi giao dịch duy nhất

Tạo ràng buộc duy nhất trong cơ sở dữ liệu cho bản ghi nạp, ví dụ “đơn vị kinh doanh + đơn nạp”. Đơn, bản ghi thanh toán, bản ghi nạp và thay đổi số dư cần commit trong cùng giao dịch, không cộng số dư trước rồi ghi riêng “đã xử lý”. Chỉ tắt nút trên trang hoặc kiểm tra tồn tại trước rồi ghi đều không chặn được thông báo đồng thời.

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

Đây là mã giả ghi sổ của đơn vị kinh doanh, không phải API bổ sung. Khi lỗi thì rollback, không xác nhận thành công trước; thông báo trùng đã xử lý tin cậy có thể trả OK sau khi kiểm tra. Khi tra cứu xác nhận thành công cũng gọi cùng hàm ghi sổ, để callback, thử lại và xử lý bù thủ công dùng chung một cơ chế chống trùng.

6. Khi hết thời gian chờ hoặc có thông báo trùng, tra cứu đơn gốc trước

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

Bản ghi giao dịch trong hóa đơn Alipay của người dùng, platformOrderNo do 稳付pay trả về và outTradeNo do đơn vị kinh doanh tạo thuộc các hệ thống khác nhau, không mặc định ba mã giống nhau. Máy chủ cần lưu liên kết; hỗ trợ khách hàng tìm đơn bằng mã gốc của đơn vị kinh doanh rồi kiểm tra bằng chứng thanh toán, không cộng tiền chỉ vì khớp đuôi hóa đơn, biệt danh hoặc số tiền.

Thông báo 稳付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ị amount trong phản hồi truy vấn khi mở dịch vụ rồi mới chuyển đổi so sánh, không coi trực tiếp là số tiền fen của yêu cầu tạo đơn. SDK chính thức của Alipay cũng cung cấp yêu cầu truy vấn giao dịch; ở đây chỉ tham khảo ý tưởng chủ động xác minh, còn lời gọi thực tế vẫn dùng API truy vấn thu hộ của 稳付pay.

7. Đối soát riêng khoản nạp của người dùng và quyết toán USDT của đơn vị kinh doanh

Số dư người dùng tăng nghĩa là hệ thống tài khoản của đơn vị kinh doanh đã ghi sổ; quyết toán USDT hoàn tất nghĩa là khoản tương ứng đã được chuyển đến địa chỉ nhận theo thỏa thuận. Hai lớp bản ghi không dùng chung một trạng thái “hoàn thành”.

Sau thu hộ qua kênh Alipay, 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 chờ xác nhận không được đổi khoản người dùng đã trả thành thất bại; số dư người dùng đã cộng 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 để liên kết từng đơn người dùng, bản ghi thanh toán, bảng quyết toán và bản ghi on-chain.

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

Đóng trang sau khi trả tiền thì còn nạp thành công được không?

Máy chủ có thể tiếp tục xử lý theo thông báo hợp lệ hoặc tra cứu, không phụ thuộc người dùng quay về trang; đơn vị kinh doanh cần triển khai ghi sổ tin cậy và xử lý bù.

Đã có nạp qua WeChat, có thể dùng chung số dư tài khoản không?

Có thể dùng chung sổ số dư trong hệ thống đơn vị kinh doanh, nhưng đơn phải giữ phương thức thanh toán và kênh gốc; cùng khoản thanh toán chỉ tạo một bản ghi nạp hợp lệ.

Chỉ đổi URL trong plugin Alipay có sẵn là tích hợp được không?

Kiểm tra trước các trường, chữ ký, callback và truy vấn có phù hợp không. Plugin kết nối trực tiếp chính thức không thể chỉ đổi gateway rồi coi là đã thích ứng với API tổng hợp; hãy nhờ đội kỹ thuật hỗ trợ kiểm thử tích hợp.

Trước vận hành, kiểm thử nạp bình thường, chữ ký sai, số tiền không khớp, thông báo trùng, thông báo và tra cứu đồng thời, rollback cơ sở dữ liệu và thanh toán đến muộn. Mỗi lần đối chiếu đơn, bản ghi duy nhất và số dư cuối cùng, bảo đảm đúng số tiền và chỉ cộng một lần. Tích hợp WeChat có thể tham khảo Nạp qua WeChat và ghi có số dư。

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 ↗