Ngày đăng: 18/11/2026 11:07 AM
Mục lục

    Kết nối cổng thanh toán website và đơn vị vận chuyển là giải pháp tích hợp hệ thống thanh toán trực tuyến với API giao hàng, giúp website tự động xác nhận giao dịch, tạo vận đơn, cập nhật trạng thái giao nhận và đối soát tiền thu hộ (COD). Giải pháp phù hợp với doanh nghiệp, cửa hàng kinh doanh online muốn giảm thao tác nhập liệu thủ công, hạn chế thất lạc đơn hàng và quản lý dòng tiền tập trung. Thay vì phải kiểm tra từng giao dịch và nhập lại thông tin cho hãng vận chuyển, doanh nghiệp có thể quản lý toàn bộ quy trình trên một hệ thống.

    Hai lỗi thường làm chủ shop mất tiền và mất khách: khách thanh toán qua thẻ hoặc mã QR bị trừ tiền nhưng website không ghi nhận đơn, và tiền COD nằm ở đơn vị vận chuyển quá lâu khiến shop thiếu vốn xoay vòng. Bài viết hướng dẫn thiết kế luồng kết nối từ thanh toán đến giao hàng và đối soát, kèm cách xử lý lỗi đồng bộ, hàng hoàn và tiêu chí chọn giữa plugin với tích hợp riêng.

    Hình mô phỏng luồng kết nối cổng thanh toán website với đơn vị vận chuyển gồm xác nhận thanh toán, tạo vận đơn, theo dõi giao hàng và đối soát COD
    Hình 1 (hình mô phỏng giao diện): Luồng từ thanh toán thành công đến tạo vận đơn, theo dõi giao hàng và đối soát tiền thu hộ.

    Kết nối cổng thanh toán website và đơn vị vận chuyển là gì?

    Kết nối cổng thanh toán website là việc tích hợp website bán hàng với một hoặc nhiều cổng thanh toán để khách trả tiền trực tuyến, website nhận kết quả giao dịch tự động và gắn kết quả đó với đúng đơn hàng; phần kết nối đơn vị vận chuyển nối tiếp bằng API để đơn đã đủ điều kiện được tạo vận đơn và theo dõi đến khi giao xong. Giải pháp phù hợp với doanh nghiệp có website bán hàng riêng, số đơn đủ lớn để nhập tay dễ sót, và muốn khách có nhiều cách thanh toán như QR, ví điện tử, thẻ nội địa và thẻ quốc tế. Doanh nghiệp đang xây dựng hoặc nâng cấp website có thể tham khảo dịch vụ thiết kế website thương mại điện tử của Vinasoftware.

    Các thuật ngữ dùng xuyên suốt bài:

    • Cổng thanh toán: hệ thống trung gian nhận khách từ website, xử lý giao dịch với ngân hàng hoặc ví điện tử rồi trả kết quả về cho website.
    • Return URL (trang trả về): địa chỉ khách được chuyển về sau khi thanh toán, chủ yếu để hiển thị kết quả cho khách.
    • IPN hoặc webhook: thông báo cổng thanh toán (hoặc hãng vận chuyển) tự gửi đến máy chủ của website khi có sự kiện, là nguồn đáng tin hơn để cập nhật đơn hàng.
    • Idempotency (xử lý không trùng): cùng một thông báo hoặc cùng một yêu cầu gửi nhiều lần vẫn chỉ cho ra một kết quả.
    • COD (thu hộ): khách trả tiền mặt khi nhận hàng, đơn vị vận chuyển thu hộ rồi chuyển lại cho shop theo kỳ đối soát.
    • Đối soát: so khớp số tiền, số đơn giữa website, cổng thanh toán và hãng vận chuyển để biết đã nhận đủ chưa.

    Vì sao website bán hàng cần tích hợp thanh toán và vận chuyển?

    Vấn đề Nguyên nhân thường gặp Cách xử lý khi kết nối đúng
    Khách đã trả tiền nhưng đơn vẫn “chờ thanh toán” Website chỉ dựa vào trang trả về; khách đóng trình duyệt hoặc mất mạng giữa chừng Cập nhật đơn từ thông báo IPN hoặc webhook tại máy chủ, có truy vấn bù khi thông báo chưa về
    Đơn bị xử lý hai lần Cổng gửi lại thông báo, website xử lý lại từ đầu Kiểm tra trạng thái đơn trước khi cập nhật, chỉ xử lý một lần
    Tiền về khác số tiền đơn hàng Không đối chiếu số tiền và mã đơn trong thông báo So khớp mã đơn, số tiền và chữ ký của thông báo
    Đơn thanh toán xong nhưng giao chậm hoặc sót Nhân viên phải nhập vận đơn thủ công Tự tạo vận đơn qua API khi đơn đủ điều kiện
    Tiền COD về chậm hoặc lệch Không đối soát định kỳ với hãng vận chuyển Bảng đối soát theo từng đợt, đánh dấu đơn lệch
    Hàng hoàn về nhưng tồn kho chưa cập nhật Trạng thái hoàn không được đồng bộ hoặc không có bước kiểm hàng Theo dõi trạng thái hoàn từ hãng, chỉ nhập lại tồn sau khi kho nhận và kiểm hàng

    Các hạng mục cần thiết khi kết nối thanh toán và vận chuyển

    Các hạng mục dưới đây là đề xuất thiết kế, không phải mô tả một dự án khách hàng cụ thể đã được Vinasoftware triển khai. Tài liệu kỹ thuật và điều kiện của từng cổng thanh toán, từng hãng vận chuyển khác nhau nên cần đối chiếu với tài liệu của nhà cung cấp.

    Tích hợp cổng thanh toán trực tuyến

    • Người sử dụng: khách mua hàng chọn phương thức; quản trị viên cấu hình cổng và phương thức hiển thị.
    • Đầu vào: mã đơn hàng duy nhất, số tiền, thông tin khai báo với cổng (mã định danh website, khóa bí mật) và địa chỉ nhận thông báo kết quả.
    • Xử lý: website tạo yêu cầu thanh toán kèm mã tham chiếu đơn, ký dữ liệu bằng khóa bí mật lưu ở máy chủ rồi chuyển khách sang cổng; website không tự lưu dữ liệu thẻ mà để cổng xử lý.
    • Đầu ra: giao dịch ở trạng thái chờ kết quả, gắn với đúng đơn hàng.
    • Lợi ích: khách có nhiều cách thanh toán (mã QR chuyển khoản theo chuẩn VietQR, ví điện tử như MoMo, ZaloPay, cổng nhiều phương thức như VNPAY, thẻ quốc tế Visa hoặc Mastercard) mà shop vẫn quản lý trên một luồng.
    • Ngoại lệ: mỗi cổng có tài liệu, phí và thời gian đối soát khác nhau; cần dùng môi trường thử (sandbox) trước khi chạy thật; doanh nghiệp chỉ nên dùng đơn vị trung gian thanh toán được cấp phép; không hiển thị khóa bí mật trên trình duyệt hay mã nguồn công khai.

    Tự động xác nhận giao dịch qua IPN hoặc webhook

    • Người sử dụng: hệ thống website (tự động); kế toán và chăm sóc khách hàng khi cần xem lại giao dịch.
    • Đầu vào: thông báo kết quả do cổng thanh toán gửi đến máy chủ của website, gồm mã đơn, số tiền, trạng thái và chữ ký.
    • Xử lý: website kiểm tra chữ ký hợp lệ theo đúng tài liệu của từng cổng, đơn hàng tồn tại, số tiền khớp và đơn chưa được xử lý, rồi mới chuyển đơn sang “đã thanh toán” và phản hồi cho cổng. Trang trả về chỉ dùng để hiển thị kết quả cho khách, không dùng để cập nhật đơn; trạng thái thanh toán do trình duyệt gửi về không được tin cậy.
    • Đầu ra: đơn chuyển trạng thái, kích hoạt bước giữ hàng và tạo vận đơn; mọi thông báo được ghi nhật ký.
    • Lợi ích: hạn chế đơn bị bỏ sót khi khách đóng trình duyệt giữa chừng và tránh xử lý trùng khi cổng gửi lại thông báo.
    • Ngoại lệ: thông báo không về do lỗi mạng (website truy vấn bù kết quả giao dịch theo chu kỳ hoặc khi khách khiếu nại); chữ ký sai (bỏ qua và ghi cảnh báo); số tiền lệch (giữ đơn ở trạng thái cần kiểm tra); xử lý hậu thanh toán nặng nên đưa vào hàng đợi để phản hồi cho cổng nhanh.
    Giao diện mô phỏng nhật ký xử lý thông báo IPN webhook với kiểm tra chữ ký, đối chiếu số tiền và cập nhật trạng thái đơn hàng đã thanh toán
    Hình 2 (hình mô phỏng giao diện): Nhật ký thông báo thanh toán với các bước kiểm tra chữ ký, số tiền và chống xử lý trùng.

    Kết nối API tạo vận đơn và theo dõi giao hàng

    • Người sử dụng: nhân viên kho và chăm sóc khách hàng; quản trị viên cấu hình đơn vị vận chuyển.
    • Đầu vào: đơn đã thanh toán hoặc đơn COD đã xác nhận, địa chỉ nhận, khối lượng, giá trị hàng và số tiền cần thu hộ.
    • Xử lý: website tính phí, chọn đơn vị vận chuyển theo quy tắc (vùng giao, loại hàng), gửi yêu cầu tạo vận đơn qua API đến các hãng như GHN, GHTK, Viettel Post kèm mã tham chiếu duy nhất của đơn, nhận mã vận đơn để in tem, rồi nhận trạng thái giao hàng qua webhook.
    • Đầu ra: mã vận đơn gắn với đơn, trạng thái giao (đang lấy, đang giao, giao thành công, giao thất bại, hoàn) được cập nhật tự động.
    • Lợi ích: giảm thao tác nhập tay, rút ngắn thời gian từ lúc khách thanh toán đến lúc bàn giao cho hãng.
    • Ngoại lệ: địa chỉ nhập sai hoặc không có trong danh mục của hãng (danh mục địa chỉ có thể thay đổi theo đợt sắp xếp đơn vị hành chính nên cần đồng bộ); hãng không hỗ trợ khu vực giao; webhook trạng thái chậm hoặc không về (truy vấn bù theo mã vận đơn); thay đổi thông tin nhận hàng sau khi đã tạo vận đơn.
    Giao diện mô phỏng tạo vận đơn tự động với lựa chọn đơn vị vận chuyển, phí giao hàng, mã vận đơn và trạng thái giao nhận
    Hình 3 (hình mô phỏng giao diện): Đơn đã thanh toán được tạo vận đơn và theo dõi trạng thái giao hàng; số liệu chỉ mang tính minh họa.

    Quản lý và đối soát tiền COD

    • Người sử dụng: kế toán, quản lý cửa hàng và chăm sóc khách hàng.
    • Đầu vào: danh sách đơn COD, số tiền thu hộ, phí vận chuyển, phí hoàn và báo cáo đối soát của hãng vận chuyển theo từng kỳ.
    • Xử lý: hệ thống đánh dấu đơn giao thành công là “tiền COD chờ đối soát”, tổng hợp theo hãng và theo đợt, so với báo cáo hoặc khoản tiền hãng chuyển về, rồi đánh dấu đơn khớp, đơn lệch và đơn còn treo.
    • Đầu ra: bảng đối soát cho thấy tiền COD đã nhận, tiền đang chờ, khoản trừ phí và các đơn cần kiểm tra lại.
    • Lợi ích: shop thấy rõ phần vốn đang nằm ở hãng vận chuyển, phát hiện chênh lệch sớm và chủ động làm việc với hãng thay vì để tích tụ.
    • Ngoại lệ: kỳ đối soát và mức phí do từng hãng quy định theo hợp đồng nên cần đối chiếu; đơn giao thất bại nhiều lần (có thể chuyển sang yêu cầu thanh toán trước); đơn hoàn làm khoản COD bị trừ hoặc thay đổi.

    Một số cách giảm đọng vốn COD thường áp dụng: khuyến khích khách thanh toán trước bằng mã QR hoặc ví điện tử, yêu cầu đặt cọc với đơn giá trị cao hoặc khu vực nhiều đơn giao thất bại, và theo dõi tỷ lệ giao thất bại theo từng hãng để cân nhắc điều chỉnh. Hiệu quả cụ thể phụ thuộc ngành hàng và tệp khách của từng shop.

    Đối soát thanh toán trực tuyến, đối soát COD và đối soát đơn hàng là ba nghiệp vụ khác nhau, không nên gộp thành một bước “đối soát tiền” chung:

    Nghiệp vụ Nội dung đối soát Bên đối chiếu
    Đối soát thanh toán trực tuyến So sánh giao dịch trên website với giao dịch thành công, phí và khoản tiền cổng thanh toán chuyển về Website và báo cáo của cổng thanh toán
    Đối soát COD So sánh tiền hãng vận chuyển thu hộ, phí giao hàng, phí hoàn và khoản tiền thực nhận Website và báo cáo của hãng vận chuyển
    Đối soát đơn hàng Kiểm tra trạng thái thanh toán, giao hàng, hủy đơn, hoàn hàng và doanh thu ghi nhận Các bộ phận nội bộ: bán hàng, kho, kế toán

    Ngoài COD, doanh nghiệp cần đối soát riêng các giao dịch thanh toán trực tuyến. Website nên lưu mã giao dịch, mã đơn hàng, số tiền, trạng thái thanh toán, phí giao dịch và số tiền thực nhận. Khi đối chiếu với báo cáo của cổng thanh toán, kế toán có thể phát hiện giao dịch thành công nhưng chưa được quyết toán, giao dịch bị hoàn hoặc khoản phí phát sinh chưa khớp.

    Giao diện mô phỏng bảng đối soát COD theo đơn vị vận chuyển với tiền thu hộ, phí, đơn hoàn và các đơn lệch cần kiểm tra
    Hình 4 (hình mô phỏng giao diện): Bảng đối soát tiền thu hộ theo từng hãng và từng đợt; số liệu chỉ mang tính minh họa.

    Xử lý hoàn tiền, đơn hủy và hàng hoàn

    • Người sử dụng: chăm sóc khách hàng, nhân viên kho, kế toán và quản trị viên.
    • Đầu vào: yêu cầu hủy, đổi trả, giao dịch lỗi hoặc đơn bị trả về kho.
    • Xử lý: hệ thống ghi nhận lý do, chuyển trạng thái đơn và tạo yêu cầu hoàn tiền theo quy trình của cổng hoặc ngân hàng. Với hàng hoàn, tồn kho không được tự cộng chỉ vì hãng gửi trạng thái hoàn mà đi qua bốn bước: (1) hãng vận chuyển xác nhận đơn hoàn; (2) kho tiếp nhận hàng thực tế; (3) nhân viên kiểm tra số lượng và tình trạng hàng; (4) hệ thống ghi nhận quyết định nhập lại tồn khả dụng, chuyển hàng lỗi hoặc chờ xử lý.
    • Đầu ra: lịch sử hoàn tiền gắn với đơn, trạng thái hoàn tiền khách theo dõi được, tồn kho cập nhật theo kết quả kiểm hàng.
    • Lợi ích: khách biết tiền đang ở bước nào, shop tránh hoàn thiếu hoặc hoàn trùng và tránh ghi tồn khả dụng sai khi hàng về lỗi hoặc thiếu.
    • Ngoại lệ: hoàn tiền một phần; thời gian hoàn phụ thuộc cổng, ngân hàng hoặc ví; hàng hoàn thiếu hoặc hư hỏng; đơn thanh toán thành công nhưng hết hàng cần có quy trình hoàn hoặc đổi sản phẩm.

    Quy trình xử lý đơn hàng từ thanh toán đến giao hàng

    01
    Khách chọn thanh toán
    QR, ví điện tử, thẻ hoặc COD
    02
    Cổng xử lý giao dịch
    Trả kết quả về website qua IPN hoặc webhook
    03
    Website xác nhận đơn
    Kiểm tra chữ ký, số tiền, chống trùng
    04
    Tạo vận đơn
    Gửi API sang đơn vị vận chuyển
    05
    Theo dõi giao hàng
    Nhận trạng thái giao, hoàn qua webhook
    06
    Đối soát
    Đối soát thanh toán, COD và đơn hàng theo kỳ

    Ví dụ minh họa luồng xử lý đơn hàng

    Các đơn, số liệu và kết quả dưới đây là ví dụ minh họa, không phải dữ liệu hay kết quả triển khai thực tế của Vinasoftware.

    Sự kiện (giả định) Hệ thống xử lý Kết quả
    Khách thanh toán QR rồi đóng trình duyệt trước khi trang trả về hiện IPN vẫn đến máy chủ, kiểm tra chữ ký và số tiền khớp Đơn chuyển “đã thanh toán”, vận đơn được tạo
    Cổng gửi lại cùng một thông báo lần thứ hai Kiểm tra đơn đã xử lý, không cập nhật lại Không tạo vận đơn trùng
    Một đơn COD giao thành công Nhận webhook trạng thái giao thành công Đơn chuyển sang “tiền COD chờ đối soát”
    Một đơn COD bị hoàn về Nhận webhook hoàn, chuyển đơn sang “đang hoàn về”, bỏ khỏi khoản chờ đối soát; chưa cộng tồn khả dụng Sau khi kho nhận và kiểm hàng, nhân viên chọn nhập lại tồn, chuyển hàng lỗi hoặc chờ xử lý; doanh thu không bị tính nhầm
    Cuối kỳ, hãng chuyển tiền thiếu một đơn so với bảng của shop Đánh dấu đơn lệch trong bảng đối soát COD Kế toán gửi yêu cầu kiểm tra với hãng
    Cổng thanh toán báo thành công nhưng báo cáo cuối kỳ của cổng chưa có giao dịch Đánh dấu giao dịch chưa quyết toán trong bảng đối soát thanh toán Kế toán đối chiếu mã giao dịch với cổng

    Các lỗi thường gặp và cách xử lý

    Nguyên tắc xử lý khi API gián đoạn hoặc đồng bộ thất bại

    API của hãng vận chuyển hoặc cổng thanh toán có thể tạm ngừng, chậm hoặc trả lỗi. Hệ thống cần coi đây là tình huống bình thường và xử lý theo các nguyên tắc sau:

    • Lưu yêu cầu đồng bộ thất bại vào nhật ký, kèm nội dung lỗi và thời điểm.
    • Tự động thử lại theo khoảng thời gian phù hợp, không thử dồn dập.
    • Không tạo vận đơn trùng khi gửi lại yêu cầu: dùng mã tham chiếu duy nhất cho mỗi đơn.
    • Có trạng thái “chờ đồng bộ” để nhân viên dễ theo dõi.
    • Cho phép quản trị viên kiểm tra và đồng bộ lại khi cần.
    • Lưu lịch sử thay đổi trạng thái để truy vết.
    Tình huống Cách xử lý đề xuất
    API vận chuyển tạm ngừng Lưu yêu cầu, đặt đơn ở trạng thái chờ đồng bộ và thử gửi lại
    Cổng thanh toán không gửi webhook Truy vấn trạng thái giao dịch theo mã đơn
    Gửi yêu cầu tạo vận đơn nhiều lần Dùng mã tham chiếu duy nhất để kiểm soát trùng
    Trạng thái giao hàng không đồng bộ Đối chiếu mã vận đơn và truy vấn lại
    Đồng bộ thành công nhưng dữ liệu chưa cập nhật Ghi nhật ký và đưa vào danh sách cần kiểm tra

    Các tình huống vận hành thường gặp

    • Khách bị trừ tiền nhưng đơn chưa cập nhật: chăm sóc khách hàng tra mã giao dịch trong nhật ký; nếu thông báo chưa về, quản trị viên chạy truy vấn bù kết quả với cổng; khi xác nhận đã thu tiền, đơn được cập nhật thủ công kèm ghi chú và khách nhận thông báo.
    • Webhook từ hãng vận chuyển không về: hệ thống đánh dấu các đơn quá lâu chưa đổi trạng thái; nhân viên kho tra cứu theo mã vận đơn qua API hoặc trang của hãng rồi cập nhật; quản trị web kiểm tra địa chỉ nhận thông báo và nhật ký lỗi.
    • Tiền COD lệch so với hãng: kế toán lọc các đơn lệch trong bảng đối soát, xuất danh sách kèm mã vận đơn gửi hãng, theo dõi đến khi hãng điều chỉnh và ghi nhận kết quả.
    • Khách giao thất bại nhiều lần: hệ thống gắn cờ khách hoặc khu vực, kinh doanh liên hệ xác nhận lại, và các đơn sau có thể chuyển sang hình thức thanh toán trước.

    Nên dùng plugin hay phát triển tích hợp riêng?

    Phương án Khi phù hợp Lợi thế Cần kiểm tra
    Dùng plugin hoặc module có sẵn của nền tảng website Website dùng nền tảng phổ biến, nghiệp vụ tiêu chuẩn, ít cổng thanh toán và hãng vận chuyển Triển khai nhanh, ít phải lập trình Có hỗ trợ cổng và hãng bạn cần không, xử lý thông báo, đối soát COD, cập nhật khi cổng đổi tài liệu
    Kết nối với phần mềm quản lý bán hàng hoặc kho đang dùng Đơn hàng, kho và kế toán đang nằm ở nhiều hệ thống Đơn, tồn kho và vận đơn cùng một luồng API của phần mềm, đồng bộ trạng thái, xử lý lỗi đồng bộ
    Phát triển tích hợp theo yêu cầu Nhiều quy tắc vận hành, nhiều hãng vận chuyển hoặc yêu cầu đối soát đặc thù Luồng sát nghiệp vụ, kiểm soát dữ liệu Chi phí phát triển và bảo trì, kiểm thử, theo dõi thay đổi từ nhà cung cấp

    Không phải cứ có nhiều đơn hàng là cần phát triển phần mềm riêng. Doanh nghiệp nên đánh giá mức độ phức tạp của nghiệp vụ, khả năng đáp ứng của nền tảng hiện tại và chi phí vận hành dài hạn trước khi lựa chọn. Nên chốt quy trình đơn hàng và đối soát trước khi chọn công nghệ, vì cổng thanh toán và hãng vận chuyển có thể thay đổi theo thời gian còn quy trình nội bộ thì ổn định hơn. Khi shop dùng phần mềm quản lý riêng, có thể tham khảo cách tổ chức trong bài app bán hàng kết nối tồn kho và đơn hàng.

    Chi phí kết nối cổng thanh toán và vận chuyển phụ thuộc vào yếu tố nào?

    Không có mức chi phí hay tiến độ cố định phù hợp cho mọi shop. Chi phí gồm phần phát triển và phần phí của nhà cung cấp: phí giao dịch của cổng thanh toán và phí vận chuyển, thu hộ do từng đơn vị quy định theo hợp đồng. Phạm vi phát triển phụ thuộc số cổng và hãng cần kết nối, quy tắc chọn hãng, mức tự động hóa đối soát COD, yêu cầu báo cáo và nhu cầu kết nối phần mềm đang dùng.

    Danh mục nên chuẩn bị trước khi gửi yêu cầu tư vấn:

    • Các phương thức thanh toán muốn mở và cổng thanh toán đã đăng ký hoặc dự định dùng.
    • Các hãng vận chuyển đang dùng, hợp đồng và kỳ đối soát COD hiện tại.
    • Quy trình xử lý đơn hiện nay: ai tạo đơn, ai xác nhận thanh toán, ai bàn giao hàng.
    • Những lỗi hay gặp: đơn sót, thanh toán không ghi nhận, COD lệch hoặc về chậm.
    • Phần mềm quản lý bán hàng, kho hoặc kế toán đang dùng.

    Checklist nghiệm thu luồng thanh toán và vận chuyển

    Tình huống kiểm thử Kết quả mong đợi
    Thanh toán thành công rồi đóng trình duyệt Đơn vẫn chuyển “đã thanh toán” nhờ thông báo từ cổng
    Cổng gửi cùng một thông báo nhiều lần Đơn chỉ được cập nhật và tạo vận đơn một lần
    Thông báo có chữ ký sai hoặc số tiền không khớp Không cập nhật đơn, ghi nhật ký cảnh báo
    Tạo vận đơn với địa chỉ thiếu thông tin Hệ thống báo lỗi cụ thể và giữ đơn chờ sửa
    API hãng vận chuyển tạm ngừng khi tạo vận đơn Đơn ở trạng thái chờ đồng bộ, tự thử lại và không tạo vận đơn trùng
    Hãng cập nhật trạng thái giao thành công Đơn chuyển trạng thái, COD vào “chờ đối soát”
    Hãng báo đơn hoàn về Đơn chuyển “đang hoàn về”, tồn khả dụng chưa tăng; chỉ ghi nhận sau khi kho nhận và kiểm hàng
    Đối soát thanh toán trực tuyến cuối kỳ Đánh dấu đúng giao dịch chưa quyết toán, bị hoàn hoặc lệch phí
    Đối soát COD cuối kỳ có đơn lệch Bảng đối soát đánh dấu đúng đơn lệch kèm mã vận đơn

    Vinasoftware hỗ trợ kết nối thanh toán và vận chuyển cho website bán hàng

    Vinasoftware hỗ trợ doanh nghiệp khảo sát quy trình đơn hàng và xây dựng phần kết nối cho website; phạm vi thực hiện, chi phí và tiến độ được thống nhất sau khảo sát, bao gồm:

    • Tích hợp cổng thanh toán và xử lý kết quả giao dịch có kiểm tra chữ ký, số tiền và chống xử lý trùng.
    • Kết nối API với các hãng vận chuyển để tạo vận đơn, in tem và nhận trạng thái giao hàng.
    • Xây dựng bảng đối soát thanh toán, đối soát COD và báo cáo dòng tiền theo hãng và theo kỳ.
    • Kết nối với phần mềm quản lý bán hàng, kho hoặc kế toán đang dùng.

    Với các yêu cầu vượt quá khả năng của plugin, doanh nghiệp có thể tham khảo dịch vụ thiết kế phần mềm theo yêu cầu; nếu đang xây dựng hoặc nâng cấp website bán hàng, xem thêm dịch vụ thiết kế website thương mại điện tử của Vinasoftware.

    Lưu ý bảo mật và pháp lý

    Nguyên tắc bảo mật

    • Kiểm tra chữ ký webhook theo đúng tài liệu của từng nhà cung cấp, không áp dụng cách kiểm tra của hãng này cho hãng khác.
    • Không tin trạng thái thanh toán do trình duyệt gửi về; chỉ cập nhật đơn từ thông báo đã xác thực ở máy chủ.
    • Website không tự lưu dữ liệu thẻ nhạy cảm nếu không có phạm vi tuân thủ phù hợp.
    • Bảo vệ API key và khóa bí mật: chỉ lưu ở máy chủ, không đưa vào mã chạy trên trình duyệt hay kho mã nguồn công khai.
    • Phân quyền người xem và người điều chỉnh giao dịch, đối soát.
    • Lưu nhật ký thao tác của nhân viên trên đơn hàng, hoàn tiền và đối soát.

    Lưu ý pháp lý

    • Đơn vị trung gian thanh toán: chỉ hợp tác với đơn vị được cấp phép theo quy định về thanh toán không dùng tiền mặt; đọc kỹ hợp đồng về phí, thời gian đối soát và trách nhiệm khi có giao dịch lỗi.
    • Công khai chính sách: website cần hiển thị rõ phương thức thanh toán, điều kiện giao hàng, chính sách đổi trả và hoàn tiền; nội dung cụ thể cần đối chiếu quy định thương mại điện tử hiện hành và có thể cần ý kiến pháp chế.
    • Thủ tục với cơ quan quản lý: thủ tục thông báo website bán hàng và thủ tục đăng ký website cung cấp dịch vụ thương mại điện tử là hai thủ tục khác nhau, áp dụng cho hai loại website khác nhau; doanh nghiệp cần xác định website của mình thuộc loại nào rồi đối chiếu văn bản hiện hành. Xem hướng dẫn trong bài cách đăng ký website với Bộ Công Thương và bài khi nào cần đăng ký website với Bộ Công Thương.
    • Dữ liệu cá nhân: thông tin khách khi đặt hàng, địa chỉ và số điện thoại gửi cho hãng vận chuyển cần có mục đích sử dụng, phạm vi chia sẻ, thời hạn lưu và biện pháp bảo vệ rõ ràng.

    Căn cứ cần rà soát bao gồm Luật Thương mại điện tử số 122/2025/QH15 (hiệu lực 01/07/2026), Nghị định số 248/2026/NĐ-CP (hiệu lực 01/07/2026), Luật Bảo vệ dữ liệu cá nhân số 91/2025/QH15 (hiệu lực 01/01/2026) và quy định hiện hành về thanh toán không dùng tiền mặt. Giải pháp kỹ thuật chỉ hỗ trợ; trách nhiệm tuân thủ pháp luật thuộc về doanh nghiệp. Thông tin này chỉ để định hướng, không thay thế ý kiến pháp lý cho trường hợp cụ thể.

    Câu hỏi thường gặp

    1. Kết nối cổng thanh toán website có mất phí không?

    Thường có. Cổng thanh toán tính phí theo giao dịch hoặc theo phương thức thanh toán, một số nhà cung cấp có thêm phí thiết lập hoặc duy trì. Ngoài ra còn phí phát triển phần tích hợp nếu thuê đơn vị lập trình. Mức phí và điều kiện khác nhau theo nhà cung cấp và hợp đồng, nên cần đọc kỹ trước khi đăng ký.

    2. Có thể kết nối nhiều cổng thanh toán trên cùng một website không?

    Có thể, nếu website được thiết kế để quản lý nhiều cổng. Mỗi cổng cần cấu hình riêng, nhận thông báo riêng và ghi giao dịch theo cùng một chuẩn trạng thái để kế toán đối soát được. Website cũng cần quy định rõ phương thức nào hiển thị cho khách và xử lý thế nào khi một cổng gián đoạn.

    3. Website có thể tự động tạo vận đơn từ đơn hàng không?

    Có thể, nếu hãng vận chuyển cung cấp API và website được kết nối. Khi đơn đủ điều kiện (đã thanh toán hoặc đã xác nhận COD) và có đủ địa chỉ, khối lượng, giá trị hàng, website gửi thông tin sang hãng để tạo vận đơn, nhận mã vận đơn để in tem; một số hãng còn gửi trạng thái giao hàng qua webhook.

    4. Khách đã bị trừ tiền nhưng website chưa ghi nhận đơn thì xử lý thế nào?

    Tra mã giao dịch trong nhật ký thông báo (IPN hoặc webhook) của cổng. Nếu chưa có, dùng chức năng truy vấn kết quả giao dịch của cổng để xác nhận đã thu tiền hay chưa. Nếu đã thu tiền, cập nhật đơn kèm ghi chú và thông báo cho khách; nếu chưa, hướng dẫn khách theo quy trình hoàn hoặc thanh toán lại của cổng.

    5. Tiền COD được đối soát và chuyển về như thế nào?

    Hãng vận chuyển thu tiền khi giao thành công rồi chuyển lại cho shop theo kỳ đối soát đã thỏa thuận, sau khi trừ các khoản phí theo hợp đồng. Shop nên có bảng đối soát riêng để so với báo cáo của hãng, phát hiện đơn lệch hoặc còn treo và theo dõi đến khi xử lý xong.

    6. Có thể tích hợp nhiều hãng vận chuyển cùng lúc không?

    Có thể, nếu mỗi hãng đều có API và website có quy tắc chọn hãng, ví dụ theo khu vực giao, loại hàng hoặc mức phí. Cần chuẩn hóa trạng thái giao hàng của các hãng về một bộ trạng thái chung để nhân viên theo dõi trên một màn hình và đối soát COD theo từng hãng.

    7. Nên dùng plugin hay phát triển tích hợp riêng?

    Plugin phù hợp khi nền tảng phổ biến và nghiệp vụ tiêu chuẩn; kết nối phần mềm quản lý phù hợp khi đơn, kho và kế toán nằm ở nhiều hệ thống; phát triển riêng phù hợp khi có nhiều quy tắc vận hành, nhiều hãng vận chuyển hoặc đối soát đặc thù. Nên chốt quy trình trước khi chọn giải pháp.

    8. Chi phí và thời gian triển khai phụ thuộc vào đâu?

    Phụ thuộc số cổng thanh toán và hãng vận chuyển cần kết nối, quy tắc chọn hãng, mức tự động hóa đối soát COD, hệ thống đang dùng và yêu cầu báo cáo. Nên gửi mô tả quy trình đơn hàng hiện tại để xác định phạm vi trước khi chốt chi phí và tiến độ.

    Kết nối cổng thanh toán website chỉ phát huy khi kết quả thanh toán, vận đơn và đối soát COD đi cùng một luồng dữ liệu và được kiểm tra ở từng bước.

    Tài liệu tham khảo: Luật Thương mại điện tử 122/2025/QH15; Nghị định 248/2026/NĐ-CP; Luật Bảo vệ dữ liệu cá nhân 91/2025/QH15; tài liệu tích hợp thanh toán của VNPAY; tài liệu API của MoMo; tài liệu API của GHN; tài liệu API của GHTK (webhook); tài liệu API của Viettel Post. Các đơn, số liệu và quy trình giả định trong bài chỉ nhằm minh họa yêu cầu thiết kế giải pháp.

    Vui lòng điền thông tin và gửi cho chúng tôi để được tư vấn nhiệt tình!

    Nhận tư vấn tại đây!

    Vui lòng điền thông tin và gửi cho chúng tôi để được tư vấn nhiệt tình!