Phát triển thanh toán

Tích hợp thanh toán cho nền tảng bán mã: chữ ký, tính lũy đẳng, khóa tồn kho và giao hàng tự động

Bán mã tự động không phải cứ nhận chuỗi “thanh toán thành công” là gửi một mã. Quy trình tin cậy phải nối thông báo thanh toán đáng tin, trạng thái đơn, cấp tồn kho và tác vụ giao hàng, đồng thời chịu được thử lại mạng, tiến trình khởi động lại và sửa chữa thủ công. Bài này đưa ra thiết kế chung, độc lập nhà cung cấp; mọi trường dữ liệu, cách ký và nội dung phản hồi phải theo giao thức tích hợp thực tế, không dùng trực tiếp như tài liệu API của 稳付pay.

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

Tách thanh toán và giao hàng thành hai chiều trạng thái

Ít nhất phải phân biệt trạng thái trả tiền như chờ trả, đã trả, đã hoàn tiền với trạng thái giao hàng như chờ cấp, đã cấp, đã giao và lỗi giao hàng. Nếu không, khi khách đã trả nhưng thiếu tồn kho, hệ thống chỉ có thể chọn “thành công” hoặc “thất bại”, không giữ được sự thật ở bước trung gian.

  1. Tạo đơn hàngMáy chủ cố định sản phẩm, số tiền, tiền tệ và thời hạn
  2. Xác nhận thanh toánXác minh chữ ký, kiểm tra trường dữ liệu và lưu bền vững sự kiện đã trả tiền
  3. Cấp tồn khoKhóa đơn hàng và mã tương ứng trong giao dịch
  4. Thực hiện giao hàngTác vụ bền vững thử lại và giữ kết quả giao hàng
Trang quay về trên trình duyệt có thể hiển thị tiến độ; sự kiện đã thanh toán phải đến từ quy trình xác nhận máy chủ đáng tin.

Số lượng, giá và ưu đãi được tính trên máy chủ, không lấy thẳng số tiền cuối do trình duyệt gửi. Đơn giữ ảnh chụp giá lúc tạo; việc tăng giá sau đó không được thay đổi yêu cầu thanh toán đã tạo.

Xác minh chữ ký trước, rồi kiểm tra đơn vị kinh doanh, số tiền và quyền sở hữu nghiệp vụ

Callback được xử lý ở máy chủ, kiểm tra chữ ký, dữ liệu được ký, cửa sổ thời gian và khóa theo tài liệu thanh toán. Nếu nhà cung cấp yêu cầu thân yêu cầu gốc, phải giữ nguyên byte trước khi framework phân tích hoặc tuần tự hóa lại. Hướng dẫn Webhook của Stripe là một ví dụ cụ thể cho cơ chế này; không áp dụng nguyên xi các trường và header chữ ký của nó sang dịch vụ khác.

Chữ ký hợp lệ chỉ cho biết thông điệp tuân theo giao thức của khóa đó; vẫn phải kiểm tra danh tính đơn vị kinh doanh, đơn thuộc về ai, mã giao dịch, tiền tệ, số tiền thực và trạng thái thành công cuối cùng. So sánh số tiền bằng số nguyên theo đơn vị nhỏ nhất rõ ràng hoặc số thập phân cố định chính xác, không dùng phép xấp xỉ bằng nhau của số dấu phẩy động.

Với USDT còn phải kiểm tra mạng, địa chỉ nhận và định danh tài sản tương ứng, không chỉ tên hiển thị của token. URL return phía máy khách, ảnh thanh toán và lời khách nói không thay thế các kiểm tra này. Khóa phải ở máy chủ, không được đặt trong script của trang.

Khử trùng cần ràng buộc cơ sở dữ liệu, không chỉ “truy vấn trước”

Tình huống lỗi thứ nhất: Hai thông báo đến cùng lúc; hai tiến trình đều thấy đơn chưa giao nên mỗi tiến trình gửi một mã. Có khoảng đua giữa truy vấn và ghi, kể cả trên một máy. Khử trùng phải được bảo đảm bằng ràng buộc duy nhất và giao dịch trong cơ sở dữ liệu, không chỉ bằng cờ trong bộ nhớ.

Ít nhất cần khử trùng riêng sự kiện, giao dịch thanh toán và giao hàng nghiệp vụ. Cùng một khoản trả có thể sinh mã sự kiện khác nhau; chỉ mã sự kiện duy nhất vẫn có thể ghi nhận khoản trả hai lần. Gửi lại cùng sự kiện không được đẩy trạng thái thêm lần nữa. Thông báo trùng đã xử lý có thể được xác nhận theo giao thức sau khi kiểm tra bản ghi bền vững.

Dưới đây lần lượt là minh họa ràng buộc chung trong bảng thông báo, thanh toán, tác vụ giao hàng và cấp tồn kho, không phải script tạo hoàn chỉnh một bảng; cần thiết kế cả trường không rỗng, phạm vi và cú pháp thực tế. Tài liệu ràng buộc của PostgreSQL giải thích bảo đảm ở cấp cơ sở dữ liệu của ràng buộc duy nhất.

UNIQUE (provider, provider_event_id)
UNIQUE (provider, provider_transaction_id)
UNIQUE (order_id, fulfillment_kind)
UNIQUE (card_id)

Bảo vệ cấp tồn kho bằng giao dịch, tránh bán vượt đơn vị cuối cùng

Khi xử lý khoản trả thành công, khóa đơn tương ứng trong giao dịch rồi kiểm tra đã cấp tồn kho chưa. Dùng khóa hàng hoặc cập nhật nguyên tử có điều kiện trạng thái với mã chờ cấp, rồi commit bản ghi cấp và trạng thái đơn cùng nhau. Không gửi mã trước rồi mới thử đánh dấu đã bán trong cơ sở dữ liệu.

Nếu dùng so sánh rồi cập nhật theo cách CAS, điều kiện phải gồm “vẫn còn sẵn”, và kiểm tra đúng một hàng bị ảnh hưởng. Nếu không có hàng nào, chọn lại tồn kho hoặc chuyển sang quy trình hết hàng. Đơn nhiều sản phẩm cần quy tắc cấp toàn bộ rõ ràng, không vô ý chỉ giao một phần.

Giải thích khóa hàng của PostgreSQL trình bày cách phối hợp truy cập đồng thời. Giữ khóa trong thời gian ngắn nhất; không đặt việc gửi email hay gọi API cấp quyền bên ngoài vào giao dịch dài. Khi có deadlock hoặc xung đột có thể thử lại, thử lại toàn bộ giao dịch theo ngữ nghĩa cơ sở dữ liệu và duy trì tính lũy đẳng.

Nối cơ sở dữ liệu và giao hàng bên ngoài bằng Outbox

Giao dịch bảo đảm đơn và tồn kho cùng được lưu nhưng không khiến cơ sở dữ liệu và nhà cung cấp email tự nhiên cùng thành công. Giải pháp là ghi tác vụ chờ giao hàng bền vững, tức Outbox, trong cùng giao dịch commit dữ liệu nghiệp vụ; tiến trình tác vụ độc lập gửi thông báo và ghi kết quả sau đó.

# Generic flow; adapt to the actual provider protocol.
event = verify_provider_request(raw_request)
with database_transaction():
    persist_inbox_event_once(event)
    record_verified_payment_once(event)
    allocate_inventory_if_needed(event.order_id)
    persist_outbox_job_once(event.order_id)
return protocol_ack_after_commit()

Đây là sơ đồ quy trình, bỏ qua nhánh sự kiện trùng, xác minh thất bại và hết hàng. Nếu không còn hàng, lưu “đã trả, chờ xử lý” cùng tác vụ thủ công có kiểm soát, không tạo bản ghi đã giao giả. Khi lưu bền vững thất bại, không phản hồi đã nhận thành công trước; theo giao thức để bên gửi thử lại hoặc dùng truy vấn bù trừ rõ ràng.

Không cần đợi email gửi xong mới xác nhận nhận thành công, nhưng thông báo và tác vụ sau đó phải đã được lưu tin cậy. Nếu chỉ có hàng đợi trong bộ nhớ, phản hồi sớm rồi khởi động lại có thể làm mất vĩnh viễn công việc giao hàng.

Xử lý riêng hết hàng, trả muộn và thực thi lặp

Tình huống lỗi thứ hai: Đơn hết hạn đã giải phóng tồn kho nhưng thông báo khách trả tiền đến muộn. Bỏ qua đơn đã đóng sẽ để lại khoản đã trả chưa xử lý; dùng phân bổ cũ có thể gửi mã đã bán cho người thứ hai. Ghi nhận việc trả tiền, kiểm tra lại tồn kho và quy tắc đơn, rồi chuyển sang bổ sung hàng, thực hiện thủ công hoặc hoàn tiền.

Tiến trình tác vụ có thể sập sau khi giao bên ngoài xong nhưng trước khi ghi thành công. Khi thử lại vẫn dùng cùng mã giao hàng; ưu tiên khóa lũy đẳng hoặc truy vấn kết quả nếu hệ thống ngoài hỗ trợ. Nếu không hỗ trợ, phải có kiểm tra và nhánh thủ công, không được tuyên bố chỉ hàng đợi cục bộ đã bảo đảm thao tác ngoài tuyệt đối không lặp.

Có thể hiển thị lại cùng mã đã cấp qua kênh có kiểm soát cho khách của đơn gốc, nhưng không tiêu thêm tồn kho. Gửi lại email và giao hàng lại là hai thao tác khác nhau, cần tách quyền và nhật ký kiểm toán trong trang quản trị.

Giữ đầy đủ lịch sử hoàn tiền và đối soát, không xóa bản ghi thanh toán

Hoàn tiền là sự kiện nghiệp vụ riêng, có thể đang yêu cầu, thành công, thất bại hoặc hoàn một phần. Không biểu diễn hoàn tiền bằng xóa đơn hay đổi thẳng về chưa trả. Ghi giao dịch gốc, mã liên kết hoàn tiền, số tiền, người thao tác và đối chiếu kết quả cuối từ bên thanh toán.

Việc hàng số đã được xem hay đổi mã ảnh hưởng hậu mãi, nhưng không cho phép tùy ý hoàn tiền tự động hay nhập lại kho. Mã không thể thu hồi không được đưa lại vào kho bán sau hoàn tiền; với quyền có thể thu hồi, cũng phải xác nhận thu hồi xong trước khi quyết định bước tiếp.

Định kỳ so sánh bản ghi thanh toán và đơn đã trả tại hệ thống, tìm khoản thiếu cục bộ, sai số tiền, đã trả chưa giao và hoàn tiền chưa xong. Thông báo giám sát on-chain cũng phải gắn với đơn nghiệp vụ duy nhất, không đoán bằng khoản chuyển cùng số tiền. Điều kiện xác nhận và giao dịch đặc biệt cần được thỏa thuận lúc tích hợp.

Nghiệm thu theo danh sách sự cố trước khi ra mắt, làm rõ ranh giới API

  • Thông báo giả, chữ ký sai, đơn vị kinh doanh sai và số tiền sai đều không được kích hoạt giao hàng.
  • Gửi lại cùng sự kiện hay các sự kiện khác cùng giao dịch đều không được cấp hàng lặp.
  • Khi nhiều người mua đơn vị tồn kho cuối cùng, chỉ có một bản ghi cấp hợp lệ.
  • Commit giao dịch thất bại thì không phản hồi thành công; sau commit, tiến trình khởi động lại vẫn xử lý tiếp được.
  • Email hết thời gian chờ, tác vụ gián đoạn và kết quả API ngoài chưa rõ đều có nơi kiểm tra.
  • Hết hàng, trả muộn, hoàn tiền và giao bổ sung thủ công đều có trạng thái truy vết.

Trang quản trị đơn vị kinh doanh của 稳付pay đang phát triển; dịch vụ giám sát và callback đã mở. USDT hiện hỗ trợ Tron (TRC20) và Ethereum (ERC20), tiền vào thẳng địa chỉ riêng của đơn vị kinh doanh; thông báo nghiệp vụ ở mức giây được gửi sau khi đủ điều kiện xác nhận on-chain đã cấu hình, không có nghĩa xác nhận khối chỉ mất vài giây.

Bài này không cung cấp URL API thực, header chữ ký hay quy trình lấy khóa của 稳付pay. Khi chuẩn bị tích hợp, hãy liên hệ xác nhận giao thức thực tế, rồi dựa vào đó triển khai kiểm chứng yêu cầu, phản hồi và quy tắc bổ sung đơn; hoàn tất kiểm thử trước khi đưa vào 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. Stripe: xác minh Webhook và sự kiện trùng
  2. PostgreSQL: ràng buộc cơ sở dữ liệu
  3. PostgreSQL: khóa tường minh và khóa hàng
  4. PostgreSQL: tính nguyên tử của giao dịch
  5. OWASP: xác minh dữ liệu nghiệp vụ giao dịch

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 ↗