API და ინტეგრაციები

პარამეტრები → API & integrations აქვს სამი ჩანართი: API კლავიშები, Webhooks და Integrations.
API და API კლავიშები უფასოა ყველა გეგმაზე, Free Forever ჩათვლით; არ არის API დანამატი. API-ის მეშვეობით მიცემული მარკები არის Card Operation, როგორც ნებისმიერი სხვა, ასე რომ, ისინი ჩერდებიან, როდესაც გეგმის Card Operation ამოიწურება. ვებჰუკები ფასიანი ნაწილია, იხილეთ ქვემოთ.
ღირს თუ არა API დამატებითი?
არა. API და API გასაღებები უფასოა ყველა გეგმაზე, Free Forever ჩათვლით. მასში მოცემული მარკები არის Card Operation, როგორც ნებისმიერი სხვა.
შემიძლია გამოვიყენო API Free Forever-ზე?
დიახ. როდესაც გეგმის Card Operation-ები ამოიწურება, შტამპები API ჩერდება, როგორც ნებისმიერი სხვა.
სად არის API პარამეტრები?
პარამეტრებში → API და ინტეგრაციები, სამი ჩანართი - API კლავიშები, ვებჰუკები და ინტეგრაციები.
API გასაღებები

API გასაღები იქმნება API კლავიშების ქვეშ → დაამატეთ API გასაღები ერთი პერსონალის შესვლისთვის. პერსონალის შესვლას აქვს მაქსიმუმ ერთი API გასაღები და გამორთული პერსონალის შესვლა შეუძლებელია. პერსონალის შესვლის გარეშე არჩევის გარეშე, გენერირების API გასაღების ფანჯარა გთავაზობთ შექმნას სწორედ იქ; ახალ პერსონალის შესვლას ესაჭიროება უფასო Staff Seat და სრულ გეგმაზე ფანჯარა გთავაზობთ ადგილის დამატებას ან გეგმის არჩევას.
API კლავიშით განხორციელებული ყოველი ზარი მოქმედებს როგორც მისი პერსონალის შესვლა: ის აღწევს მხოლოდ პერსონალის შესვლის ბიზნესს, ბეჭდავს მისთვის არჩეულ შტამპ ბარათს ავტომატური შტამპის ქვეშ და მისი შტამპები ითვლება როგორც პერსონალის შესვლის Card Operation.
გასაღების ნახვა და კოპირება შესაძლებელია ნებისმიერ დროს API გასაღებების სიიდან. ის ასევე შეიძლება ნაჩვენები იყოს როგორც QR კოდი, ტერმინალში სკანირებისთვის და დაბეჭდილი Staff Login-ის სახელით.
როგორ შევქმნა API გასაღები?
პარამეტრებში → API და ინტეგრაციები → API კლავიშებში, აირჩიეთ API კლავიშის დამატება და აირჩიეთ პერსონალის შესვლა. თითოეულ პერსონალის შესვლას აქვს მაქსიმუმ ერთი API გასაღები.
დავკარგე API გასაღები. მჭირდება ახალი?
არა. გასაღების ნახვა და კოპირება შესაძლებელია ნებისმიერ დროს API გასაღებების სიიდან, ან ნაჩვენები როგორც QR კოდი.
რომელ მარკის ბარათს უწოდებს API შტამპს?
ის, რომელიც არჩეულია გასაღების პერსონალის შესვლისთვის, ავტომატური ბეჭდის ქვეშ. მისი შტამპები ითვლება პერსონალის შესვლის Card Operation-ებად.
რატომ არ შემიძლია ავირჩიო პერსონალის შესვლა ახალი გასაღებისთვის?
გამორთული პერსონალის შესვლა შეუძლებელია, ხოლო პერსონალის შესვლა, რომელსაც უკვე აქვს გასაღები, ვერ მიიღებს მეორეს. არჩევის გარეშე, ფანჯარა გთავაზობთ პერსონალის შესვლას.
როდესაც API კლავიატურა წყვეტს მუშაობას
API გასაღები არ იწურება. ის წყვეტს მუშაობას მხოლოდ მაშინ, როდესაც ის რეგენერირებულია ან წაიშლება, ან როდესაც მისი პერსონალის შესვლა გამორთულია ან წაიშლება. ახალი პაროლი ან შესვლა პერსონალის შესვლისთვის არ იმოქმედებს მასზე.
- Regenerate აძლევს პერსონალის შესვლას ახალ API გასაღებს; ძველი ერთდროულად წყვეტს მუშაობას.
- წაშლა კლავს ერთდროულად აჩერებს. თავად პერსონალის შესვლა განაგრძობს მუშაობას 7Stamp Scanner-ში და შეუძლია მოგვიანებით მიიღოს ახალი გასაღები.
- Staff Login-ის გამორთვა ინახავს მის გასაღებს: როდესაც პერსონალის შესვლა ისევ ჩართულია, იგივე გასაღები კვლავ მუშაობს.
იწურება თუ არა API გასაღები?
არა. ის წყვეტს მუშაობას მხოლოდ რეგენერაციის ან წაშლისას, ან როდესაც მისი პერსონალის შესვლა გამორთულია ან წაიშლება.
შევცვალე Staff Login-ის პაროლი. მჭირდება ახალი API გასაღები?
არა. ახალი პაროლი ან შესვლა არ ახდენს გავლენას API გასაღებზე.
მე ისევ ჩავრთე პერსონალის შესვლა. მუშაობს მისი ძველი API გასაღები?
დიახ. პერსონალის შესვლის გამორთვა ინახავს მის კლავიშს და იგივე გასაღები კვლავ იმუშავებს, როგორც კი ისევ ჩართულია.
რას აკეთებს API
API სისტემას შეუძლია:
- დაურიგეთ Stamp ბარათი, როგორც ბმული ან QR;
- მარკების დამატება;
- წაიკითხეთ ბარათი თავისი შტამპებით, მიზნებით და ვაუჩერებით;
- ვაუჩერის გაცემა პირდაპირ ბარათზე;
- გამოისყიდეთ ვაუჩერი მისი ვაუჩერის კოდით;
- გაგზავნეთ კლიენტი.
API პოულობს კლიენტის ბარათს ბიზნესის საკუთარი იდენტიფიკატორით, როგორიცაა CRM ID, ტელეფონი ან ელფოსტა, გაგზავნილი როგორც external_id. იდენტიფიკატორი ინახება ბარათზე და ბრუნდება მის შესახებ ყველა Webhook-ში. API-ს არ აქვს ზარი, რომელიც ჩამოთვლის ბიზნესის კლიენტებს: მომხმარებელთა მთელი ბაზა ამოღებულია მხოლოდ ადმინისტრატორის ექსპორტის საშუალებით.
API გასაღების ნაცვლად, აპს შეუძლია შესვლა Staff Login-ის შესვლისა და პაროლით — მოწყობილობისთვის, რომელშიც შედის მოლარე. API გასაღები შეესაბამება მოწყობილობას, რომელიც მუშაობს უყურადღებოდ. ვებჰუკები ემატება მხოლოდ ადმინისტრატორში; API-ს არ აქვს ზარი ღონისძიებების გამოსაწერად ან მათ ჩამოთვლაზე.
API არ ადგენს მოთხოვნის განაკვეთის ლიმიტს: ზარები არ მცირდება ნომრით ან სიხშირით და იგივე ბარათის ხელახლა სკანირება შესაძლებელია დაუყოვნებლივ. ის, რაც ზღუდავს მის დაბეჭდვას, არის გეგმის Card Operations.
შეგვიძლია დავამატოთ მარკები ჩვენივე CRM-დან ან POS-დან?
დიახ, API-ის მეშვეობით. ის ურიგებს მარკების ბარათებს, ამატებს შტამპებს, კითხულობს ბარათებს და გამოისყიდის ვაუჩერებს. იმისათვის, რომ თქვენს სისტემას ეცნობოს მოვლენების შესახებ, დაამატეთ Webhook – რომელსაც სჭირდება Webhooks & Events დანამატი.
შეგვიძლია მონაცემების ექსპორტი?
API-ის მეშვეობით თქვენ კითხულობთ ბარათებს თქვენი საკუთარი იდენტიფიკატორით და Webhooks აგზავნიან მოვლენებს, როგორც კი ისინი მოხდება. API-ს არ აქვს ყველა კლიენტის სია — მთელი კლიენტების ბაზა ამოღებულია ადმინისტრატორის ექსპორტის საშუალებით.
როგორ პოულობს API კლიენტის ბარათს?
თქვენი საკუთარი იდენტიფიკატორით - CRM ID, ტელეფონით ან ელექტრონული ფოსტით - გაგზავნილი როგორც external_id. ის ინახება ბარათზე და ბრუნდება მის შესახებ ყველა Webhook-ში.
შემიძლია გამოვიწერო Webhooks API-ის მეშვეობით?
არა. ვებჰუკები დამატებულია მხოლოდ ადმინისტრატორში.
აქვს თუ არა API-ს განაკვეთის ლიმიტი?
არა. ზარები არ მცირდება ნომრით ან სიხშირით და იგივე ბარათის ხელახლა სკანირება შესაძლებელია დაუყოვნებლივ. ჭედურობა შემოიფარგლება მხოლოდ გეგმის Card Operation-ებით.
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 გასაღები ან პერსონალის შესვლა.
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 დოკუმენტების ბმული. მუშაობს თუ არა API ჩვენთვის?
დიახ. White Label ბიზნესი ვერ ხედავს ბმულს მითითებასთან, მაგრამ მისი API გასაღებები და Webhooks ერთნაირად მუშაობს.
ვებჰუკები

Webhook ემატება ქვეშ API & integrations → Webhooks → Add webhook, URL-ით, რომელიც იღებს მოვლენებს. 7Stamp-ში იქმნება Webhook Stamp ბარათის ღონისძიებებისთვის. ბიზნესს შეუძლია რამდენიმე Webhook-ის დამატება, თითოეულს თავისი URL.
Webhook-ებს სჭირდებათ Webhooks & Events დანამატი, $19 თვეში, შემოთავაზებული მხოლოდ ფასიან გეგმებზე. პირველი Webhook-ის შესყიდვის შეთავაზების დამატება; ამის გარეშე Webhook-ის შექმნა ან ჩართვა შეუძლებელია. ერთი დანამატი ინარჩუნებს ერთ Webhook-ს ჩართულს: მეტის დამატება შესაძლებელია, მაგრამ გამოწერის ყოველი ბილინგის განახლება გამორთავს ყველაფერს, გარდა უძველესი.
Webhook-ები აგზავნიან მოვლენებს ისე, როგორც ისინი ხდება Webhook-ის დამატების მომენტიდან. ადრინდელი მოვლენები არ იგზავნება.
Webhooks უფასოა?
არა. მათ სჭირდებათ Webhooks & Events დანამატი, $19 თვეში, შემოთავაზებული მხოლოდ ფასიან გეგმებზე. API თავისთავად უფასოა.
დავამატე მეორე Webhook და ის გამორთული იყო. რატომ?
ერთი Webhooks & Events დანამატი ინარჩუნებს ერთ Webhook-ს ჩართულს. გამოწერის ყოველი ბილინგის განახლება გამორთავს ყველაფერს, გარდა უძველესი.
გაგზავნის თუ არა ახალი Webhook წარსულ მოვლენებს?
არა. მოვლენები იგზავნება Webhook-ის დამატების მომენტიდან.
ვებჰუკის მოვლენები
Webhook იღებს თხუთმეტ Stamp ბარათის მოვლენას, სახელწოდებით 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; ბორბალი, რომელიც ელოდება დატრიალებას, ჯერ არაფერს აგზავნის.
მომხმარებელთა მიმოხილვები არ არის Stamp ბარათის მოვლენები. ყოველი ახალი მიმოხილვა უგზავნის მოვლენას review და მოქმედებით created Webhook-ებს, რომლებსაც აქვთ მიმოხილვები მონიშნული ობიექტებს შორის Webhook-ის გვერდზე. აქ დამატებული Webhook დაყენებულია მხოლოდ Stamp ბარათის ღონისძიებებისთვის, ასე რომ, მიმოხილვების მონიშვნის შემდეგ ის მიიღებს მიმოხილვებს.
იგზავნება Webhook, როდესაც სკანირება არ ამატებს ბეჭედს?
დიახ. სკანირება, რომელიც არ ამატებს ბეჭედს, როგორიცაა შესყიდვა მარკის ფასზე დაბალი, მაინც აგზავნის SCAN-ს დამატებული ნულოვანი მარკებით.
რომელი მოვლენა მეუბნება, რომ მომხმარებელმა მოიგო საჭეზე?
LOTTERY_WIN, გაგზავნილი ერთხელ, როდესაც ბორბალი ტრიალებს. ბორბალი, რომელიც ელოდება დატრიალებას, ჯერ არაფერს აგზავნის.
შემიძლია გითხრათ, როდის ამოიღებს კლიენტი ბარათს საფულედან?
დიახ. საშვის საფულეში დამატება და მისი ამოღება გაგზავნეთ CARD_ADDED_TO_WALLET და CARD_REMOVED_FROM_WALLET საფულესთან, Apple-თან ან Google-თან ერთად.
როგორ მივიღო ახალი მომხმარებელთა მიმოხილვები Webhook-ის მეშვეობით?
გახსენით Webhook-ის გვერდი და მონიშნეთ მიმოხილვები მის ობიექტებს შორის. ყოველი ახალი მიმოხილვა შემდეგ მოდის ერთეულის მიმოხილვით და შექმნილი მოქმედებით; API და ინტეგრაციების ქვეშ დამატებული Webhook მიიღებს Stamp ბარათის მოვლენებს მხოლოდ მანამდე.
როდესაც ყოველი ღონისძიება იგზავნება
| ღონისძიება | გაგზავნილი როდის |
|---|---|
SCAN | პერსონალის შესვლა სკანირებს ბარათს: 7Stamp Scanner-ში, API-ის მეშვეობით ან POS-დან, როგორიცაა Toast. 7Stamp Scanner-ში ამოღებული მარკები არის SCAN უარყოფითი stamps_added |
DELIVERY_INSERT | კლიენტი ხსნის მარკის კოდს, რომელიც იძლევა შტამპებს - QR, ბმულს, თავად კოდს ან მოწვევას API-ის მეშვეობით |
RECEIPT_SCAN | კლიენტი ასკანირებს ფისკალურ ქვითარს ბიზნესის ჩეთბოტში და მას ბეჭდავს; amount არის ქვითარი |
CARD_JOINED | კლიენტი იღებს ახალ Stamp ბარათს, როგორიც არ უნდა იყოს, თქვენ მიერ გავლილი external_id |
REWARD_EARNED | სკანირება აღწევს Award მიზანს |
VOUCHER_ISSUED | სკანირება აღწევს ვაუჩერის მიზანს |
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 ვაუჩერის მიზნისთვის და LOTTERY_WIN Lottery-ისთვის, თითოეული გაგზავნილი სკანირების საკუთარი მოვლენის შემდეგ.
იგზავნება Webhook მარკების წაშლისას?
დიახ. 7Stamp Scanner-ში ამოღებული მარკები ჩამოდის როგორც SCAN უარყოფითი stamps_added.
რა განსხვავებაა VOUCHER_ISSUED-სა და ADMIN_VOUCHER_ISSUE-ს შორის?
VOUCHER_ISSUED მოდის, როდესაც სკანირება მიაღწევს ვაუჩერის მიზანს. ADMIN_VOUCHER_ISSUE მოდის, როდესაც ვაუჩერი გაიცემა პირდაპირ ბარათზე, ხელით ადმინისტრატორში ან API-ის მეშვეობით.
კლიენტი, რომელიც უერთდება მარკის კოდით, აგზავნის ერთ ან რამდენიმე მოვლენას?
რამდენიმე. ჯერ მოდის CARD_JOINED, შემდეგ VOUCHER_PACK, თუ მარკის ბარათს აქვს ვაუჩერის პაკეტი, შემდეგ DELIVERY_INSERT მარკებით.
ვიღებ ღონისძიებას კამპანიის თითოეული შეტყობინებისთვის?
CARD_CAMPAIGN იგზავნება ერთხელ თითოეულ ბარათზე, რომელსაც მიაღწევს კამპანია, კამპანიის ვაუჩერით, როდესაც ის ატარებს მას.
რასაც Webhook იღებს
ყველა ღონისძიებას აქვს ერთი და იგივე JSON ორგანო: ღონისძიება ID, ბიზნესი და ღონისძიება თავისი ტიპით, Stamp ბარათი, მარკები ადრე და შემდეგ, შესყიდვის თანხა, 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-ისთვის, ღონისძიება data-ს ნაცვლად ზის card_event კლავიშის ქვეშ, რათა მათმა აპებმა შეძლონ მისი გარჩევა.
ხელმოწერა
ყოველი მიწოდება ხელმოწერილია. X-Webhook-Signature სათაურში არის დროის შტამპი და HMAC-SHA256 ამ დროის შტამპისა და ნედლეულის კორპუსში, რომელსაც აქვს Webhook-ის საიდუმლო გასაღები. საიდუმლო გასაღები ნაჩვენებია და რეგენერირებულია Webhook-ის გვერდზე. ასევე შეიძლება დაემატოს ძირითადი ავტორიზაციის შესვლა და პაროლი.
როგორ შევამოწმო, რომ Webhook ნამდვილად მოდის 7Stamp-დან?
გამოთვალეთ დროის ანაბეჭდის HMAC-SHA256 და დაუმუშავებელი სხეული Webhook-ის საიდუმლო გასაღებით და შეადარე X-Webhook-Signature სათაურს.
სად ვიპოვო Webhook-ის საიდუმლო გასაღები?
Webhook-ის გვერდზე, სადაც ასევე შესაძლებელია მისი რეგენერაცია.
შემიძლია დავიცვა ჩემი საბოლოო წერტილი პაროლით?
დიახ. ძირითადი ავტორიზაციის შესვლა და პაროლი შეიძლება დაემატოს Webhook-ს, ხელმოწერის თავზე.
წარუმატებელი მიწოდება
მიწოდება, რომელიც არ მიიღებს 2xx პასუხს ოცდაათი წამის განმავლობაში, განმეორდება ათჯერ, თითოეული ელოდება წინაზე ოთხი წამით მეტს, ასე რომ განმეორებითი ცდები დასრულდება დაახლოებით ოთხ წუთში. ამ დროის შემდეგ 429 პასუხი ხელახლა ცდა-შემდეგ. მოვლენის პირველი წარუმატებლობა ათავსებს შეტყობინებას ადმინისტრატორში.
ზედიზედ ასი წარუმატებელი მიწოდების შემდეგ Webhook იბლოკება სისტემის მიერ და აღარ იღებს რაიმე მოვლენას. მისი გვერდი მანამდე აფრთხილებს და აქვს განბლოკვის ღილაკი; ერთი წარმატებული მიწოდება აღადგენს რაოდენობას.
Webhook-ის თითოეულ გვერდს აქვს მიწოდების ჟურნალი, გაგზავნილი მოთხოვნით და მიღებული პასუხით. ხელახლა გაგზავნა აგზავნის იგივე მოვლენას მხოლოდ ამ Webhook-ზე.
ჩემი სერვერი გათიშული იყო. დაიკარგა მოვლენები?
თითოეული მიწოდება განმეორდება ათჯერ, დაახლოებით ოთხი წუთის განმავლობაში. ამის შემდეგ გახსენით Webhook-ის ჟურნალი და გამოიყენეთ ხელახლა გაგზავნა თქვენთვის საჭირო ღონისძიებებისთვის.
რატომ შეწყვიტა ჩემმა Webhook-მა მოვლენების მიღება?
ზედიზედ ასი წარუმატებელი მიწოდების შემდეგ ის დაბლოკილია სისტემის მიერ. დააფიქსირეთ ბოლო წერტილი და დააჭირეთ განბლოკვას Webhook-ის გვერდზე.
შემიძლია ვნახო, რა გაიგზავნა ჩემს Webhook-ზე?
დიახ. Webhook-ის თითოეულ გვერდს აქვს მიწოდების ჟურნალი გაგზავნილი მოთხოვნით და მიღებული პასუხით.
ინტეგრაციის ჩანართი

ინტეგრაციის ჩანართში ჩამოთვლილია მზა გზები ჯგუფის მიხედვით:
- Z შტამპი თქვენს შეკვეთაზე — Poster, Toast, თქვენი საკუთარი POS ან CRM და არ ხედავთ თქვენს POS?;
- ფისკალური ქვითრები — SmartKasa;
- Automation — Make, Zapier და Public Swagger.
თითოეულ ბარათში ნათქვამია, სჭირდება თუ არა API გასაღები. ჩანართი გთავაზობთ ერთსა და იმავე ბარათებს ყველა ქვეყანაში; მხოლოდ ფისკალური შემოსავლები შეზღუდულია ქვეყნების მიხედვით.

White Label ბიზნესი არ ხედავს Make, Zapier ან Public Swagger ბარათს და არ არის შემოთავაზებული Poster ან დაყენების სახელმძღვანელო 7stamp.com-ზე.
რომელი POS სისტემებია მზად დასაკავშირებლად?
Poster და Toast პლატფორმისთვის ჩართვის შემდეგ — მანამდე ის გამოჩნდება მალე. სხვა სისტემები დაკავშირებულია API-ის მეშვეობით, თქვენივე POS ან CRM.
არის თუ არა ინტეგრაცია შეზღუდული ქვეყნების მიხედვით?
არა. ჩანართი გთავაზობთ ერთსა და იმავე ბარათებს ყველა ქვეყანაში. მხოლოდ ფისკალური ქვითრები შეზღუდულია ქვეყნების მიხედვით.
რატომ ვერ ვხედავ Make და Zapier?
ისინი არ არის ნაჩვენები White Label ბიზნესში. მისი API კლავიშები და Webhooks ერთნაირად მუშაობს.
პოსტერის გაყიდვის პუნქტი
Poster არის ჩვენი აპლიკაცია Poster ბაზარზე. Install in Poster ხსნის მის ჩამონათვალს და აპი დაყენებულია პერსონალის შესვლის API გასაღებით. მისი შტამპები ითვლება პერსონალის შესვლის Card Operation-ებად.
როგორ დავაკავშირო Poster?
გახსენით ინტეგრაციები → Poster და აირჩიეთ Install in Poster. აპლიკაცია დაყენებულია პერსონალის შესვლის API გასაღებით.
ვის Card Operation-ებს იყენებენ Poster მარკები?
პერსონალის შესვლა, რომელთა API კლავიშს იყენებს აპლიკაცია.
მჭირდება API გასაღები Poster-სთვის?
დიახ, პერსონალის შესვლის API გასაღები.
ტოსტი
Toast შოუები მალე გამოვა ყველა ბიზნესისთვის, სანამ Toast წვდომა არ დაყენდება პლატფორმაზე. ეს არის ერთი გადამრთველი მთელი პლატფორმისთვის და არა ბიზნესის პარამეტრი; როგორც კი ის ჩართულია, Toast ბარათი თავად ინახავს დაყენებას.
თითოეული Toast ადგილმდებარეობა დაკავშირებულია თავისი GUID-ით ერთ Staff Login-თან, API გასაღების გარეშე: ეს Staff Login-ის ბიზნესი, Stamp ბარათი და გეგმა ვრცელდება მდებარეობიდან ყოველ Toast მოთხოვნაზე. მდებარეობა შეიძლება დაუკავშირდეს მხოლოდ ერთ პერსონალის შესვლას, ხოლო პერსონალის შესვლა შეიცავს ერთ ადგილს. მდებარეობიდან მოთხოვნილებები უარყოფილია მას შემდეგ, რაც ის გათიშულია, ან როდესაც მისი პერსონალის შესვლა გამორთულია ან წაიშლება.
თითოეულ ვაუჩერს შეიძლება მიეცეს Toast მენიუს პროდუქტი: Toast POS შემდეგ ხდება ფასდაკლება ამ პროდუქტზე. ვაუჩერი ერთის გარეშე გამოიყენება ნულოვანი ფასდაკლებით ჩეკზე და მოლარე გადასცემს საჩუქარს ხელით. ვაუჩერების გამოსყიდვა ხდება Toast POS-ზე და ფასიანი ჩეკით მიღწეული ბორბალი ერთდროულად ტრიალებს. როდესაც Toast გააუქმებს ტრანზაქციას, მისი შტამპები უკან იღება ან მისი გამოსყიდული ვაუჩერები აღდგება.
სტუმარს შეუძლია შეუერთდეს Toast კიოსკს ან სტუმარს ეკრანზე ტელეფონის ნომრით ან ელფოსტით. Stamp ბარათი გაიცემა ერთდროულად; სტუმარი არაფერს იღებს 7Stamp-დან, სანამ არ გახსნის მას იმავე ტელეფონით ან ელექტრონული ფოსტით.
რატომ ამბობს Toast მალე?
Toast წვდომა არის ერთი გადამრთველი მთელი პლატფორმისთვის და არა თქვენი ბიზნესის პარამეტრი. სანამ ის ჩართულია, დასაკავშირებელი არაფერია.
როგორ არის დაკავშირებული Toast მდებარეობა?
მისი GUID ერთი პერსონალის შესვლაზე, API გასაღების გარეშე. ეს Staff Login’s Stamp ბარათი და გეგმა ვრცელდება მდებარეობის ყველა მოთხოვნაზე.
რა ემართება მარკებს, როდესაც Toast ჩეკს გააუქმებს?
როდესაც Toast გააუქმებს ტრანზაქციას, მისი შტამპები უკან იღება ან მისი გამოსყიდული ვაუჩერები აღდგება.
სმარტკასა

SmartKasa არ საჭიროებს API კლავიშს. ეს არის ქვითრის წყარო ქვითრების სკანირებაში, დამატებულია SmartKasa მაღაზიის ID ან კომპანიის კოდით, რათა დაფაროს ყველა მაღაზია. მომხმარებლები ასკანირებენ SmartKasa ქვითარს ბიზნესის ჩატბოტში და შტამპები გადადიან ამ ქვითრის წყაროს პერსონალის შესვლაზე.
SmartKasa არის უკრაინული და ფისკალური ქვითრები მუშაობს მხოლოდ უკრაინაში, სლოვაკეთში, ყაზახეთსა და უზბეკეთში.
მჭირდება API გასაღები SmartKasa-სთვის?
არა. SmartKasa არის ქვითრის წყარო ქვითრების სკანირებაში, რომელიც დამატებულია მაღაზიის ID-ის ან კომპანიის კოდით.
სად ასკანირებენ მომხმარებლები SmartKasa ქვითარს?
თქვენი ბიზნესის ჩატბოტში. მარკები მიდის ამ ქვითრის წყაროს პერსონალის შესვლაზე.
რომელ ქვეყნებში მუშაობს ფისკალური შემოსავლები?
უკრაინაში, სლოვაკეთში, ყაზახეთსა და უზბეკეთში.
Make და Zapier

7Stamp აპი Make-ისთვის Make-ის აპების საჯარო კატალოგშია: მოძებნეთ 7Stamp Make-ის ნებისმიერ სცენარში ან გამოიყენეთ Open in Make ინტეგრაციის ჩანართზე. ჩვენი Zapier აპი არ არის Zapier-ის საჯარო დირექტორიაში: Open in Zapier არის მოსაწვევი, რომელიც ამატებს აპს ბიზნესის საკუთარ Zapier ანგარიშში. ორივე აპი მუშაობს პერსონალის შესვლის API გასაღებით.
Make სცენარები და Zaps დაწყებულია 7Stamp Webhooks-ის მიერ, ამიტომ ტრიგერები საჭიროებენ Webhooks & Events დანამატს. ქმედებებისთვის, როგორიცაა მარკების დამატება ან ვაუჩერის გაცემა, საჭიროა მხოლოდ API გასაღები. Make და Zapier არ არის შემოთავაზებული White Label ბიზნესისთვის.
სად ვიპოვო 7Stamp აპი Make-ში და Zapier-ში?
Make-ში მოძებნეთ 7Stamp ნებისმიერ სცენარში — აპი Make-ის აპების საჯარო კატალოგშია. Zapier-ში ის ჯერ საჯარო არ არის, ამიტომ გამოიყენეთ Open in Zapier ინტეგრაციის ჩანართზე — მოწვევა ამატებს აპს თქვენს საკუთარ ანგარიშში.
სჭირდება თუ არა Make-ს და Zapier-ს Webhooks & Events დანამატი?
ტრიგერები ასეა, რადგან სცენარები და Zaps დაწყებულია 7Stamp Webhooks-ის მიერ. ქმედებებისთვის, როგორიცაა მარკების დამატება ან ვაუჩერის გაცემა, საჭიროა მხოლოდ API გასაღები.
მჭირდება API გასაღები Make ან Zapier?
დიახ. აპლიკაციები მუშაობს პერსონალის შესვლის API გასაღებით.