Tích hợp Shopify

Tài khoản và quyền

1. Cần Shopify store và tài khoản owner/admin có quyền phát triển, cài app.
2. Với Client Credentials, app và store đích phải cùng Shopify organization.
3. Cần ít nhất scope read_orders.

Tạo API app trong Dev Dashboard

1. Trong Dev Dashboard → Apps, chọn Create app → Start from Dev Dashboard.
2. Trong Versions, đặt app URL và Webhooks API version mới nhất.
3. Thêm tối thiểu read_orders vào Access scopes rồi chọn Release.
4. Sau khi Release Version, mở Home → Install app, chọn store đích, phê duyệt quyền và cài app. ORCA sẽ báo app_not_installed cho đến khi hoàn tất.
5. Lấy Client ID/Secret trong Settings để nhập vào modal kênh bán hàng ORCA.

Giá trị cấu hình Version

1. App URL: mọi người dùng tích hợp ORCA đều nhập https://shopify.dev/apps/default-app-home. Đây không phải URL riêng của từng store.
2. Chỉ dùng HTTPS app URL của bạn khi đã tự phát triển và triển khai giao diện Shopify app riêng; trường hợp này không áp dụng cho tích hợp ORCA thông thường.
3. Embed app in Shopify admin: bỏ chọn.
4. Preferences URL: để trống.
5. Webhooks API version: chọn 2026-07.
6. API access scopes: thêm read_orders.
7. Optional scopes, redirect URL và app proxy: để trống.
8. Legacy install flow và POS: không chọn.
9. Chọn Release sau khi hoàn tất.

Cấp và kiểm tra token qua ORCA

1. Mở Settings trong Dev Dashboard để lấy Client ID và Client Secret.
2. Mở ORCA → Quản lý tích hợp → Kênh bán hàng → thêm Shopify.
3. Nhập tên kênh, Store URL myshopify.com, Client ID và Client Secret. Tên kênh chỉ là nhãn hiển thị trong ORCA nên không cần giống subdomain, nhưng Store URL phải chính xác.
4. Chạy kiểm tra kết nối; Platform cấp token và xác minh kết nối API chính thức.
5. Lưu sau khi thành công. Client Secret được mã hóa và token không được hiển thị.

Tài liệu Shopify chính thức

1. Shopify APIs, libraries, and tools ↗
2. Create apps using the Dev Dashboard ↗
3. GraphQL Admin API 2026-07 ↗

Đăng ký trong ORCA

1. Mở ORCA → Quản lý tích hợp → Kênh bán hàng.
2. Chọn thêm kênh → Shopify.
3. Nhập tên, Store URL, Client ID và Client Secret.
4. Lưu sau khi Platform cấp token và test kết nối thành công.

ORCA Sales Channel Management →

Bảo mật

1. Không để Client Secret trong tài liệu, chat, shell history hoặc log.
2. Chỉ cấp scope tối thiểu.
3. Platform mã hóa Client Secret và tự động cấp lại token hết hạn. ORCA không hiển thị secret hoặc token đầy đủ.
4. Với app_not_installed, vào Dev Dashboard → app Home → Install app, cài app vào Store đã nhập, phê duyệt quyền rồi kiểm tra lại.
5. Với shop_not_permitted, xác nhận app và Store thuộc cùng Shopify organization và app đã được cài trên Store.

Tài liệu xác thực chính thức của Shopify ↗