Tích hợp cổng thanh toán & đơn vị vận chuyển vào website thương mại điện tử: kiến trúc API và đối soát Webhook
Tích hợp thanh toán và vận chuyển vào website thương mại điện tử là việc kết nối hệ thống giỏ hàng với máy chủ cổng thanh toán và hãng giao vận qua giao thức API/Webhook. Trong gói Website TMĐT từ 80.000.000đ của Uptech đã bao gồm sẵn COD, mã VietQR động, 01 cổng thanh toán trực tuyến và 01 đơn vị vận chuyển tự động; các cổng bổ sung có chi phí từ 10.000.000đ/tích hợp (chưa gồm VAT 10%).
Khách hàng rời bỏ giỏ hàng ở bước cuối thường xuất phát từ hai nguyên nhân: không biết phí vận chuyển thực tế là bao nhiêu hoặc thao tác chuyển khoản thanh toán quá rườm rà, thiếu tin cậy. Tuy nhiên, nếu tích hợp cổng thanh toán và vận chuyển không đúng chuẩn kỹ thuật, doanh nghiệp rất dễ gặp lỗi khách đã bị trừ tiền nhưng đơn hàng vẫn báo “Chưa thanh toán”, hoặc tính sai phí giao hàng đối với kiện hàng cồng kềnh. Bài viết này phân tích kiến trúc tích hợp an toàn mà Uptech áp dụng.
1. Các nhóm phương thức thanh toán trên website TMĐT tại Việt Nam
Tại thị trường Việt Nam, hành vi thanh toán của người mua hàng trực tuyến phân hóa rõ theo giá trị đơn hàng trung bình (AOV) và ngành hàng. Một giỏ hàng tối ưu tỷ lệ hoàn tất đơn cần kết hợp linh hoạt các phương thức sau:
| Phương thức | Cơ chế vận hành | Mô hình kinh doanh phù hợp |
|---|---|---|
| Thanh toán khi nhận hàng (COD) | Khách đặt hàng trên web; bưu tá giao hàng, thu hộ tiền mặt và đối soát định kỳ về tài khoản doanh nghiệp. | Hàng tiêu dùng, thời trang, mỹ phẩm hoặc khách mua lần đầu cần kiểm hàng. |
| Chuyển khoản qua mã VietQR động | Hệ thống tự sinh mã QR chuẩn EMVCo chứa sẵn số tài khoản, số tiền chính xác và nội dung gắn mã đơn hàng; tự động gạch nợ khi nhận thông báo biến động. | Mọi website bán lẻ và B2B muốn thu tiền ngay với chi phí giao dịch tối ưu, giảm tỷ lệ hoàn đơn. |
| Cổng thanh toán nội địa & Ví điện tử | Hỗ trợ quét QR ngân hàng, thẻ ATM nội địa, ví điện tử phổ biến và trả góp qua thẻ tín dụng. | Điện máy, công nghệ, nội thất, khóa học hoặc doanh nghiệp cần báo cáo đối soát tự động. |
| Thẻ quốc tế (Visa, Mastercard, JCB, Apple Pay, Google Pay) | Thanh toán một chạm hoặc nhập thông tin thẻ có xác thực bảo mật 3D Secure 2.0. | Thương hiệu cao cấp, dịch vụ du lịch – khách sạn, bán hàng xuyên biên giới. |
2. Kiến trúc IPN / Webhook chống giả mạo và chống ghi nhận trùng giao dịch
Lỗi kỹ thuật nghiêm trọng thường gặp ở các website lập trình thiếu kinh nghiệm là dựa vào trang cảm ơn trên trình duyệt của khách (Return URL) để đổi trạng thái đơn hàng thành “Đã thanh toán”. Nếu khách tự sửa tham số trên thanh địa chỉ hoặc lỡ tay đóng trình duyệt ngay sau khi ngân hàng trừ tiền, dữ liệu đơn hàng sẽ bị sai lệch.
Uptech thiết kế module thanh toán theo chuẩn an toàn giao dịch với 4 lớp kiểm soát:
- Xác thực Server-to-Server (IPN / Webhook): Trạng thái thanh toán chỉ được cập nhật khi máy chủ cổng thanh toán gửi thông báo trực tiếp về API nhận kết quả của máy chủ website.
- Kiểm tra chữ ký mật mã (HMAC-SHA256 / RSA Signature): Mọi gói tin khởi tạo giao dịch và nhận kết quả đều được kiểm tra chữ ký số bằng khóa bí mật lưu trên biến môi trường máy chủ, ngăn chặn hành vi can thiệp sửa số tiền.
- Khóa chống xử lý lặp (Idempotency Key): Nếu cổng thanh toán gửi lại gói tin IPN nhiều lần do nghẽn mạng, hệ thống đối chiếu mã giao dịch duy nhất để không trừ tồn kho hoặc cộng điểm thưởng hai lần.
- Cơ chế giữ chỗ tồn kho có thời hạn (Inventory Hold TTL): Khi khách chuyển sang màn hình thanh toán cho các sản phẩm giới hạn số lượng, hệ thống tạm giữ tồn kho trong 10–15 phút; nếu quá hạn chưa thanh toán, số tồn tự động hoàn trả lại kệ.
3. Tích hợp API đơn vị vận chuyển: tính phí tự động và đẩy vận đơn một chạm
Thay vì áp một mức phí vận chuyển cố định làm doanh nghiệp bù lỗ phí ship ở các đơn hàng nặng hoặc giao liên miền, tích hợp trực tiếp API đơn vị vận chuyển giúp tự động hóa toàn bộ khâu giao nhận:
- Tính phí giao hàng thời gian thực (Real-time Shipping Rate): Dựa trên kho xuất hàng gần khách, địa chỉ nhận hàng chuẩn hóa theo Tỉnh/Thành phố và Phường/Xã, tổng trọng lượng thực tế và kích thước quy đổi của toàn bộ giỏ hàng.
- Đẩy đơn và lấy mã vận đơn tự động (One-click Waybill): Ngay khi nhân viên kho xác nhận đóng gói trên CMS, hệ thống gọi API tạo vận đơn, trả về mã tra cứu (Tracking Code) và xuất mẫu in phiếu nhiệt dán kiện hàng.
- Đồng bộ trạng thái hành trình giao nhận: Nhận Webhook từ hãng vận chuyển (Đã lấy hàng → Đang trung chuyển → Đang giao → Giao thành công / Chuyển hoàn) để cập nhật trực tiếp trên trang tra cứu đơn hàng của khách.
4. Phạm vi và chi phí tích hợp tại Uptech
Trong gói Thiết kế Website Thương mại điện tử chuẩn vận hành của Uptech (từ 80.000.000đ, chưa gồm VAT 10%), hệ thống đã bao gồm sẵn phương thức COD, mã VietQR, 01 cổng thanh toán trực tuyến và 01 đơn vị vận chuyển tự động. Trường hợp doanh nghiệp cần mở rộng thêm nhiều cổng thanh toán, nhiều hãng vận chuyển liên tỉnh hoặc dịch vụ giao hỏa tốc nội thành, chi phí tích hợp bổ sung được niêm yết minh bạch từ 10.000.000đ/tích hợp.
Câu hỏi thường gặp
Giải đáp nhanh những điểm thương hiệu bán lẻ D2C, chuỗi cửa hàng đa chi nhánh, doanh nghiệp sản xuất – phân phối B2B và đơn vị xây dựng sàn giao dịch thương mại điện tử hay hỏi về chủ đề này.
Doanh nghiệp cần chuẩn bị hồ sơ gì để ký hợp đồng với các cổng thanh toán trực tuyến?
Các đơn vị trung gian thanh toán tại Việt Nam thường yêu cầu: Giấy chứng nhận đăng ký doanh nghiệp (hoặc hộ kinh doanh), tài khoản ngân hàng thương mại đứng tên pháp nhân, và website đã hoạt động thực tế có đầy đủ 5 trang chính sách công khai.
Nếu khách hàng quét mã thanh toán thành công nhưng tắt trình duyệt ngay thì đơn hàng có tự xác nhận không?
Có. Nhờ cơ chế IPN/Webhook kết nối trực tiếp giữa máy chủ cổng thanh toán và máy chủ website Uptech, ngay khi giao dịch thành công, trạng thái đơn hàng vẫn tự động chuyển sang Đã thanh toán và gửi thông báo xác nhận cho khách dù trình duyệt đã đóng.
Website có thể kết hợp vừa tính phí theo hãng vận chuyển vừa miễn phí giao hàng cho đơn từ một mức tiền nhất định không?
Hoàn toàn được. Quản trị viên có thể cấu hình quy tắc Freeship linh hoạt trên CMS: ví dụ miễn phí giao hàng toàn quốc cho đơn từ 500.000đ, hoặc hỗ trợ tối đa 30.000đ phí vận chuyển cho các đơn hàng cồng kềnh liên miền.
Nhận tư vấn kiến trúc & Báo giá chi tiết hệ thống Website Thương mại điện tử
Hãy cho Uptech biết mô hình bán hàng của bạn (B2C, B2B hay Đa kho/Sàn), số lượng mã sản phẩm (SKU) dự kiến và các phần mềm cổng thanh toán, vận chuyển, ERP/POS cần kết nối. Kỹ sư giải pháp của Uptech sẽ phân tích và gửi bản đề xuất kiến trúc kèm dự toán chi phí minh bạch trong 24 giờ làm việc.
- Phản hồi kèm sơ đồ kiến trúc đề xuất trong vòng 24 giờ làm việc
- Tư vấn miễn phí lộ trình đồng bộ tồn kho ERP/POS và cấu trúc SEO danh mục lớn
- Hợp đồng pháp nhân rõ ràng, bàn giao mã nguồn, xuất hóa đơn GTGT (VAT) đầy đủ