← Tất cả tích hợp

Kết nối Pancake POS với omniVN

Có thể kết nối

Có thể kết nối. Cần API key và shopId từ Pancake POS Open API.

Kết nối Pancake POSTạo tài khoản và làm theo hướng dẫn bên dưới — dùng thử 14 ngày.

Tổng quan

Pancake POS Open API (https://pos.pages.fm/api/v1) xác thực bằng API key (query api_key hoặc theo OpenAPI). shopId là id cửa hàng trả về từ GET /shops.

Điều kiện trước khi bắt đầu

  • Tài khoản Pancake POS với quyền cấu hình shop.
  • Quyền truy cập Cấu hình → Nâng cao → Kết nối bên thứ 3.

Các bước lấy credential

1. Tạo API key trên Pancake POS

Theo OpenAPI chính thức: vào Cấu hình → Nâng cao → Kết nối bên thứ 3 → Webhook/API. Trong khung API KEY, chọn Thêm mới (Create). API key có quyền admin — không chia sẻ công khai.

2. Lấy shopId

Gọi GET https://pos.pages.fm/api/v1/shops?api_key=YOUR_KEY (hoặc header theo OpenAPI). Trường id trong mỗi shop là shopId cần nhập vào Omni0.

3. Xác thực request

Mọi request gửi tới pos.pages.fm/api/v1 kèm API key hợp lệ. Chi tiết từng endpoint: https://docs.pancake.biz/pos/api/

4. Điền vào Omni0

Integrations → Pancake POS. Nhập API key và shopId.

Ánh xạ credential với omniVN

Cột "Lấy từ đâu" cho biết giá trị do người dùng nhập, do provider cấp, do omniVN quản lý, hay do OAuth sinh ra.
Field omniVNTên trong tài liệu officialBắt buộcLấy từ đâu
Pancake POS API keyAPI keyBắt buộcprovider_generated

Tạo trong Pancake POS dưới phần cấu hình API. Có quyền admin, cần bảo mật.

Pancake POS shop IDShop IDBắt buộcuser_entered

apiKey → Pancake POS API key; shopId → Shop ID (id từ GET /shops).

Vòng đời token

API key không hết hạn tự động; thu hồi bằng cách xóa/regenerate trên Pancake POS.

Lỗi thường gặp

Lỗi xác thực

API key sai, đã bị xóa, hoặc shopId không thuộc key đó.

Nguồn chính thức

Lấy API key & xác thực
docs.pancake.biz·Công khai·Đã kiểm chứng 2026-08-31
Pancake POS OpenAPI
docs.pancake.biz·Công khai·Đã kiểm chứng 2026-08-29