Khi triển khai các trang blog cá nhân, website tổ chức phi lợi nhuận (NGO) hoặc trang cộng đồng trên Drupal, nhu cầu nhận tiền ủng hộ (donation) qua thẻ tín dụng là rất phổ biến. Tuy nhiên, giải pháp mặc định trong hệ sinh thái Drupal thường là cài đặt bộ Drupal Commerce.

Drupal Commerce là một nền tảng thương mại điện tử xuất sắc, nhưng nếu use case chỉ đơn giản là "người đọc muốn gửi tặng $5 ủng hộ tác giả", việc kéo theo toàn bộ hệ sinh thái commerce là một sự đánh đổi lớn về mặt kiến trúc và chi phí bảo trì.

Image

• Domain Complexity: Đưa vào abstraction của Store, Order, Order Item, Cart, Customer Profile... tạo ra nhiều domain complexity hơn mức use case thực sự cần.
• PCI DSS Compliance: Việc tự xử lý form nhập thẻ trên website đòi hỏi các tiêu chuẩn bảo mật khắt khe.
• Asynchronous Reliability: Các giao dịch thanh toán bất đồng bộ dễ gặp lỗi trùng lặp trạng thái (duplicate state) nếu không có cơ chế xử lý Webhook an toàn và Idempotency.

Thiết kế một module hoàn toàn độc lập, tách rời logic khỏi giỏ hàng/đơn hàng:

• Offload Payment UI: Sử dụng Stripe-hosted Checkout giúp giảm đáng kể phạm vi trách nhiệm PCI DSS của ứng dụng Drupal, vì thông tin thẻ được nhập và xử lý trên giao diện thanh toán do Stripe cung cấp.
• Event-driven & Idempotency: Xây dựng một webhook endpoint chuyên dụng để xử lý luồng bất đồng bộ từ Stripe, đảm bảo tính toàn vẹn dữ liệu.
• Drupal Native Integration: Sử dụng Block API và Form API của Drupal Core để cung cấp UI linh hoạt cho quản trị viên.

Thay vì tự quản lý state của giao dịch trên giao diện, module đóng vai trò là một cầu nối (integration layer) giữa người dùng và Stripe.

[ User on Drupal Site ]
      │
      ▼
[ Drupal Controller / Service ]
      │
      ▼
[ Stripe Hosted Checkout ]
      │
      ▼
[ Stripe Server ]
      │
      │ Webhook
      ▼
[ Drupal Webhook Endpoint ]
      │
      ├── Idempotency
      ├── Store Donation
      └── Dispatch Event

Kiến trúc này cho thấy rõ sự phân tách trách nhiệm: Drupal lo business logic nội bộ, Stripe lo UI thanh toán và bảo mật thẻ, hai bên giao tiếp qua Webhook tin cậy.

• Tinh gọn hệ thống: Loại bỏ dependency vào Drupal Commerce đối với use case donation một lần.
• Bảo mật: Thông tin thẻ không được xử lý hoặc lưu trữ trên Drupal; quá trình thanh toán được thực hiện hoàn toàn trên Stripe Checkout.
• Mã nguồn mở: Module được phát hành theo giấy phép GPL-2.0-or-later, sẵn sàng tích hợp vào bất kỳ dự án Drupal 10/11 nào.

• Let Stripe own the payment UI; let Drupal own the business integration. Việc không cố gắng sở hữu những domain phức tạp (như xử lý thẻ tín dụng) giúp codebase nhẹ nhàng và đáng tin cậy hơn.
• Design for evolution: Việc phát một custom event sau khi lưu transaction thành công giúp module dễ dàng mở rộng sau này (ví dụ: gửi mail, bắn log sang CRM) mà không cần sửa core logic.
•  

Technical Deep Dive Tôi viết riêng một bài phân tích sâu hơn về kiến trúc và lý do tại sao tôi chọn xây dựng một module donation độc lập thay vì sử dụng Drupal Commerce. Đọc thêm tại: Tại sao tôi không dùng Drupal Commerce chỉ để làm tính năng Donation?.