Tài liệu tham khảo Vận hành

API, webhook và tích hợp

API các khóa cho Đăng nhập Nhân viên, những gì API làm, Webhook và các sự kiện của chúng, payload, chữ ký và việc thử lại, và các tích hợp sẵn sàng: Poster, Toast, SmartKasa, Make và Zapier.

Đọc nhanh

Đã cập nhật: 19 tháng 11, 2026

API & tích hợp

Khóa API trong API & tích hợp

Cài đặt → API & tích hợp có ba tab: các khóa API, Webhooks và Tích hợp.

Các khóa API và API miễn phí trên mọi gói, bao gồm Free Forever; không có tiện ích bổ sung API. Tem được cấp thông qua API là Card Operations như bất kỳ cái nào khác, vì vậy chúng sẽ dừng lại khi Card Operations của gói hết. Webhooks là phần có phí, xem bên dưới.

API có tốn thêm phí không?

Không. Các khóa API và API đều miễn phí trên mọi gói, bao gồm cả Free Forever. Tem được cấp thông qua chúng là Card Operations giống như bất kỳ loại nào khác.

Tôi có thể sử dụng API trên Free Forever không?

Có. Khi Card Operations của gói hết, tem thông qua API sẽ dừng như bất kỳ loại nào khác.

Cài đặt API ở đâu?

Trong Cài đặt → API & tích hợp, với ba tab — khóa API, Webhooks và Tích hợp.

các khóa API

Tạo khóa API cho Đăng nhập Nhân viên

Một khóa API được tạo dưới các khóa API → Thêm khóa API cho một đăng nhập Nhân viên. Một đăng nhập Nhân viên chỉ có tối đa một khóa API, và một đăng nhập Nhân viên bị tắt không thể được chọn. Nếu không có đăng nhập Nhân viên nào để chọn, cửa sổ Tạo khóa API sẽ đề nghị tạo một đăng nhập ngay tại đó; một đăng nhập Nhân viên mới cần một Staff Seat trống, và trong trường hợp kế hoạch đầy, cửa sổ sẽ đề nghị thêm một chỗ hoặc chọn một kế hoạch khác.

Mọi cuộc gọi được thực hiện với khóa API hoạt động như Đăng nhập Nhân viên của nó: nó chỉ tiếp cận Kinh doanh của Đăng nhập Nhân viên đó, đóng dấu Thẻ Tem được chọn cho nó dưới Đóng dấu Tự động, và các lần đóng dấu của nó được tính là Card Operations của Đăng nhập Nhân viên đó.

Chìa khóa có thể được xem và sao chép lại bất cứ lúc nào từ danh sách các chìa khóa API. Nó cũng có thể được hiển thị dưới dạng mã QR, để quét vào thiết bị đầu cuối, và in cùng với tên Đăng nhập Nhân viên.

Làm thế nào để tôi tạo một khóa API?

Trong các khóa Cài đặt → API & integrations → API, chọn Thêm khóa API và chọn một Đăng nhập Nhân viên. Mỗi Đăng nhập Nhân viên có tối đa một khóa API.

Tôi đã mất khóa API của mình. Tôi có cần một cái mới không?

Không. Khóa có thể được xem và sao chép lại bất cứ lúc nào từ danh sách các khóa API, hoặc hiển thị dưới dạng mã QR.

Thẻ tem nào mà API gọi là tem?

Thẻ được chọn cho Đăng nhập Nhân viên của khóa dưới tính năng đóng dấu tự động. Số lượt đóng dấu của nó được tính vào Card Operations của Đăng nhập Nhân viên đó.

Tại sao tôi không thể chọn một Đăng nhập Nhân viên cho một khóa mới?

Một Đăng nhập Nhân viên bị tắt không thể được chọn, và một Đăng nhập Nhân viên đã có khóa không thể nhận khóa thứ hai. Khi không có gì để chọn, cửa sổ sẽ gợi ý tạo một Đăng nhập Nhân viên.

Khi một phím API ngừng hoạt động

Một khóa API không hết hạn. Nó chỉ ngừng hoạt động khi nó được tạo lại hoặc xóa, hoặc khi Đăng nhập Nhân viên của nó bị tắt hoặc xóa. Mật khẩu hoặc đăng nhập mới cho Đăng nhập Nhân viên không ảnh hưởng đến nó.

  • Regenerate cung cấp cho Đăng nhập Nhân viên một API khóa mới; khóa cũ ngay lập tức ngừng hoạt động.
  • Xóa dừng phím ngay lập tức. Đăng nhập Nhân viên vẫn tiếp tục hoạt động trong 7Stamp Scanner và có thể nhận một khóa mới sau này.
  • Tắt Đăng nhập Nhân viên giữ nguyên khóa của nó: khi Đăng nhập Nhân viên được bật lại, cùng một khóa sẽ hoạt động trở lại.

Một khóa API có hết hạn không?

Không. Nó chỉ ngừng hoạt động khi được tạo lại hoặc bị xóa, hoặc khi Đăng nhập Nhân viên của nó bị tắt hoặc bị xóa.

Tôi đã thay đổi mật khẩu đăng nhập Nhân viên. Tôi có cần một chìa khóa API mới không?

Không. Mật khẩu hoặc đăng nhập mới không ảnh hưởng đến chìa khóa API.

Tôi đã bật lại một đăng nhập Nhân viên. Chìa khóa API cũ của nó có còn dùng được không?

Vâng. Tắt Đăng nhập Nhân viên giữ nguyên khóa của nó, và cùng một khóa sẽ hoạt động trở lại khi đăng nhập được bật lại.

Thì API tham chiếu đến cái gì

Thông qua API, một hệ thống có thể:

  • phát một Thẻ tem dưới dạng liên kết hoặc QR;
  • thêm tem;
  • đọc thẻ với các tem, mục tiêu và Phiếu thưởng của nó;
  • phát hành một Phiếu trực tiếp lên thẻ;
  • đổi một Phiếu bằng Mã Phiếu của nó;
  • nhắn tin cho Khách hàng.

API tìm thẻ của Khách hàng bằng định danh riêng của Doanh nghiệp, chẳng hạn như ID CRM, số điện thoại hoặc email, được gửi dưới dạng external_id. Định danh này được lưu trên thẻ và xuất hiện trong mọi Webhook liên quan. API không có cuộc gọi nào liệt kê Khách hàng của Doanh nghiệp: toàn bộ cơ sở Khách hàng chỉ được trích xuất thông qua xuất dữ liệu admin.

Thay vì sử dụng một khóa API, một ứng dụng có thể đăng nhập bằng tài khoản và mật khẩu Đăng nhập Nhân viên — cho một thiết bị mà thu ngân đăng nhập. Một khóa API phù hợp với một thiết bị hoạt động không cần giám sát. Webhook chỉ được thêm trong quản trị; API không có lệnh gọi để đăng ký sự kiện hoặc liệt kê chúng.

API không đặt giới hạn tốc độ yêu cầu: các cuộc gọi không bị hạn chế theo số lượng hay tần suất, và cùng một thẻ có thể quét lại ngay lập tức. Những gì giới hạn việc đóng dấu qua nó là Card Operations của gói.

Chúng ta có thể thêm tem thông qua CRM hoặc POS của riêng mình không?

Vâng, thông qua API. Nó phát thẻ Tem, thêm tem, đọc thẻ và đổi Phiếu. Để hệ thống của bạn được thông báo về các sự kiện, hãy thêm một Webhook — điều đó cần tiện ích bổ sung Webhooks & Events.

Chúng ta có thể xuất dữ liệu không?

Thông qua API bạn đọc thẻ bằng định danh của riêng bạn, và Webhook gửi các sự kiện ngay khi chúng xảy ra. API không có danh sách tất cả Khách hàng — toàn bộ cơ sở Khách hàng được xuất ra thông qua quản trị viên.

API tìm thẻ của Khách hàng như thế nào?

Bằng định danh của riêng bạn — một ID CRM, số điện thoại hoặc email — được gửi dưới dạng external_id. Nó được lưu trên thẻ và sẽ được gửi lại trong mọi Webhook liên quan đến thẻ đó.

Tôi có thể đăng ký Webhook thông qua API không?

Không. Webhook chỉ được thêm vào trong phần quản trị.

Liệu API có giới hạn tốc độ không?

Không. Các cuộc gọi không bị hạn chế theo số lượng hay tần suất, và cùng một thẻ có thể được quét lại ngay lập tức. Việc đóng dấu chỉ bị giới hạn bởi Card Operations của gói.

API

Tham chiếu API là công khai và không cần đăng nhập: Swagger tại https://api.7loc.com/cards-api/docs, với tệp OpenAPI tại https://api.7loc.com/cards-api/openapi.json. Các cuộc gọi đi đến https://api.7loc.com/cards-api và cần khóa API hoặc Đăng nhập Nhân viên.

Một White Label Business không thấy liên kết đến tham chiếu API trong quản trị. Các khóa API và Webhooks của nó hoạt động giống nhau.

Tài liệu API ở đâu?

Swagger tại https://api.7loc.com/cards-api/docs, công khai, không cần đăng nhập. Tệp OpenAPI ở https://api.7loc.com/cards-api/openapi.json.

Địa chỉ cơ sở cho các cuộc gọi API là gì?

https://api.7loc.com/cards-api. Các lệnh gọi cần khóa API hoặc tài khoản đăng nhập nhân viên.

Quản trị viên White Label của chúng tôi không có liên kết đến tài liệu API. API có hoạt động với chúng tôi không?

Có. Một Doanh nghiệp White Label không thấy liên kết đến tài liệu tham khảo, nhưng các khóa API và Webhooks của doanh nghiệp đó vẫn hoạt động như nhau.

Webhooks

Webhooks trong API & tích hợp

Một Webhook được thêm vào dưới API & tích hợp → Webhooks → Thêm webhook, với URL nhận các sự kiện. Trong 7Stamp một Webhook được tạo cho các sự kiện Thẻ dấu. Một Doanh nghiệp có thể thêm nhiều Webhooks, mỗi cái có URL riêng.

Webhooks cần add-on Webhooks & Events, $19 một tháng, chỉ được cung cấp trên các gói trả phí. Thêm Webhook đầu tiên cung cấp tùy chọn mua nó; nếu không có thì không thể tạo hoặc bật lại Webhook. Một add-on giữ một Webhook được bật: có thể thêm nhiều Webhook, nhưng mỗi lần cập nhật thanh toán của đăng ký sẽ tắt tất cả trừ cái lâu nhất.

Webhooks gửi các sự kiện ngay khi chúng xảy ra kể từ thời điểm Webhook được thêm. Các sự kiện trước đó sẽ không được gửi.

Webhook có miễn phí không?

Không. Chúng cần tiện ích bổ sung Webhooks & Events, $19 mỗi tháng, chỉ có trong các gói trả phí. Bản thân API là miễn phí.

Tôi đã thêm một Webhook thứ hai và nó bị tắt. Tại sao?

Một tiện ích bổ sung Webhooks & Events duy trì một Webhook được bật. Mỗi lần cập nhật thanh toán của đăng ký sẽ tắt tất cả trừ Webhook lâu nhất.

Webhook mới có gửi các sự kiện trước đó không?

Không. Các sự kiện được gửi từ thời điểm Webhook được thêm vào.

Sự kiện Webhook

Một Webhook nhận mười lăm sự kiện thẻ Tem, được đặt tên trong event_type: SCAN, DELIVERY_INSERT, RECEIPT_SCAN, CARD_JOINED, REWARD_EARNED, VOUCHER_ISSUED, VOUCHER_PACK, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED, LOTTERY_WIN, CARD_CAMPAIGN, BIRTHDAY_GREETING, AUTO_MESSAGE_VOUCHER, CARD_ADDED_TO_WALLET và CARD_REMOVED_FROM_WALLET. Hai sự kiện cuối xảy ra khi thẻ được thêm vào ví hoặc được gỡ khỏi ví, với ví, Apple hoặc Google.

Một lần quét mà không thêm con dấu, chẳng hạn như mua dưới giá đóng dấu, vẫn gửi SCAN với số con dấu thêm là không. Một giải thưởng trúng trên bánh xe được thông báo bởi một LOTTERY_WIN khi bánh xe quay, không phải bởi REWARD_EARNED hoặc VOUCHER_ISSUED; một bánh xe đang chờ quay vẫn chưa gửi gì cả.

Đánh giá của khách hàng không phải là các sự kiện Thẻ tem. Mỗi đánh giá mới gửi một sự kiện với thực thể review và hành động created, đến các Webhook đã được đánh dấu Reviews trong số các đối tượng của chúng trên trang Webhook. Một Webhook được thêm ở đây chỉ được thiết lập cho các sự kiện Thẻ tem, vì vậy nó nhận được đánh giá một khi Reviews được đánh dấu.

Có một Webhook được gửi khi một lần quét không thêm dấu không?

Có. Một lần quét không thêm dấu, chẳng hạn như mua hàng dưới giá có dấu, vẫn gửi SCAN với số dấu thêm là không.

Sự kiện nào cho tôi biết Khách hàng đã thắng trên bánh xe?

LOTTERY_WIN, gửi một lần khi vòng quay được quay. Một vòng quay đang chờ để quay thì chưa gửi gì.

Tôi có thể biết khi nào Khách hàng lấy thẻ ra khỏi ví của họ không?

Có. Thêm thẻ vào ví và gỡ thẻ ra sẽ gửi CARD_ADDED_TO_WALLET và CARD_REMOVED_FROM_WALLET, cùng với ví, Apple hoặc Google.

Làm thế nào để tôi nhận được các đánh giá khách hàng mới thông qua Webhook?

Mở trang Webhook và chọn Reviews trong số các đối tượng của nó. Mỗi đánh giá mới sau đó sẽ xuất hiện với thực thể review và hành động created; một Webhook được thêm dưới API & tích hợp chỉ nhận các sự kiện Thẻ Stamp cho đến lúc đó.

Khi mỗi sự kiện được gửi đi

Sự kiệnĐược gửi khi
SCANMột Nhân viên đăng nhập quét thẻ: trong 7Stamp Scanner, qua API hoặc từ một POS như Toast. Các con dấu bị gỡ bỏ trong 7Stamp Scanner là một SCAN với stamps_added âm
DELIVERY_INSERTMột Khách hàng mở Mã Con dấu cung cấp các con dấu — một QR, một liên kết, chính mã hoặc một lời mời được thực hiện thông qua API
RECEIPT_SCANMột Khách hàng quét biên lai thuế trong Chatbot của Doanh nghiệp và nó được đóng dấu; amount là tổng biên lai
CARD_JOINEDKhách hàng nhận được một thẻ Tem mới, bằng bất kỳ cách nào, với external_id bạn đã đưa
REWARD_EARNEDMột lần quét đạt đến mục tiêu Award
VOUCHER_ISSUEDMột lần quét đạt đến mục tiêu Voucher
LOTTERY_WINMột chiếc bánh xe Lottery được quay và cho một giải thưởng
VOUCHER_PACKMột thẻ mới nhận gói Phiếu thưởng của thẻ Tem, tất cả các Phiếu thưởng của nó trong cùng một sự kiện
ADMIN_VOUCHER_ISSUEMột Phiếu thưởng được phát thẳng vào thẻ, trong quản trị hoặc thông qua API
VOUCHER_REDEEMEDMột Phiếu thưởng trên thẻ được sử dụng: tại 7Stamp Scanner, thông qua API, tại một Toast POS hoặc bởi Khách hàng
CARD_CAMPAIGNMột Chiến dịch đến với thẻ, mỗi thẻ một lần, với Phiếu thưởng của Chiến dịch nếu có
BIRTHDAY_GREETINGLời chúc mừng sinh nhật được gửi đến thẻ, kèm theo Phiếu thưởng Sinh nhật nếu có được phát hành
AUTO_MESSAGE_VOUCHERMột kích hoạt tin nhắn tự động đặt một Phiếu quà tặng lên thẻ, bất kể kênh nào sau đó có liên hệ với Khách hàng hay không
CARD_ADDED_TO_WALLETThẻ được thêm vào Apple Wallet hoặc Google Wallet
CARD_REMOVED_FROM_WALLETThẻ được xóa khỏi ví

Mỗi mục tiêu mà một lần quét đạt được sẽ gửi sự kiện riêng của nó sau sự kiện của lần quét đó, và một mục tiêu được đạt hai lần bởi một lần quét, qua hai vòng của thẻ, sẽ gửi hai sự kiện. Một thẻ đầy đủ bắt đầu một vòng mới là cùng một thẻ và không gửi CARD_JOINED; một thẻ được phát lại sau khi quản trị viên xóa thẻ cũ thì sẽ gửi. Khi một lượt tham gia mang theo một gói Phiếu và các tem, CARD_JOINED sẽ đến trước, sau đó là VOUCHER_PACK, rồi đến DELIVERY_INSERT.

Một Mã Tem không có tem sẽ không gửi DELIVERY_INSERT, một Phiếu quà tặng được tạo trong quản trị mà không có thẻ sẽ không gửi ADMIN_VOUCHER_ISSUE, và một lần gọi API lặp lại cho một Phiếu quà tặng đã được đổi sẽ không gửi thêm VOUCHER_REDEEMED.

Sự kiện nào cho tôi biết một Khách hàng đã đạt được mục tiêu?

REWARD_EARNED cho một mục tiêu Award, VOUCHER_ISSUED cho một mục tiêu Voucher và LOTTERY_WIN cho một Lottery, mỗi cái được gửi sau sự kiện riêng của lần quét.

Có phải là Webhook được gửi khi tem bị xóa không?

Có. Tem bị xóa trong 7Stamp Scanner sẽ đến dưới dạng SCAN với stamps_added âm.

Sự khác biệt giữa VOUCHER_ISSUED và ADMIN_VOUCHER_ISSUE là gì?

VOUCHER_ISSUED xảy ra khi một lượt quét đạt đến mục tiêu Voucher. ADMIN_VOUCHER_ISSUE xảy ra khi một Voucher được phát trực tiếp vào thẻ, bằng tay trong quản trị hoặc thông qua API.

Khách hàng tham gia bằng Mã Tem gửi một sự kiện hay nhiều sự kiện?

Một vài. CARD_JOINED xuất hiện trước, sau đó là VOUCHER_PACK nếu thẻ Stamp có một gói Voucher, rồi DELIVERY_INSERT với các con tem.

Tôi có nhận được sự kiện cho mỗi tin nhắn Chiến dịch không?

CARD_CAMPAIGN được gửi một lần cho mỗi thẻ mà Chiến dịch tiếp cận, kèm theo Voucher của Chiến dịch nếu có.

Một Webhook nhận được

Mỗi sự kiện đều có cùng một thân JSON: ID sự kiện, Doanh nghiệp, và sự kiện với loại của nó, thẻ Stamp, các dấu trước và sau, số tiền mua, ID đơn hàng và external_id mà tích hợp đã gửi, Đăng nhập Nhân viên phục vụ, các Phiếu thưởng và phần thưởng nó đã trao, và tên khách hàng, email, Telegram, WhatsApp số điện thoại và ngày sinh.

amount là số tiền mua hàng theo đơn vị nhỏ (xu): một số tiền 12,50 được gửi với bản quét sẽ đến dưới dạng 1250. Nó trống khi sự kiện không có số tiền.

ID sự kiện nằm trong thân và trong tiêu đề X-Webhook-Event-Id. Việc thử lại cùng một sự kiện giữ nguyên ID của nó, vì vậy người nhận có thể loại bỏ các bản lặp lại. Đối với một Make hoặc Zapier URL, sự kiện nằm dưới khóa card_event thay vì data.

Webhook mang dữ liệu gì về Khách hàng?

Tên, email, Telegram, WhatsApp số điện thoại và ngày sinh, cùng với Thẻ tem, số tem trước và sau, và các Phiếu quà tặng và phần thưởng đã được trao.

Số tiền được tính bằng đơn vị nào?

Theo đơn vị phụ (xu). Số tiền 12,50 gửi cùng với bản quét sẽ đến dưới dạng 1250; nó là trống khi sự kiện không có số tiền.

Làm thế nào để tôi tránh xử lý cùng một sự kiện hai lần?

Sử dụng ID sự kiện, trong phần thân và trong header X-Webhook-Event-Id. Một lần thử lại giữ cùng một ID.

Tại sao sự kiện dưới card_event lại nằm trong Make?

Đối với một Make hoặc Zapier URL, sự kiện nằm dưới khóa card_event thay vì data, để ứng dụng của họ có thể phân biệt được.

Chữ ký

Mỗi lần giao hàng đều được ký. Tiêu đề X-Webhook-Signature chứa một dấu thời gian và một HMAC-SHA256 của dấu thời gian đó cùng với phần thân thô, được khóa bằng khóa bí mật của Webhook. Khóa bí mật được hiển thị và tạo lại trên trang của Webhook. Đồng thời, có thể thêm đăng nhập và mật khẩu Basic auth.

Làm thế nào để tôi kiểm tra rằng một Webhook thực sự đến từ 7Stamp?

Tính HMAC-SHA256 của dấu thời gian và nội dung thô với khóa bí mật của Webhook và so sánh nó với header X-Webhook-Signature.

Tôi có thể tìm khóa bí mật của Webhook ở đâu?

Trên trang Webhook, nơi nó cũng có thể được tạo lại.

Tôi có thể bảo vệ điểm cuối của mình bằng mật khẩu không?

Có. Một đăng nhập và mật khẩu xác thực cơ bản có thể được thêm vào Webhook, bên cạnh chữ ký.

Giao hàng thất bại

Một lần giao nhận mà không nhận được phản hồi 2xx trong vòng ba mươi giây sẽ được thử lại lên đến mười lần, mỗi lần chờ lâu hơn bốn giây so với lần trước, vì vậy các lần thử lại sẽ kết thúc trong khoảng bốn phút. Một phản hồi 429 kèm Retry-After sẽ được thử lại sau thời gian đó. Lỗi đầu tiên của một sự kiện sẽ đặt một thông báo trong quản trị viên.

Sau một trăm lần giao hàng thất bại liên tiếp, Webhook bị hệ thống chặn và không nhận được sự kiện nào nữa. Trang của nó cảnh báo trước về điều đó và có một nút Bỏ chặn; một lần giao hàng thành công sẽ đặt lại số lần thất bại.

Mỗi trang Webhook có một nhật ký về các lần gửi của nó, với yêu cầu đã gửi và câu trả lời nhận được. Gửi lại sẽ gửi cùng một sự kiện một lần nữa, chỉ tới Webhook này.

Máy chủ của tôi đã ngừng hoạt động. Các sự kiện có bị mất không?

Mỗi lần gửi sẽ được thử lại tối đa mười lần trong khoảng bốn phút. Sau đó, mở nhật ký của Webhook và sử dụng Gửi lại cho các sự kiện bạn cần.

Tại sao Webhook của tôi ngừng nhận sự kiện?

Sau một trăm lần gửi thất bại liên tiếp, nó bị hệ thống chặn. Sửa điểm cuối và nhấn Bỏ chặn trên trang Webhook.

Tôi có thể xem những gì đã được gửi tới Webhook của tôi không?

Có. Mỗi trang Webhook đều có nhật ký các lần gửi với yêu cầu đã gửi và câu trả lời nhận được.

Tab Tích hợp

Tab Tích hợp

Tab Tích hợp liệt kê các cách sẵn sàng theo nhóm:

  • Dấu tại quầy thanh toán của bạn — Poster, Toast, Của riêng bạn POS hoặc CRM và Không thấy POS của bạn?;
  • Biên lai tài chính — SmartKasa;
  • Tự động hóa — Make, Zapier và Public Swagger.

Mỗi thẻ cho biết liệu nó có cần một khóa API không. Tab cung cấp cùng một thẻ ở mọi quốc gia; chỉ các biên lai tài chính mới bị giới hạn theo quốc gia.

Khóa POS hoặc CRM của riêng bạn

Một Doanh nghiệp White Label không thấy thẻ Make, Zapier hoặc Public Swagger và không được cung cấp Poster hoặc hướng dẫn thiết lập trên 7stamp.com.

Hệ thống POS nào đã sẵn sàng để kết nối?

Poster, và Toast một khi nó được bật cho nền tảng — cho đến lúc đó nó hiển thị Sắp ra mắt. Các hệ thống khác kết nối thông qua API, với POS hoặc CRM của riêng bạn.

Liệu các tích hợp có bị giới hạn theo quốc gia không?

Không. Tab cung cấp cùng các thẻ ở mọi quốc gia. Chỉ biên lai thuế là bị giới hạn theo quốc gia.

Tại sao tôi không thấy Make và Zapier?

Chúng không được hiển thị cho một Doanh nghiệp White Label. Các khóa API và Webhook hoạt động giống nhau.

Poster

Poster là ứng dụng của chúng tôi trên thị trường Poster. Cài đặt trong Poster mở danh sách của nó, và ứng dụng được thiết lập với khóa API của Đăng nhập Nhân viên. Các con dấu của nó được tính là Card Operations của Đăng nhập Nhân viên đó.

Làm thế nào tôi kết nối Poster?

Mở Tích hợp → Poster và chọn Cài đặt trong Poster. Ứng dụng được thiết lập với khóa API của Đăng nhập Nhân viên.

Tem Poster sử dụng Card Operations của ai?

Là của Đăng nhập Nhân viên, mà khóa API của họ được ứng dụng sử dụng.

Tôi có cần một khóa API cho Poster không?

Vâng, khóa API của Đăng nhập Nhân viên.

Toast

Toast hiển thị Sắp ra mắt cho mọi Doanh nghiệp cho đến khi quyền truy cập Toast được thiết lập trên nền tảng. Đây là một công tắc cho toàn bộ nền tảng, không phải là một cài đặt của Doanh nghiệp; khi nó được bật, thẻ Toast sẽ chứa chính thiết lập đó.

Mỗi địa điểm Toast được kết nối bằng GUID của nó với một Đăng nhập Nhân viên, không có khóa API: Doanh nghiệp, Thẻ điểm và kế hoạch của Đăng nhập Nhân viên đó được áp dụng cho mọi yêu cầu Toast từ địa điểm. Một địa điểm chỉ có thể được kết nối với một Đăng nhập Nhân viên, và một Đăng nhập Nhân viên giữ một địa điểm. Các yêu cầu từ một địa điểm sẽ bị từ chối một khi nó bị ngắt kết nối, hoặc khi Đăng nhập Nhân viên của nó bị tắt hoặc bị xóa.

Mỗi Phiếu Quà tặng có thể được gán cho một sản phẩm thực đơn Toast: tại Toast POS thì nó trở thành một khoản giảm giá cho sản phẩm đó. Phiếu Quà tặng không có sản phẩm kèm theo được áp dụng như một khoản giảm giá bằng 0 trên hóa đơn, và nhân viên thu ngân sẽ trao quà trực tiếp bằng tay. Phiếu Quà tặng được đổi tại Toast POS, và một bánh xe đạt được bởi hóa đơn đã thanh toán sẽ được quay ngay lập tức. Khi Toast hủy một giao dịch, các dấu tích của nó sẽ bị thu hồi hoặc các Phiếu Quà tặng đã đổi được khôi phục.

Khách có thể tham gia tại một ki-ốt Toast hoặc màn hình hướng tới khách với số điện thoại hoặc email. Thẻ Stamp được phát ngay lập tức; khách không nhận được gì từ 7Stamp cho đến khi họ mở nó bằng cùng số điện thoại hoặc email đó.

Tại sao Toast lại hiển thị Sắp ra mắt?

Quyền truy cập Toast là một công tắc cho toàn bộ nền tảng, không phải là một cài đặt của Doanh nghiệp của bạn. Cho đến khi nó được bật, không có gì để kết nối.

Một địa điểm Toast được kết nối như thế nào?

Bằng GUID của nó với một Đăng nhập Nhân viên, mà không cần khóa API. Thẻ dấu vân tay và kế hoạch của Đăng nhập Nhân viên đó áp dụng cho mọi yêu cầu từ địa điểm này.

Điều gì xảy ra với tem khi Toast hủy một séc?

Khi Toast hoàn tác một giao dịch, tem của nó được lấy lại hoặc phiếu đổi của nó được khôi phục.

SmartKasa

SmartKasa trên tab Tích hợp

SmartKasa không cần khóa API. Đây là nguồn hóa đơn trong Quét biên lai, được thêm bởi ID cửa hàng SmartKasa hoặc bởi mã công ty để bao phủ tất cả các cửa hàng. Khách hàng quét hóa đơn SmartKasa trong Chatbot của Doanh nghiệp, và các con dấu sẽ đi đến Đăng nhập Nhân viên của nguồn hóa đơn đó.

SmartKasa là của Ukraine, và hóa đơn thuế chỉ hoạt động ở Ukraine, Slovakia, Kazakhstan và Uzbekistan.

Tôi có cần một khóa API cho SmartKasa không?

Không. SmartKasa là nguồn biên nhận trong Quét biên lai, được thêm bởi ID cửa hàng hoặc bởi mã công ty.

Khách hàng quét biên nhận SmartKasa ở đâu?

Trong Chatbot của Doanh nghiệp bạn. Các tem sẽ được gửi đến Đăng nhập Nhân viên của nguồn biên nhận đó.

Hóa đơn tài chính hoạt động ở những quốc gia nào?

Ở Ukraine, Slovakia, Kazakhstan và Uzbekistan.

Make và Zapier

Make trên tab Tích hợp

Ứng dụng 7Stamp cho Make có trong thư viện ứng dụng công khai của Make: hãy tìm 7Stamp trong bất kỳ kịch bản Make nào, hoặc sử dụng Mở trong Make trên tab Tích hợp. Ứng dụng Zapier của chúng tôi không có trong thư mục công khai của Zapier: Mở trong Zapier là lời mời thêm ứng dụng vào tài khoản Zapier riêng của Doanh nghiệp. Cả hai ứng dụng đều hoạt động với khóa API của Đăng nhập Nhân viên.

Các kịch bản và Zap của Make được khởi chạy bởi Webhook của 7Stamp, vì vậy các trình kích hoạt cần phần bổ trợ Webhooks & Events. Các hành động như thêm tem hoặc phát hành Phiếu giảm giá chỉ cần khóa API. Make và Zapier không được cung cấp cho một Doanh nghiệp White Label.

Tôi tìm ứng dụng 7Stamp trong Make và Zapier ở đâu?

Trong Make, hãy tìm 7Stamp trong bất kỳ kịch bản nào — ứng dụng có trong thư viện ứng dụng công khai của Make. Trong Zapier, ứng dụng chưa công khai, vì vậy hãy sử dụng Mở trong Zapier trên tab Tích hợp — lời mời sẽ thêm ứng dụng vào tài khoản của bạn.

Make và Zapier có cần tiện ích bổ sung Webhooks & Events không?

Trigger thì có, vì các kịch bản và Zap được khởi chạy bởi Webhook 7Stamp. Các hành động như thêm dấu hoặc phát hành Phiếu quà tặng chỉ cần khóa API.

Tôi có cần một khóa API cho Make hay Zapier không?

Có. Các ứng dụng hoạt động với khóa API của Đăng nhập Nhân viên.

Tài liệu tham khảo
Vận hành 28 tháng 10, 2026

Gói cước và thanh toán

Ba kế hoạch, một Card Operation là gì, những gì được tính và những gì miễn phí, các tiện ích bổ sung, Packages từ một Access Code và điều gì xảy ra khi thanh toán thất bại.

Đã cập nhật: 28 tháng 10, 2026

Mở bài viết
Tài liệu tham khảo
Vận hành 28 tháng 10, 2026

Quyền truy cập của nhân viên

Đăng nhập nhân viên là gì, cách tạo, thay đổi, tắt và xóa, cách nhân viên đăng nhập vào 7Stamp Scanner, họ có thể làm gì ở đó và ai sử dụng bảng quản trị.

Đã cập nhật: 28 tháng 10, 2026

Mở bài viết
Tài liệu tham khảo
Vận hành 28 tháng 10, 2026

Khách hàng và lịch sử

Danh sách thẻ tích điểm của Khách hàng, trang thẻ của một Khách hàng, xoá thẻ, nhật ký Sự kiện, những gì 7Stamp lưu giữ về một Khách hàng và cách dữ liệu của Khách hàng được xoá.

Đã cập nhật: 28 tháng 10, 2026

Mở bài viết