PayBridge — Câu chuyện phát triển

CLIENT

Về khách hàng

Nhà cung cấp dịch vụ thanh toán dẫn đầu thị trường thanh toán trung gian tại Nhật.

Nhà cung cấp dịch vụ thanh toán là một dịch vụ B2B cung cấp năng lực thanh toán cho các doanh nghiệp bán hàng EC tại Nhật. Các nhà bán này dùng nhiều nền tảng EC khác nhau (SFCC / EC-CUBE 2.x / EC-CUBE 4.x), mỗi nền tảng cần một plugin thanh toán phát triển và bảo trì riêng.

Với mục tiêu “cung cấp cùng một năng lực thanh toán một cách thống nhất, bất kể nền tảng EC nào,” chúng tôi tự xây dựng nền tảng plugin thanh toán chung. Khác biệt giữa các nền tảng được hấp thụ bởi một lớp UI mỏng, còn logic thanh toán, xử lý Webhook, token hóa và 3DS được triển khai trong một lõi dùng chung.

Nền tảng EC hỗ trợ

3 Nền tảng (SFCC + EC-CUBE 2/4)

Phương thức thanh toán hỗ trợ

5+ loại

Tuân thủ bảo mật

3DS + PCI-DSS

BUSINESS FLOW

STEP

Onboarding nhà bán

Cài plugin phù hợp với nền tảng EC của bạn

STEP

Thanh toán hợp nhất

Cho phép chọn 5+ phương thức thanh toán từ một UI

STEP

Xử lý thanh toán + Webhook

Token hóa, hỗ trợ 3DS và đồng bộ tức thì qua Webhook

STEP

Quản lý nhà bán

Vận hành lịch sử giao dịch và hoàn tiền trên một bảng quản trị

CHALLENGE

Bài toán thiết kế cần giải

Bốn yêu cầu cấu trúc đặt ra cho plugin.

Không vấn đề nào trong số này là chuyện chọn công nghệ — mỗi vấn đề là một yêu cầu kinh doanh gắn trực tiếp với hiệu quả phát triển, chi phí vận hành, bảo mật và thời gian onboarding nhà bán.

① Triển khai riêng cho từng nền tảng EC khiến chi phí phát triển tăng gấp 3

Cùng một logic thanh toán trên SFCC / EC-CUBE 2 / EC-CUBE 4 triển khai ba lần , chi phí bảo trì cũng phình lên gấp 3.

② Nếu không hấp thụ khác biệt SDK, chênh lệch phiên bản sẽ gây lỗi hành vi không nhất quán

Bỏ mặc chênh lệch phiên bản SDK chính thức,sự cố production do một bản cập nhật nhỏ là một rủi ro thực sự.

③ Triển khai Webhook theo từng nền tảng khiến đồng bộ trạng thái thiếu ổn định

Nếu triển khai trình xử lý Webhook cho từng nền tảng EC,thử lại và tính idempotent bị phân tán đảm bảo.

④ Trì hoãn onboarding nhà bán khiến hoạt động kinh doanh thanh toán không tăng trưởng

Nếu onboarding lên một nền tảng mất hàng tuần,tốc độ thu hút nhà bán sẽ thua kém các đối thủ thanh toán trung gian.

ARCHITECTURE

Kiến trúc chúng tôi cùng xây dựng

Biến plugin thanh toán thành “nền tảng không ngừng” trên bốn lĩnh vực.

Chúng tôi tự xây dựng nền tảng plugin thanh toán của nhà cung cấp dịch vụ thanh toán từ con số không. Ba plugin tuân thủ SDK chính thức của các nền tảng EC được cung cấp dưới dạng một bộ plugin duy nhất: logic thanh toán được tập trung trong một lõi dùng chung, còn lớp UI được triển khai bằng ngôn ngữ template của từng nền tảng.

Lĩnh vực ①

Lõi thanh toán dùng chung

Vấn đề

Triển khai riêng cho từng nền tảng EC khiến chi phí phát triển tăng gấp 3.

Giải pháp

Logic thanh toán, token hóa và 3DS tập trung trong một lõi dùng chung

Plugin cho mỗi nền tảng chỉ triển khai lớp UI; logic thanh toán nằm trong module dùng chung

Lĩnh vực ②

Tương thích SDK

Vấn đề

Nếu không hấp thụ khác biệt SDK, chênh lệch phiên bản sẽ gây lỗi hành vi không nhất quán.

Giải pháp

Tuân thủ SDK chính thức + lớp adapter tương thích

Tuân thủ API chính thức của SFRA 6.x / EC-CUBE 2.25 / 4.3; khác biệt phiên bản được hấp thụ bởi adapter

Lĩnh vực ③

Tích hợp Webhook

Vấn đề

Triển khai Webhook theo từng nền tảng khiến đồng bộ trạng thái thiếu ổn định.

Giải pháp

Trình xử lý Webhook thống nhất đảm bảo tính idempotent + thử lại

Đặc tả nhận Webhook chung cho cả 3 nền tảng; thử lại, timeout và tính idempotent triển khai tại một nơi

Lĩnh vực ④

Onboarding nhà bán

Vấn đề

Trì hoãn onboarding nhà bán khiến hoạt động kinh doanh thanh toán không tăng trưởng.

Giải pháp

Phân phối plugin qua npm/composer + trình hướng dẫn cấu hình

Nhà bán hoàn tất triển khai chỉ trong vài cú nhấp, chọn khóa API và phương thức thanh toán trong UI cấu hình

TECH STACK

SFCC

Salesforce Commerce Cloud

JavaScriptI Template ISML

EC-CUBE

PHP

Symfony (EC-CUBE 4)T Twig / Smarty

Composer

Dùng chung

R REST APIW Webhook3 3D SecureP PCI-DSS

IMPACT

Giá trị mà nền tảng tạo ra

“Tốc độ thu hút nhà bán” của nhà cung cấp dịch vụ thanh toán được tăng tốc.

Nền tảng này liên tục tạo ra các kết quả kinh doanh — giảm chi phí phát triển, tương thích SDK, tăng tốc thu hút nhà bán — chứ không chỉ là các chỉ số kỹ thuật.

① Nền tảng nén chi phí phát triển và bảo trì

Logic thanh toán được gom vào một lõi dùng chung, nên mỗi plugin cho nền tảng EC chỉ cần lớp UI. Chi phí bảo trì giảm mạnh.

② Thiết kế tự động thích ứng với khác biệt phiên bản SDK

Ngay cả khi SDK chính thức cập nhật, lớp adapter sẽ hấp thụ — plugin vẫn tiếp tục hoạt động.

③ Kiến trúc rút ngắn thời gian onboarding nhà bán

Với việc phân phối plugin cùng trình hướng dẫn cấu hình, nhà bán có thể bật thanh toán chỉ trong vài cú nhấp.

④ Thiết kế xử lý dữ liệu thanh toán an toàn

Với 3D Secure + tuân thủ PCI-DSS, thông tin thẻ được token hóa — giảm rủi ro vận hành cho nhà bán.

Mỗi nền tảng EC một cách triển khai thanh toán khác nhau,một nền tảng plugin thống nhất.

Nhà cung cấp dịch vụ thanh toán dẫn đầu thị trường thanh toán trung gian tại Nhật.

Bốn yêu cầu cấu trúc đặt ra cho plugin.

Biến plugin thanh toán thành “nền tảng không ngừng” trên bốn lĩnh vực.

“Tốc độ thu hút nhà bán” của nhà cung cấp dịch vụ thanh toán được tăng tốc.

Trải nghiệm sản phẩm của nhà cung cấp dịch vụ thanh toán qua bản demo chạy thực tế.