Hướng dẫn tích hợp Sepay với Shopify

Shopify là nền tảng thương mại điện tử đẳng cấp thế giới, là "vũ khí" tối thượng của giới làm Dropshipping và bán lẻ. Tuy nhiên, khi áp dụng tại thị trường Việt Nam, các chủ shop thường vấp phải một rào cản chí mạng: Shopify thiếu kết nối đồng bộ hoàn hảo với hạ tầng ngân hàng nội địa.

Nếu dùng cổng thanh toán quốc tế (PayPal, Stripe) thì phí quá cao và dễ bị "hold" (giữ) tiền. Nếu dùng phương thức "Chuyển khoản thủ công" thì quy trình đối soát lại bằng tay vô cùng mệt mỏi, dễ xảy ra sai sót. Đã đến lúc bạn cần một chiếc "phao cứu sinh" công nghệ.

1. Lối thoát công nghệ: Kết nối API thông qua Custom App

Tin vui là Shopify sở hữu một kho tàng API cực kỳ mở. Bạn hoàn toàn có thể sử dụng kiến trúc Open Banking của SePay để làm cầu nối giữa Shopify và tài khoản ngân hàng của bạn. Khi cấu hình thành công:

  • Khách hàng sẽ thấy mã QR thanh toán chuyên nghiệp ngay tại trang Thank You (Trang hoàn tất đơn).
  • Khách quét mã xong, tiền về thẳng ngân hàng của bạn.
  • Hệ thống SePay tự động gửi lệnh API về Shopify để đổi trạng thái đơn thành Paid (Đã thanh toán) ngay lập tức.

2. Quy trình 3 bước cốt lõi tích hợp SePay vào Shopify

Không cần biết lập trình, bạn chỉ cần thực hiện đúng quy trình 3 bước cấp quyền (Custom App) dưới đây:

Bước 1: Tạo Ứng dụng riêng (Custom App) trên Shopify

Mục đích: Cấp quyền cho SePay có thể đọc và thay đổi trạng thái đơn hàng.

  • Đăng nhập quản trị Shopify -> Settings (Cài đặt) -> Apps and sales channels -> Develop apps -> Create an app.
  • Đặt tên ứng dụng là: SePay Integration.
  • Vào mục Configuration -> Admin API integration. Kéo xuống mục Orders và tích chọn write_orders và read_orders.
  • Nhấn Install app (Cài đặt ứng dụng). Sau khi cài đặt, nhấn Reveal token once để sao chép Admin API access token.

Bước 2: Thiết lập kết nối tại trang quản trị SePay

  • Truy cập my.sepay.vn -> mục Tích hợp Shopify -> Thêm tích hợp.
  • Điền Tên miền Shopify của bạn (Ví dụ: mystore.myshopify.com).
  • Dán mã Admin API access token vừa copy ở Bước 1 vào.
  • Chọn tài khoản ngân hàng bạn muốn nhận tiền. Nhấn Thêm. SePay sẽ tạo cho bạn một đoạn mã HTML (Code tích hợp). Hãy copy đoạn mã này.

Bước 3: Chèn phương thức thanh toán tùy chỉnh vào Shopify

Mục đích: Hiển thị hướng dẫn và mã QR cho khách hàng lúc thanh toán.

  • Quay lại quản trị Shopify -> Settings -> Payments.
  • Kéo xuống phần Manual payment methods (Phương thức thủ công) -> Chọn Add manual payment method -> Create custom payment method.
  • Tên phương thức: Điền Thanh toán bằng mã QR tự động (VietQR).
  • Payment details (Chi tiết thanh toán): Dán đoạn mã HTML bạn đã copy từ SePay ở Bước 2 vào đây. (Đoạn mã này sẽ tạo ra mã QR trên màn hình thanh toán của khách).
  • Kích hoạt và lưu lại.

3. LƯU Ý KỸ THUẬT QUAN TRỌNG: Đồng bộ Tiền tố (Prefix)

Tương tự như các nền tảng khác, sự thành bại của hệ thống tự động nằm ở định dạng mã đơn hàng.

Kiểm tra lại Prefix (Tiền tố) của bạn! Nếu trên Shopify, mã đơn hàng của bạn có dạng #1001 hoặc bạn đã chỉnh sửa thành dạng chữ như SP1001, bạn bắt buộc phải cấu hình tiền tố tương ứng trên SePay (là dấu # hoặc chữ SP). Nếu không đồng bộ tiền tố, SePay sẽ không thể nhận diện được người mua đang thanh toán cho đơn hàng nào để gạch nợ trên Shopify.

Tối ưu hóa cửa hàng Shopify Việt Nam ngay hôm nay!

Mang trải nghiệm thanh toán nội địa mượt mà nhất lên cửa hàng quốc tế của bạn. Đăng ký SePay ngay để lấy API cấu hình cho Custom App hoàn toàn miễn phí (Tặng 50 giao dịch/tháng).

Khởi Tạo API Cho Shopify Miễn Phí