API และการบูรณาการ

การตั้งค่า → API & การบูรณาการมีสามแท็บ: API คีย์, Webhooks และบูรณาการ
ปุ่ม API และ API นั้นฟรีในทุกแผน รวมถึง Free Forever ด้วย ไม่มีส่วนเสริม API แสตมป์ที่มอบให้ผ่าน API จะเป็น Card Operations เช่นเดียวกับแสตมป์อื่นๆ ดังนั้นแสตมป์จะหยุดเมื่อแผน Card Operations หมดลง Webhooks เป็นส่วนที่ต้องชำระเงิน ดูด้านล่าง
API มีค่าใช้จ่ายเพิ่มเติมหรือไม่
ไม่ คีย์ API และ API นั้นฟรีในทุกแผน โดยมี Free Forever รวมอยู่ด้วย แสตมป์ที่ให้ผ่านคือ Card Operations เหมือนแสตมป์อื่นๆ
ฉันสามารถใช้ API กับ Free Forever ได้หรือไม่
ใช่. เมื่อแผน Card Operations หมดลง การประทับตราผ่าน API จะหยุดเหมือนเดิม
การตั้งค่า API อยู่ที่ไหน?
ใน การตั้งค่า → API & การบูรณาการ โดยมีสามแท็บ — API คีย์, Webhooks และ Integrations
API คีย์

คีย์ API ถูกสร้างขึ้นภายใต้ API คีย์ → เพิ่ม API คีย์สำหรับการเข้าสู่ระบบของพนักงานหนึ่งครั้ง การเข้าสู่ระบบของพนักงานมีคีย์ API ได้สูงสุดหนึ่งคีย์ และไม่สามารถเลือกการเข้าสู่ระบบของพนักงานที่ถูกปิดอยู่ได้ เนื่องจากไม่มีการเข้าสู่ระบบของพนักงานให้เลือก หน้าต่างสร้างคีย์ API เสนอให้สร้างขึ้นที่นั่น การเข้าสู่ระบบของพนักงานใหม่ต้องใช้ Staff Seat ฟรี และในแผนเต็ม หน้าต่างจะเสนอให้เพิ่มที่นั่งหรือเลือกแผนแทน
ทุกการโทรด้วยคีย์ API จะทำหน้าที่เป็นการเข้าสู่ระบบของพนักงาน โดยจะเข้าถึงเฉพาะธุรกิจของการเข้าสู่ระบบของพนักงานเท่านั้น จากนั้นจะประทับตราบัตรแสตมป์ที่เลือกไว้ภายใต้การประทับตราอัตโนมัติ และแสตมป์ของมันจะนับเป็น Card Operations ของการเข้าสู่ระบบของพนักงาน
คุณสามารถดูและคัดลอกคีย์อีกครั้งได้ตลอดเวลาจากรายการคีย์ API นอกจากนี้ยังสามารถแสดงเป็นรหัส QR เพื่อสแกนลงในเทอร์มินัล และพิมพ์ด้วยชื่อการเข้าสู่ระบบของพนักงาน
ฉันจะสร้างคีย์ API ได้อย่างไร
ในคีย์ การตั้งค่า → API & integrateds → API เลือกปุ่มเพิ่ม API และเลือกการเข้าสู่ระบบของพนักงาน การเข้าสู่ระบบของพนักงานแต่ละครั้งจะมีคีย์ API ไม่เกินหนึ่งคีย์
ฉันทำคีย์ API หาย ฉันต้องการอันใหม่หรือไม่?
ไม่ คุณสามารถดูและคัดลอกคีย์อีกครั้งได้ตลอดเวลาจากรายการคีย์ API หรือแสดงเป็นรหัส QR
แสตมป์ใบไหนที่ API เรียกว่าแสตมป์?
รายการที่เลือกสำหรับการเข้าสู่ระบบของพนักงานของคีย์ภายใต้การประทับตราอัตโนมัติ แสตมป์จะนับเป็น Card Operations ของการเข้าสู่ระบบของพนักงาน
เหตุใดฉันจึงไม่สามารถเลือกการเข้าสู่ระบบของพนักงานสำหรับรหัสใหม่ได้
ไม่สามารถเลือกการเข้าสู่ระบบของพนักงานที่ปิดอยู่ได้ และการเข้าสู่ระบบของพนักงานที่มีรหัสอยู่แล้วจะไม่สามารถรับรหัสที่สองได้ เมื่อไม่มีใครเลือก หน้าต่างจะเสนอให้สร้างการเข้าสู่ระบบของพนักงาน
เมื่อปุ่ม API หยุดทำงาน
คีย์ API ไม่มีวันหมดอายุ จะหยุดทำงานเฉพาะเมื่อมีการสร้างใหม่หรือลบออก หรือเมื่อปิดหรือลบการเข้าสู่ระบบของพนักงาน รหัสผ่านใหม่หรือการเข้าสู่ระบบสำหรับการเข้าสู่ระบบของพนักงานจะไม่ส่งผลต่อมัน
- สร้างใหม่ ให้รหัส API ใหม่แก่การเข้าสู่ระบบของพนักงาน อันเก่าหยุดทำงานทันที
- Delete หยุดคีย์พร้อมกัน การเข้าสู่ระบบของพนักงานนั้นยังคงทำงานใน 7Stamp Scanner และสามารถรับรหัสใหม่ได้ในภายหลัง
- การปิดการเข้าสู่ระบบของพนักงานจะเก็บคีย์ไว้: เมื่อเปิดการเข้าสู่ระบบของพนักงานอีกครั้ง คีย์เดิมจะทำงานอีกครั้ง
คีย์ API มีวันหมดอายุหรือไม่
ไม่ มันจะหยุดทำงานเฉพาะเมื่อมีการสร้างใหม่หรือลบออก หรือเมื่อปิดหรือลบการเข้าสู่ระบบของพนักงานเท่านั้น
ฉันเปลี่ยนรหัสผ่านเข้าสู่ระบบของพนักงาน ฉันจำเป็นต้องมีคีย์ API ใหม่หรือไม่
ไม่ รหัสผ่านใหม่หรือการเข้าสู่ระบบไม่ส่งผลต่อคีย์ API
ฉันเปิดการเข้าสู่ระบบของพนักงานอีกครั้ง คีย์ API แบบเก่าใช้งานได้หรือไม่
ใช่. การปิดการเข้าสู่ระบบของพนักงานจะเก็บรหัสไว้ และรหัสเดิมจะทำงานอีกครั้งเมื่อเปิดอีกครั้ง
API ทำอะไรบ้าง
ผ่าน API ระบบสามารถ:
- แจกบัตรแสตมป์เป็นลิงค์หรือ QR;
- เพิ่มแสตมป์
- อ่านการ์ดที่มีตราประทับ เป้าหมาย และบัตรกำนัล
- ออก Voucher ตรงไปที่บัตร;
- แลกบัตรกำนัลด้วยรหัสบัตรกำนัล;
- ส่งข้อความถึงลูกค้า
API ค้นหาบัตรของลูกค้าตามตัวระบุของธุรกิจ เช่น CRM ID โทรศัพท์หรืออีเมล ส่งเป็น external_id ตัวระบุจะถูกจัดเก็บไว้ในการ์ดและกลับมาในทุก Webhook เกี่ยวกับการ์ด API ไม่มีการเรียกที่แสดงรายการลูกค้าของธุรกิจ: ฐานลูกค้าทั้งหมดถูกนำออกผ่านการส่งออกของผู้ดูแลระบบเท่านั้น
แทนที่จะใช้คีย์ API แอปสามารถลงชื่อเข้าใช้ด้วยข้อมูลเข้าสู่ระบบและรหัสผ่านของการเข้าสู่ระบบของพนักงาน สำหรับอุปกรณ์ที่แคชเชียร์ลงชื่อเข้าใช้ ปุ่ม API เหมาะกับอุปกรณ์ที่ทำงานโดยไม่มีใครดูแล Webhooks จะถูกเพิ่มในผู้ดูแลระบบเท่านั้น API ไม่มีการเรียกร้องให้สมัครรับกิจกรรมหรือแสดงรายการ
API ไม่มีการจำกัดอัตราการร้องขอ: การโทรไม่ได้จำกัดตามหมายเลขหรือความถี่ และสามารถสแกนการ์ดใบเดิมอีกครั้งได้ทันที สิ่งที่จำกัดการประทับผ่านคือ Card Operations ของแผน
เราสามารถเพิ่มแสตมป์จาก CRM หรือ POS ของเราเองได้หรือไม่?
ใช่ ผ่าน API แจกแสตมป์ เพิ่มแสตมป์ อ่านการ์ด และแลกบัตรกำนัล หากต้องการให้ระบบของคุณทราบเกี่ยวกับเหตุการณ์ต่างๆ ให้เพิ่ม Webhook ซึ่งจำเป็นต้องมีส่วนเสริม Webhooks & Events
เราสามารถส่งออกข้อมูลได้หรือไม่?
คุณสามารถอ่านการ์ดด้วยตัวระบุของคุณเองผ่าน API และ Webhooks จะส่งเหตุการณ์ที่เกิดขึ้น API ไม่มีรายชื่อลูกค้าทั้งหมด — ฐานลูกค้าทั้งหมดถูกนำออกผ่านการส่งออกของผู้ดูแลระบบ
API ค้นหาบัตรของลูกค้าได้อย่างไร
โดยตัวระบุของคุณเอง — CRM ID โทรศัพท์หรืออีเมล — ส่งเป็น external_id มันถูกจัดเก็บไว้ในการ์ดและกลับมาใน Webhook ทุกอันเกี่ยวกับการ์ดนั้น
ฉันสามารถสมัครสมาชิก Webhooks ผ่าน API ได้หรือไม่
ไม่ Webhooks จะถูกเพิ่มในส่วนผู้ดูแลระบบเท่านั้น
API มีขีดจำกัดอัตราหรือไม่?
ไม่ การโทรไม่ได้ถูกควบคุมด้วยหมายเลขหรือความถี่ และสามารถสแกนบัตรเดิมอีกครั้งได้ทันที การตอกถูกจำกัดโดย Card Operations ของแผนเท่านั้น
API ข้อมูลอ้างอิง
เอกสารอ้างอิง API เป็นสาธารณะและไม่ต้องลงชื่อเข้าใช้: Swagger อยู่ที่ https://api.7loc.com/cards-api/docs, และไฟล์ OpenAPI อยู่ที่ https://api.7loc.com/cards-api/openapi.json. คำขอเรียกใช้จะส่งไปที่ https://api.7loc.com/cards-api และต้องใช้ API key หรือการเข้าสู่ระบบของพนักงาน
White Label ธุรกิจไม่เห็นลิงก์ไปยังการอ้างอิง API ในผู้ดูแลระบบ ปุ่ม API และ Webhooks ทำงานเหมือนกัน
เอกสาร API อยู่ที่ไหน
Swagger ที่ https://api.7loc.com/cards-api/docs, สาธารณะ โดยไม่จำเป็นต้องลงชื่อเข้าใช้ ไฟล์ OpenAPI อยู่ที่ https://api.7loc.com/cards-api/openapi.json.
ที่อยู่ฐานสำหรับการโทร API คืออะไร
https://api.7loc.com/cards-api. การโทรต้องใช้รหัส API หรือการเข้าสู่ระบบของพนักงาน
ผู้ดูแลระบบ White Label ของเราไม่มีลิงก์เอกสาร API ใช้งานได้กับเราหรือไม่?
ใช่. White Label Business ไม่เห็นลิงก์ไปยังข้อมูลอ้างอิง แต่คีย์ API และ Webhooks ทำงานเหมือนกัน
เว็บฮุค

Webhook ถูกเพิ่มภายใต้ API & การบูรณาการ → Webhooks → เพิ่ม webhook โดยมี URL ที่ได้รับเหตุการณ์ ใน 7Stamp Webhook จะถูกสร้างขึ้นสำหรับกิจกรรมการ์ดแสตมป์ ธุรกิจสามารถเพิ่ม Webhooks ได้หลายรายการ โดยแต่ละรายการมี URL ของตัวเอง
Webhooks ต้องการส่วนเสริม Webhooks & Events $19 ต่อเดือน ซึ่งให้บริการในแผนแบบชำระเงินเท่านั้น การเพิ่มข้อเสนอ Webhook แรกเพื่อซื้อ หากไม่มี Webhook จะไม่สามารถสร้างหรือเปิดใหม่ได้ ส่วนเสริมหนึ่งรายการช่วยให้ Webhook หนึ่งรายการเปิดอยู่: สามารถเพิ่มรายการอื่นได้ แต่การอัปเดตการเรียกเก็บเงินแต่ละรายการจะปิดทั้งหมด ยกเว้นรายการเก่าที่สุด
Webhooks จะส่งเหตุการณ์ที่เกิดขึ้นทันทีที่มีการเพิ่ม Webhook กิจกรรมก่อนหน้านี้จะไม่ถูกส่ง
Webhooks ฟรีหรือไม่?
ไม่ พวกเขาต้องการโปรแกรมเสริม Webhooks & Events $19 ต่อเดือน ซึ่งให้บริการในแผนแบบชำระเงินเท่านั้น API นั้นฟรี
ฉันเพิ่ม Webhook อันที่สองแล้ว และมันถูกปิดไป ทำไม
ส่วนเสริม Webhooks & Events หนึ่งรายการจะเปิด Webhook หนึ่งรายการไว้ การอัปเดตการเรียกเก็บเงินแต่ละครั้งของการสมัครสมาชิกจะปิดทั้งหมดยกเว้นอันที่เก่าที่สุด
Webhook ใหม่จะส่งกิจกรรมที่ผ่านมาหรือไม่
ไม่ กิจกรรมจะถูกส่งไปทันทีที่มีการเพิ่ม Webhook
กิจกรรมเว็บฮุค
Webhook ได้รับกิจกรรมการ์ดแสตมป์สิบห้าเหตุการณ์ โดยมีชื่ออยู่ใน 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 และ CARD_REMOVED_FROM_WALLET สองอันสุดท้ายเกิดขึ้นเมื่อเพิ่มบัตรลงในกระเป๋าเงินหรือลบออกจากกระเป๋าเงินหนึ่งใบด้วยกระเป๋าเงิน Apple หรือ Google
การสแกนที่ไม่เพิ่มการประทับตรา เช่น การซื้อที่ต่ำกว่าราคาแสตมป์ ยังคงส่ง SCAN โดยที่เพิ่มแสตมป์เป็นศูนย์ รางวัลที่ได้รับบนวงล้อจะประกาศโดย LOTTERY_WIN หนึ่งอันเมื่อวงล้อหมุน ไม่ใช่ REWARD_EARNED หรือ VOUCHER_ISSUED; วงล้อที่รอหมุนยังไม่ได้ส่งอะไรเลย
รีวิวจากลูกค้าไม่ใช่งานกิจกรรมบัตรแสตมป์ บทวิจารณ์ใหม่ทุกครั้งจะส่งเหตุการณ์ที่มีเอนทิตี review และการดำเนินการ created ไปยัง Webhooks ที่มีการทำเครื่องหมายบทวิจารณ์ไว้ระหว่างออบเจ็กต์ในหน้าของ Webhook Webhook ที่เพิ่มที่นี่ได้รับการตั้งค่าสำหรับกิจกรรมการ์ดแสตมป์เท่านั้น ดังนั้นจึงจะได้รับการตรวจสอบเมื่อมีการเลือกบทวิจารณ์
Webhook ถูกส่งเมื่อการสแกนไม่มีการประทับตราหรือไม่
ใช่. การสแกนที่ไม่เพิ่มการประทับตรา เช่น การซื้อที่ต่ำกว่าราคาแสตมป์ ยังคงส่ง SCAN โดยเพิ่มตราประทับเป็นศูนย์
เหตุการณ์ใดที่บอกฉันว่าลูกค้าชนะบนพวงมาลัย?
LOTTERY_WIN ส่งครั้งเดียวเมื่อวงล้อหมุน วงล้อที่รอการหมุนยังไม่ได้ส่งสิ่งใดเลย
ฉันสามารถบอกได้ไหมว่าเมื่อใดที่ลูกค้านำบัตรออกจากกระเป๋าเงินของพวกเขา?
ใช่. การเพิ่มบัตรผ่านไปยังกระเป๋าเงินและนำออก จะส่ง CARD_ADDED_TO_WALLET และ CARD_REMOVED_FROM_WALLET ด้วยกระเป๋าเงิน Apple หรือ Google
ฉันจะได้รับรีวิวจากลูกค้าใหม่ผ่าน Webhook ได้อย่างไร
เปิดหน้าของ Webhook และทำเครื่องหมายรีวิวระหว่างออบเจ็กต์ การตรวจสอบใหม่ทุกครั้งจะมาถึงพร้อมกับการตรวจสอบเอนทิตีและการดำเนินการที่สร้างขึ้น Webhook ที่เพิ่มภายใต้ API & การผสานรวมจะได้รับกิจกรรมการ์ดแสตมป์จนถึงตอนนั้นเท่านั้น
เมื่อแต่ละเหตุการณ์ถูกส่งไป
| เหตุการณ์ | ส่งเมื่อ |
|---|---|
SCAN | การเข้าสู่ระบบของพนักงานจะสแกนการ์ด: ใน 7Stamp Scanner ผ่าน API หรือจาก POS เช่น Toast แสตมป์ที่ถูกลบออกใน 7Stamp Scanner คือ SCAN โดยมีเครื่องหมายลบ stamps_added |
DELIVERY_INSERT | ลูกค้าเปิดรหัสแสตมป์ที่ให้แสตมป์ — QR ลิงก์ รหัสนั้นเอง หรือคำเชิญที่ส่งผ่าน API |
RECEIPT_SCAN | ลูกค้าสแกนใบเสร็จทางการเงินใน Chatbot ของธุรกิจและมีการประทับตรา amount คือยอดรวมใบเสร็จ |
CARD_JOINED | ลูกค้าจะได้รับบัตรแสตมป์ใหม่ ไม่ว่าจะด้วยวิธีใดก็ตาม โดยมี external_id ที่คุณผ่าน |
REWARD_EARNED | การสแกนบรรลุเป้าหมาย Award |
VOUCHER_ISSUED | การสแกนบรรลุเป้าหมายของ Voucher |
LOTTERY_WIN | วงล้อ Lottery หมุนแล้วให้รางวัล |
VOUCHER_PACK | การ์ดใหม่จะได้รับซองบัตรกำนัลของการ์ด Stamp รวมถึงบัตรกำนัลทั้งหมดในกิจกรรมเดียว |
ADMIN_VOUCHER_ISSUE | บัตรกำนัลจะออกตรงไปยังบัตรในผู้ดูแลระบบหรือผ่านทาง API |
VOUCHER_REDEEMED | มีการแลกบัตรกำนัลบนบัตร: ใน 7Stamp Scanner ผ่าน API ที่ Toast POS หรือโดยลูกค้า |
CARD_CAMPAIGN | แคมเปญเข้าถึงการ์ดได้หนึ่งครั้งต่อการ์ด พร้อมด้วยบัตรกำนัลของแคมเปญหากมี |
BIRTHDAY_GREETING | คำอวยพรวันเกิดจะถูกส่งไปยังการ์ด พร้อมด้วยบัตรกำนัลวันเกิด หากมีการออก |
AUTO_MESSAGE_VOUCHER | ทริกเกอร์ข้อความอัตโนมัติจะวางบัตรกำนัลบนการ์ด ไม่ว่าช่องทางนั้นจะไปถึงลูกค้าหรือไม่ก็ตาม |
CARD_ADDED_TO_WALLET | เพิ่มบัตรผ่านไปที่ Apple Wallet หรือ Google Wallet |
CARD_REMOVED_FROM_WALLET | บัตรผ่านจะถูกลบออกจากกระเป๋าเงิน |
แต่ละเป้าหมายที่การสแกนไปถึงจะส่งเหตุการณ์ของตัวเองหลังจากการสแกนหนึ่งครั้ง และเป้าหมายถึงสองครั้งในการสแกนหนึ่งครั้ง ในการ์ดสองรอบ จะส่งสองครั้ง ไพ่เต็มใบที่เริ่มรอบใหม่จะเป็นไพ่ใบเดิมและไม่มีการส่ง CARD_JOINED; บัตรที่ออกอีกครั้งหลังจากที่ผู้ดูแลระบบลบบัตรเก่าออก เมื่อการเข้าร่วมนำชุดบัตรกำนัลและแสตมป์มาด้วย CARD_JOINED มาก่อน จากนั้น VOUCHER_PACK และ DELIVERY_INSERT
รหัสแสตมป์ที่ไม่มีการประทับตราจะส่งหมายเลข DELIVERY_INSERT บัตรกำนัลที่สร้างโดยผู้ดูแลระบบโดยไม่มีบัตรจะส่งหมายเลข ADMIN_VOUCHER_ISSUE และการเรียก API ซ้ำ ๆ เพื่อขอบัตรกำนัลที่แลกไปแล้วจะไม่ส่ง VOUCHER_REDEEMED เลย
เหตุการณ์ใดที่บอกฉันว่าลูกค้าบรรลุเป้าหมาย
REWARD_EARNED สำหรับเป้าหมาย Award, VOUCHER_ISSUED สำหรับเป้าหมาย Voucher และ LOTTERY_WIN สำหรับ Lottery โดยแต่ละรายการจะถูกส่งหลังจากเหตุการณ์ของการสแกน
Webhook ถูกส่งไปเมื่อมีการลบแสตมป์หรือไม่
ใช่. แสตมป์ที่ถูกลบออกใน 7Stamp Scanner มาถึงในรูปแบบ SCAN โดยมี stamps_added ติดลบ
VOUCHER_ISSUED และ ADMIN_VOUCHER_ISSUE แตกต่างกันอย่างไร
VOUCHER_ISSUED เกิดขึ้นเมื่อการสแกนบรรลุเป้าหมาย Voucher ADMIN_VOUCHER_ISSUE เกิดขึ้นเมื่อออกบัตรกำนัลโดยตรงไปยังบัตรด้วยมือในผู้ดูแลระบบหรือผ่าน API
ลูกค้าที่เข้าร่วมด้วยรหัสแสตมป์ส่งกิจกรรมเดียวหรือหลายกิจกรรมหรือไม่
หลาย. CARD_JOINED มาก่อน จากนั้น VOUCHER_PACK หากการ์ดแสตมป์มีชุดบัตรกำนัล จากนั้น DELIVERY_INSERT พร้อมแสตมป์
ฉันจะได้รับกิจกรรมสำหรับแต่ละข้อความของแคมเปญหรือไม่
CARD_CAMPAIGN จะถูกส่งหนึ่งครั้งสำหรับการ์ดแต่ละใบที่แคมเปญเข้าถึง พร้อมด้วยบัตรกำนัลของแคมเปญเมื่อมีหนึ่งใบ
สิ่งที่ Webhook ได้รับ
ทุกกิจกรรมจะมีเนื้อหา JSON เหมือนกัน: กิจกรรม ID, ธุรกิจ และกิจกรรมที่มีประเภท, การ์ดแสตมป์, แสตมป์ก่อนและหลัง, จำนวนการซื้อ, คำสั่งซื้อ ID และ external_id การบูรณาการที่ส่งไป, การเข้าสู่ระบบของพนักงานที่ให้บริการ, บัตรกำนัลและรางวัลที่มอบให้ และชื่อของลูกค้า อีเมล Telegram, WhatsApp โทรศัพท์ และวันเดือนปีเกิด
amount คือจำนวนเงินที่ซื้อในหน่วยรอง (เซนต์): จำนวน 12.50 ที่ส่งพร้อมกับการสแกนมาถึงเป็น 1250 จะว่างเปล่าเมื่อเหตุการณ์ไม่มีจำนวนเงิน
เหตุการณ์ ID อยู่ในเนื้อหาและในส่วนหัว X-Webhook-Event-Id การลองเหตุการณ์เดิมซ้ำจะคง ID เอาไว้ ดังนั้นผู้รับจึงสามารถปล่อยการทำซ้ำได้ สำหรับ Make หรือ Zapier URL เหตุการณ์จะอยู่ภายใต้คีย์ card_event แทนที่จะเป็น data
Webhook มีข้อมูลอะไรบ้างเกี่ยวกับลูกค้า
ชื่อ อีเมล Telegram WhatsApp โทรศัพท์ และวันเดือนปีเกิด พร้อมด้วยบัตรแสตมป์ แสตมป์ก่อนและหลัง บัตรกำนัลและรางวัลที่มอบให้
เป็นจำนวนเงินในหน่วยใด?
ในหน่วยย่อย (เซนต์) จำนวน 12.50 ที่ส่งพร้อมกับการสแกนมาถึงเมื่อ 1250; มันว่างเปล่าเมื่อเหตุการณ์ไม่มีจำนวนเงิน
ฉันจะหลีกเลี่ยงการประมวลผลเหตุการณ์เดียวกันสองครั้งได้อย่างไร
ใช้เหตุการณ์ ID ในส่วนเนื้อหาและในส่วนหัว X-Webhook-Event-Id การลองใหม่จะคง ID เหมือนเดิม
เหตุใดเหตุการณ์จึงอยู่ภายใต้ card_event ใน Make
สำหรับ Make หรือ Zapier URL กิจกรรมจะอยู่ใต้คีย์ card_event แทนที่จะเป็น data ดังนั้นแอปจึงสามารถแยกความแตกต่างได้
ลายเซ็น
การส่งมอบทุกครั้งมีการลงนาม ส่วนหัว X-Webhook-Signature เก็บการประทับเวลาและ HMAC-SHA256 ของการประทับเวลานั้นและเนื้อหาดิบ ซึ่งคีย์ด้วยรหัสลับของ Webhook รหัสลับจะแสดงและสร้างใหม่บนหน้าของ Webhook สามารถเพิ่มการเข้าสู่ระบบและรหัสผ่านการรับรองความถูกต้องขั้นพื้นฐานได้เช่นกัน
ฉันจะตรวจสอบได้อย่างไรว่า Webhook มาจาก 7Stamp จริงๆ
คำนวณ HMAC-SHA256 ของการประทับเวลาและเนื้อหาดิบด้วยคีย์ลับของ Webhook แล้วเปรียบเทียบกับส่วนหัว X-Webhook-Signature
ฉันจะหารหัสลับของ Webhook ได้ที่ไหน
ในหน้าของ Webhook ซึ่งสามารถสร้างใหม่ได้เช่นกัน
ฉันสามารถปกป้องปลายทางของฉันด้วยรหัสผ่านได้หรือไม่
ใช่. คุณสามารถเพิ่มการเข้าสู่ระบบและรหัสผ่านการตรวจสอบสิทธิ์พื้นฐานลงใน Webhook ได้ ที่ด้านบนของลายเซ็น
การส่งมอบล้มเหลว
การส่งที่ไม่ได้รับคำตอบ 2xx ภายในสามสิบวินาทีจะต้องลองใหม่สูงสุดสิบครั้ง โดยแต่ละครั้งจะรอนานกว่าครั้งล่าสุดสี่วินาที ดังนั้นการลองใหม่จะสิ้นสุดภายในประมาณสี่นาที คำตอบ 429 พร้อม Retry-After จะถูกลองอีกครั้งหลังจากนั้น ความล้มเหลวครั้งแรกของกิจกรรมจะทำให้มีการแจ้งเตือนในผู้ดูแลระบบ
หลังจากการส่งมอบล้มเหลวร้อยครั้งติดต่อกัน Webhook จะถูกบล็อกโดยระบบและไม่มีเหตุการณ์อีกต่อไป หน้ามันเตือนก่อนหน้านั้นและมีปุ่มเลิกบล็อก การจัดส่งที่สำเร็จหนึ่งครั้งจะรีเซ็ตการนับ
เพจของ Webhook แต่ละเพจมีบันทึกการจัดส่ง โดยมีคำขอที่ส่งไปและได้รับคำตอบแล้ว ส่งอีกครั้งจะส่งกิจกรรมเดิมอีกครั้งไปที่ Webhook นี้เท่านั้น
เซิร์ฟเวอร์ของฉันล่ม เหตุการณ์หายไปหรือไม่?
การจัดส่งแต่ละครั้งจะพยายามซ้ำสูงสุด 10 ครั้งภายในเวลาประมาณสี่นาที หลังจากนั้น ให้เปิดบันทึกของ Webhook และใช้ Resend สำหรับกิจกรรมที่คุณต้องการ
เหตุใด Webhook ของฉันจึงหยุดรับกิจกรรม?
หลังจากการส่งมอบล้มเหลวนับร้อยครั้งติดต่อกัน ระบบจะบล็อกไว้ แก้ไขจุดสิ้นสุดแล้วกด Unblock บนหน้า Webhook
ฉันสามารถดูสิ่งที่ถูกส่งไปที่ Webhook ของฉันได้หรือไม่
ใช่. เพจของ Webhook แต่ละเพจมีบันทึกการจัดส่งพร้อมคำขอที่ส่งไปและคำตอบที่ได้รับ
แท็บบูรณาการ

แท็บการรวมระบบแสดงรายการวิธีที่พร้อมตามกลุ่ม:
- ประทับตราที่จุดชำระเงินของคุณ — Poster, Toast, POS ของคุณเองหรือ CRM และไม่เห็น POS ของคุณ?;
- ใบเสร็จทางการเงิน — SmartKasa;
- ระบบอัตโนมัติ — Make, Zapier และสาธารณะ Swagger
การ์ดแต่ละใบบอกว่าต้องใช้คีย์ API หรือไม่ แท็บนี้เสนอไพ่ใบเดียวกันในทุกประเทศ เฉพาะใบเสร็จรับเงินทางการเงินเท่านั้นที่ถูกจำกัดตามประเทศ

White Label ธุรกิจไม่เห็นการ์ด Make, Zapier หรือสาธารณะ Swagger และไม่มีการนำเสนอ Poster หรือคำแนะนำการตั้งค่าบน 7stamp.com
ระบบ POS ใดที่พร้อมเชื่อมต่อ?
Poster และ Toast เมื่อเปิดใช้งานสำหรับแพลตฟอร์ม — จนกระทั่งปรากฏขึ้นเร็วๆ นี้ ระบบอื่นๆ เชื่อมต่อผ่าน API กับ POS หรือ CRM ของคุณเอง
การบูรณาการถูกจำกัดตามประเทศหรือไม่?
ไม่ แท็บนี้เสนอบัตรเดียวกันในทุกประเทศ เฉพาะใบเสร็จรับเงินทางการเงินเท่านั้นที่ถูกจำกัดตามประเทศ
ทำไมฉันไม่เห็น Make และ Zapier
สิ่งเหล่านี้จะไม่แสดงต่อ White Label ธุรกิจ ปุ่ม API และ Webhooks ทำงานเหมือนกัน
Poster
Poster เป็นแอปของเราในตลาด Poster ติดตั้งใน Poster จะเปิดรายการขึ้นมา และแอปได้รับการตั้งค่าด้วยคีย์ API ของการเข้าสู่ระบบของพนักงาน แสตมป์จะนับเป็น Card Operations ของการเข้าสู่ระบบของพนักงาน
ฉันจะเชื่อมต่อ Poster ได้อย่างไร?
เปิด Integrations → Poster และเลือกติดตั้งใน Poster แอปได้รับการตั้งค่าด้วยคีย์ API ของการเข้าสู่ระบบของพนักงาน
Card Operations ใช้แสตมป์ของใคร Poster?
การเข้าสู่ระบบของพนักงานซึ่งมี API คีย์แอปที่ใช้
ฉันจำเป็นต้องมีคีย์ API สำหรับ Poster หรือไม่?
ใช่ คีย์ API ของการเข้าสู่ระบบของพนักงาน
Toast
Toast จะแสดงเร็วๆ นี้สำหรับทุกธุรกิจ จนกว่าจะตั้งค่าการเข้าถึง Toast บนแพลตฟอร์ม เป็นสวิตช์เดียวสำหรับทั้งแพลตฟอร์ม ไม่ใช่การตั้งค่าของธุรกิจ เมื่อเปิดแล้ว การ์ด Toast จะคงการตั้งค่าไว้เอง
ตำแหน่ง Toast แต่ละแห่งเชื่อมต่อกันด้วย GUID กับการเข้าสู่ระบบของพนักงานหนึ่งแห่ง โดยไม่มีคีย์ API: ธุรกิจ บัตรแสตมป์ และแผนของการเข้าสู่ระบบของพนักงานนั้นใช้กับทุกคำขอ Toast จากที่ตั้ง ตำแหน่งสามารถเชื่อมต่อกับการเข้าสู่ระบบของพนักงานได้เพียงแห่งเดียวเท่านั้น และการเข้าสู่ระบบของพนักงานจะมีที่เดียว คำขอจากสถานที่หนึ่งจะถูกปฏิเสธเมื่อถูกตัดการเชื่อมต่อ หรือในขณะที่การเข้าสู่ระบบของพนักงานถูกปิดหรือลบ
บัตรกำนัลแต่ละใบสามารถรับผลิตภัณฑ์เมนู Toast ได้: ที่ Toast POS จากนั้นจะกลายเป็นส่วนลดสำหรับสินค้านั้น บัตรกำนัลที่ไม่มีบัตรกำนัลจะถูกใช้เป็นส่วนลดเป็นศูนย์สำหรับเช็ค และแคชเชียร์จะมอบของขวัญด้วยมือ สามารถแลกบัตรกำนัลได้ที่ Toast POS และวงล้อที่เข้าถึงได้ด้วยเช็คที่ชำระเงินจะถูกหมุนในครั้งเดียว เมื่อ Toast เลิกทำธุรกรรม แสตมป์จะถูกคืนหรือบัตรกำนัลที่แลกแล้วจะถูกเรียกคืน
แขกสามารถเข้าร่วมได้ที่ตู้ Toast หรือหน้าจอแบบหันหน้าเข้าหาแขกพร้อมหมายเลขโทรศัพท์หรืออีเมล บัตรแสตมป์จะออกทันที แขกจะไม่ได้รับอะไรเลยจาก 7Stamp จนกว่าพวกเขาจะเปิดมันด้วยโทรศัพท์หรืออีเมลเดียวกัน
ทำไม Toast ถึงพูดว่า Coming soon?
การเข้าถึง Toast เป็นสวิตช์เดียวสำหรับทั้งแพลตฟอร์ม ไม่ใช่การตั้งค่าธุรกิจของคุณ จนกว่าจะเปิดก็ไม่มีอะไรให้เชื่อมต่อ
ตำแหน่ง Toast เชื่อมต่อกันอย่างไร
โดย GUID เป็น Staff Login เดียว โดยไม่มีคีย์ API บัตรแสตมป์และแผนเข้าสู่ระบบของพนักงานนั้นใช้กับทุกคำขอจากสถานที่
จะเกิดอะไรขึ้นกับแสตมป์เมื่อ Toast ทำให้เช็คเป็นโมฆะ?
เมื่อ Toast เลิกทำธุรกรรม แสตมป์จะถูกคืนหรือบัตรกำนัลที่แลกแล้วจะถูกเรียกคืน
SmartKasa

SmartKasa ไม่ต้องใช้คีย์ API เป็นแหล่งใบเสร็จรับเงินใน การสแกนใบเสร็จ เพิ่มโดยร้านค้า SmartKasa ID หรือตามรหัสบริษัทเพื่อให้ครอบคลุมทุกร้านค้า ลูกค้าสแกนใบเสร็จ SmartKasa ใน Chatbot ของธุรกิจ และแสตมป์จะไปที่การเข้าสู่ระบบของพนักงานของแหล่งที่มาของใบเสร็จนั้น
SmartKasa เป็นภาษายูเครน และใบเสร็จรับเงินทางการเงินใช้ได้เฉพาะในยูเครน สโลวาเกีย คาซัคสถาน และอุซเบกิสถานเท่านั้น
ฉันจำเป็นต้องมีคีย์ API สำหรับ SmartKasa หรือไม่?
หมายเลข SmartKasa เป็นแหล่งใบเสร็จรับเงินใน การสแกนใบเสร็จ เพิ่มโดยร้านค้า ID หรือตามรหัสบริษัท
ลูกค้าจะสแกนใบเสร็จ SmartKasa ได้ที่ไหน
ใน Chatbot ของธุรกิจของคุณ แสตมป์ไปที่การเข้าสู่ระบบของพนักงานของแหล่งใบเสร็จรับเงินนั้น
ใบเสร็จรับเงินทางการเงินทำงานในประเทศใดบ้าง
ในยูเครน สโลวาเกีย คาซัคสถาน และอุซเบกิสถาน
Make และ Zapier

แอป 7Stamp สำหรับ Make อยู่ในคลังแอปสาธารณะของ Make: ค้นหา 7Stamp ในสถานการณ์ใดก็ได้ของ Make หรือใช้ เปิดใน Make บนแท็บ Integrations แอป Zapier ของเราไม่ได้อยู่ในไดเรกทอรีสาธารณะของ Zapier: เปิดใน Zapier เป็นคำเชิญที่เพิ่มแอปลงในบัญชี Zapier ของธุรกิจเอง แอปทั้งสองใช้งานได้กับคีย์ API ของการเข้าสู่ระบบของพนักงาน
สถานการณ์ Make และ Zaps เริ่มต้นโดย 7Stamp Webhooks ดังนั้นทริกเกอร์จึงจำเป็นต้องมีส่วนเสริม Webhooks & Events การดำเนินการเช่นการเพิ่มแสตมป์หรือการออกบัตรกำนัลต้องใช้เพียงรหัส API Make และ Zapier ไม่ได้นำเสนอให้กับ White Label ธุรกิจ
ฉันจะหาแอป 7Stamp ใน Make และ Zapier ได้ที่ไหน?
ใน Make ให้ค้นหา 7Stamp ในสถานการณ์ใดก็ได้ — แอปอยู่ในคลังแอปสาธารณะของ Make ส่วนใน Zapier แอปยังไม่เป็นสาธารณะ จึงต้องใช้ Open in Zapier บนแท็บ Integrations — คำเชิญจะเพิ่มแอปลงในบัญชีของคุณเอง
Make และ Zapier จำเป็นต้องมีส่วนเสริม Webhooks & Events หรือไม่
ทริกเกอร์เกิดขึ้น เนื่องจากสถานการณ์และ Zaps เริ่มต้นโดย 7Stamp Webhooks การดำเนินการเช่นการเพิ่มแสตมป์หรือการออกบัตรกำนัลต้องใช้เพียงรหัส API
ฉันจำเป็นต้องมีคีย์ API สำหรับ Make หรือ Zapier หรือไม่
ใช่. แอปใช้งานได้กับคีย์ API ของการเข้าสู่ระบบของพนักงาน