Bỏ qua để đến nội dung
Tài liệu

Tích hợp Shopify (Thanh toán VietQR)

~3 phút đọc

Dòng Tiền Pro cung cấp giải pháp tích hợp thanh toán VietQR cho các cửa hàng Shopify thông qua cơ chế Phương thức thanh toán thủ công (Manual Payment Method) kết hợp với Checkout UI Extension và GraphQL Admin API tự động gạch nợ.

Cơ chế vận hành

Phần tiêu đề “Cơ chế vận hành”

Do chính sách nền tảng của Shopify giới hạn can thiệp trực tiếp vào quy trình thanh toán lưu trữ (Hosted Checkout) đối với các nhà cung cấp nội địa, Dòng Tiền Pro áp dụng quy trình chuẩn mực được Shopify khuyến nghị:

flowchart TD
  A["Khách chọn 'Chuyển khoản VietQR' tại Checkout"] --> B["Bấm Đặt hàng"]
  B --> C["Shopify phát sự kiện orders/create"]
  C --> D["Dòng Tiền Pro xác thực & re-fetch đơn hàng"]
  D --> E["Sinh mã DTP & cập nhật Metafields đơn"]
  E --> F["Thank-you Extension hiển thị mã VietQR"]
  F --> G["Khách quét QR chuyển khoản"]
  G --> H["Tiền về & giao dịch verified"]
  H --> I["GraphQL Admin API gọi orderMarkAsPaid"]

Các bước thiết lập

Phần tiêu đề “Các bước thiết lập”

  1. Cài đặt Ứng dụng Dòng Tiền Pro: Trong màn hình Tích hợp trên Dòng Tiền Pro, chọn thẻ Shopify và bấm Kết nối. Điền tên miền cửa hàng của bạn (dạng ten-shop.myshopify.com) và xác nhận cấp quyền truy cập.

  2. Kích hoạt Phương thức thanh toán thủ công trong Shopify Admin:

    • Truy cập Shopify Admin > Settings (Cài đặt) > Payments (Thanh toán).
    • Trong mục Manual payment methods, chọn Add manual payment method > Create custom payment method.
    • Tên phương thức: Chuyển khoản ngân hàng (VietQR - Dòng Tiền Pro).
    • Chi tiết bổ sung: Quét mã VietQR bằng app ngân hàng bất kỳ để đơn hàng được tự động xác nhận trong 5-10 giây.
    • Hướng dẫn thanh toán: Vui lòng giữ nguyên nội dung chuyển khoản được hiển thị tại trang cảm ơn để đơn hàng tự động hoàn tất.
    • Bấm Activate.

  3. Cấu hình Tiện ích mở rộng trang cảm ơn (Thank-you UI Extension):

    • Vào Settings > Checkout > Checkout customization.
    • Bấm Customize trên Checkout profile của bạn.
    • Chuyển sang trang Thank you (Trang cảm ơn) hoặc Order status (Trạng thái đơn hàng).
    • Bấm Add app block và chọn VietQR Payment Instruction (dongtien-thank-you-qr).
    • Kéo thả khối hiển thị lên vị trí đầu trang và bấm Save.

  4. Kiểm tra thử nghiệm: Đặt một đơn hàng thử nghiệm với phương thức vừa tạo, kiểm tra hiển thị mã QR tại trang cảm ơn và quét thanh toán thử.

Bảo mật và Cách ly Tenant (Yêu cầu R10)

Phần tiêu đề “Bảo mật và Cách ly Tenant (Yêu cầu R10)”

Tuân thủ quyền riêng tư (GDPR)

Phần tiêu đề “Tuân thủ quyền riêng tư (GDPR)”

Ứng dụng đáp ứng 100% các yêu cầu bắt buộc của Shopify về bảo vệ dữ liệu khách hàng:

  • customers/data_request: Cung cấp thông tin đối soát đơn hàng mà không lưu trữ dữ liệu cá nhân dạng thô.
  • customers/redact: Xoá bỏ các bản ghi đệm liên quan đến mã định danh khách hàng.
  • shop/redact: Thu hồi khoá uỷ quyền và xoá bỏ thông tin cấu hình cửa hàng khi gỡ cài đặt app.