Tài khoản và môi trường
- Cần site WordPress đã kích hoạt WooCommerce và quyền administrator.
- Không cần tài khoản developer WooCommerce riêng.
- Trong WordPress Admin → Settings → Permalinks, lưu lựa chọn khác Plain; nên dùng Post name.
- Xác nhận URL gốc của store có chứng chỉ HTTPS hợp lệ và truy cập được từ bên ngoài.
Cấp Consumer Key/Secret
- Đăng nhập WordPress Admin của WooCommerce store.
- Mở WooCommerce → Settings → Advanced → REST API.
- Chọn Create an API key hoặc Add key.
- Nhập mô tả dễ nhận biết như 'ORCA order integration'.
- Chọn administrator hoặc user tích hợp riêng sẽ luôn hoạt động.
- Đặt Permissions là Read.
- Tạo key rồi sao chép ngay Consumer Key bắt đầu bằng ck_ và Consumer Secret bắt đầu bằng cs_. Secret chỉ hiển thị một lần.
Đăng ký trong ORCA
- Mở ORCA → Quản lý tích hợp → Kênh bán hàng.
- Chọn thêm kênh → WooCommerce.
- Nhập tên store dễ nhận biết làm tên kênh.
- Nhập HTTPS base URL không có /wp-admin hoặc /wp-json, ví dụ https://shop.example.com.
- Nhập Consumer Key và Consumer Secret đã sao chép.
- Chạy test kết nối và lưu sau khi thành công.
ORCA Sales Channel Management →
Bảo mật
- Dùng WordPress REST API hiện tại, không dùng Legacy REST API.
- Với 401/403, kiểm tra Key/Secret, trạng thái user và quyền Read.
- Với 404, kiểm tra Permalinks và /wp-json/wc/v3.
- Với lỗi SSL, kiểm tra hạn và chuỗi chứng chỉ HTTPS.
- Không thể khôi phục Secret đã mất; hãy thu hồi và tạo key mới.