Reference Operations

API, վեբհուքեր և ինտեգրացիաներ

API բանալիները անձնակազմի մուտքերի համար, ինչ է անում API-ը, Webhooks-ները և դրանց իրադարձությունները, կազմաձևը, ստորագրությունը և կրկնությունները, ինչպես նաև պատրաստի ինտեգրումներն՝ Poster, Toast, SmartKasa, Make և Zap…

Quick read

Թարմացված: 19 November 2026

API և ինտեգրացիաներ

API զանգվածներ 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 և ինտեգրացիաներ։

API բանալիներ

Ստեղծել API բանալի անձնակազմի մուտքի համար

API բանալին ստեղծվում է API բանալիների տակ → Ավելացրեք API բանալին մեկ անձնակազմի գրանցման համար։ Անձնակազմի գրանցումը կարող է ունենալ առավելագույնը մեկ API բանալի, և անջատված անձնակազմի գրանցումը հնարավոր չէ ընտրել։ Եթե ընտրելու համար չկա անձնակազմի գրանցում, Յ生成 API բանալի պատուհանը առաջարկում է ստեղծել այն անմիջապես այնտեղ; նոր անձնակազմի գրանցման համար անհրաժեշտ է ազատ Staff Seat, և լրացված պլանի դեպքում պատուհանը առաջարկում է ավելացնել նստատեղ կամ փոխարենը ընտրել պլան։

Ամեն զանգ, որը կատարվում է API բանալով, գործում է որպես դրա Աշխատակիցի Մուտք: այն հասնում է միայն այդ Աշխատակցի Մուտքի Բիզնեսին, դրանում ընտրված Յսմման քարտը դնում է Ավտոմատիկ տպագրության տակ և նրա տպագրությունները հաշվում են որպես այդ Աշխատակցի Մուտքի Card Operations:

Բանալին կարող է դիտվել և կրկին պատճենահանվել ցանկացած ժամանակ API բանալիների ցուցակից։ Այն կարող է նաև ցուցադրվել որպես QR կոդ, որպեսզի սկանավորվի տերմինալում, և տպվել Ստաֆի Լոգինի անունով։

Ինչպես ստեղծեմ API բանալին?

Կարգավորումների մեջ → API և ինտեգրացիաներ → API բանալիներ, ընտրեք Ավելացնել API բանալի և ընտրեք Աշխատակիցի Մուտք։ Յուրաքանչյուր Աշխատակինի Մուտքի համար առավելագույնը կարող է լինել մեկ API բանալի։

Ես կորցրել եմ իմ API բանալիը։ Արդյո՞ք ինձ նորի կարիք կա։

ոչ։ Բանալիին կարելի է կրկին դիտել և պատճենել ցանկացած ժամանակ API բանալիների ցուցակից, կամ ցուցադրել որպես QR կոդ։

Ո՞ր դրոշմանիշի քարտն է API կոչում դրոշմանիշ:

Ընտրված է ստանալու համար ստեղնաշարի Մուտք Ընդհանուր ավտոմատ մարկավորման տակ: Նրա մարկերը համարվում են այդ Մուտքի Card Operations-ով։

Ինչու չեմ կարող ընտրել Նպաստագիր մուտք նոր բանալիի համար?

Փոխանցված աշխատակազմի մուտքը չի կարող ընտրվել, և աշխատակազմի մուտքը, որը արդեն ունի բանալի, չի կարող երկրորդը ստանալ: Եթե ընտրելու բան չկա, պատուհանը առաջարկում է ստեղծել աշխատակազմի մուտք:

Երբ API բանալին դադարում է աշխատել

API բանալին չի ժամկետանցվում։ Այն դադարում է գործել միայն այն ժամանակ, երբ այն վերաարտադրվում է կամ ջնջվում, կամ երբ նրա Ստաֆֆ Գրանցումը անջատվում կամ ջնջվում է։ Ստաֆֆ Գրանցման նոր գաղտնաբառը կամ մուտքը դրա վրա չի ազդում։

  • Վերածնելը տանում է Թիմի Մուտքին նոր API բանալի; հինը միանգամից դադարում է գործել:
  • Ջնջել կկանգնեցնի ստեղնը անմիջապես։ Ստեփի Մուտքը ինքնուրույն շարունակում է գործել 7Stamp Scanner-ում և կարող է հետագայում ստանալ նոր ստեղն։
  • Աշխատակազմի մուտքի անջատումը պահում է դրա բանալին․ երբ աշխատակազմի մուտքը նորից միացվում է, նույն բանալին կրկին գործում է։

Արդյո՞ք API բանալին ժամկետն անցնում է։

Ոչ. Այն դադարում է աշխատել միայն այն ժամանակ, երբ այն նորից ստեղծվում կամ ջնջվում է, կամ երբ անջատվում կամ ջնջվում է դրա Անձնակազմի մուտքը:

Ես փոխեցի անձնակազմի մուտքի գաղտնաբառը։ Մնա՞ւ ինձ նոր API բանալին անհրաժեշտ:

Ոչ։ Նոր գաղտնաբառը կամ մուտքագրումը չի ազդում API բանալու վրա:

Ես կրկին միացրեցի անձնակազմի մուտքագրումը: Նրա հին API բանալին աշխատո՞ւմ է:

Այո. Աշխատակիցի մուտքի անջատումը պահում է դրա բանալին, և նույն բանալին կրկին գործում է, երբ այն միացվում է:

Ի՞նչ է անում API-ը

ՉՐՉՔ0ՉՐՉՔ միջով համակարգը կարող է՝

  • հանձնել մետաղադրամային քարտը որպես հղում կամ QR;
  • ավելացնել նամականիներ;
  • կարդալ քարտը նրա մեջը եղած մխոցներով, նպատակներով և վաուչերով;
  • մատուցել վաուչեր անմիջապես քարտին;
  • փոխանակեք վաուչերը դրա վաուչերի կոդով;
  • ուղարկել հաղորդագրություն հաճախորդին։

API-ն գտնում է Հաճախորդի քարտը Ընկերության սեփական նույնացման միջոցով, օրինակ՝ CRM ID, հեռախոս կամ էլ․ հասցե, ուղարկված որպես external_id: Այդ նույնացուցիչը պահվում է քարտի վրա և վերադառնում յուրաքանչյուր Webhook-ում: API-ն չունի որևէ կանչ, որը ցուցակագրի Ընկերության Հաճախորդներին՝ ամբողջ Հաճախորդների բազան հնարավոր է ստանալ միայն ադմինիստրատորի արտահանումով:

API բանալիի փոխարեն, հավելվածը կարող է մուտք գործել Սթաֆ Լոգինի լոգինով և գաղտնաբառով՝ այն սարքավորանքի համար, որին մուտքագրում է հանդերձարանավաճառը: API բանալին պիտանի է սարքի համար, որը աշխատում է հանդերձարանավաճառի վերահսկողություն առանց: Webhook-ներ ավելացվում են միայն ադմինիստրատորի կողմից; API-ը չի ունենում կանչեր՝ events-ներին բաժանորդագրվելու կամ դրանք ցուցակելու համար:

API-ը չի սահմանում խնդրի հաճախացման սահմանափակում՝ զանգեր չեն սահմանափակվում քանակով կամ հաճախականությամբ, և նույն քարտը կարելի է կրկին սկանավորել անմիջապես: Սահմանափակողը, թե որքան կարելի է դրոշմել դրա միջոցով, պլանի Card Operations-ն է։

Կարո՞ղ ենք ավելացնել նշումներ մեր սեփական CRM կամ POS-ից:

Այո, API-ի միջոցով: Այն բաժանում է Ստամպ քարտեր, ավելացնում է ստամպեր, կարդում է քարտերը և փոխարինում Վաուչերները: Ձեր համակարգին իրադարձությունների մասին տեղեկացնելու համար ավելացրեք Webhook՝ այն պահանջում է Webhooks & Events հավելվածը:

Կարո՞ղ ենք տվյալները արտահանել:

API-ի միջոցով դուք կարդում եք քարտերը ձեր սեփական նույնացուցիչով, և Webhooks-ն ուղարկում են իրադարձությունները հենց որ դրանք տեղի են ունենում: API-ն չունի բոլոր Հաճախորդների ցուցակ — ամբողջ Հաճախորդների բազան հանվում է ադմինիստրատորի արտահանման միջոցով:

Ինչպես է API-ը գտնում հաճախորդի քարտը?

Քեզնից ինքներդ՝ CRM ID, հեռախոս կամ էլ.փոստ — ուղարկված որպես external_id։ Այն պահվում է քարտի վրա և յուրաքանչյուր վեբհուքում վերադառնում դրա մասին։

Կհնարա՞ արդյոք բաժանորդագրվել Webhooks-ին API-ի միջոցով:

Ոչ։ Վեբհուքերը ավելացվում են միայն ադմինիստրատորում։

Հարցը 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 բանալի կամ աշխատակցի մուտք։

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-ը նույնն են գործում։

Վեբհուքեր

Վեբհուքեր API-ում և ինտեգրացիաներում

Webhook-ը ավելացվում է API अंतर्गत և ինտեգրացիաներում → Webhooks → Add webhook, օգտագործելով URL, որը ստանում է իրադարձությունները: 7Stamp-ում ստեղծվում է Webhook Stamp card-ի իրադարձությունների համար: Բիզնեսը կարող է ավելացնել մի քանի Webhook, յուրաքանչյուրը կարող է ունենալ իր սեփական URL:

Վեբհուկերի համար անհրաժեշտ է Webhooks & Events հավելումը, $19 ամսական, մատչելի միայն վճարովի պլաններում: Առաջին վեբհուկը ավելացնելիս առաջարկվում է այն գնել; առանց դրա վեբհուկը cannot ստեղծվել կամ կրկին միացված լինել: Մի հավելում պահում է մեկ վեբհուկ միացված վիճակում՝ կարելի է ավելացնել ավելի շատ, բայց բաժանորդագրության յուրաքանչյուր վճարման թարմացում անջատում է բոլորը՝ բացի ամենահինից։

Վեբհուքերը ուղարկում են իրադարձությունները հենց երբ դրանք տեղի են ունենում` այն պահից, երբ վեբհուքը ավելացվել է: Ավելի վաղ իրադարձություններ չեն ուղարկվում:

Վեբհուկերն անվճար են՞

Ոչ։ Ձեզ անհրաժեշտ է Webhooks & Events հավելումը, $19 մեկ ամսական, հասանելի միայն վճարովի պլանների դեպքում։ API-ը ինքնին անվճար է։

Ես ավելացրեցի երկրորդ Webhook և այն անջատված էր։ Ինչո՞ւ։

Մեկ Webhooks & Events հավելումը պահում է մեկ Webhook ակտիվ: Բացումի յուրաքանչյուր թարմացում անջատում է բոլոր այն, բացի ամենահինից:

Կարող է՞ նոր 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; պտտվելու սպասող հեկտարը դեռ ոչինչ չի ուղարկում։

Հաճախորդի ակնարկները սեղանի քարտի իրադարձություններ չեն։ Ինչպես նոր ակնարկը, այնպես էլ այն ուղարկում է իրադարձություն review սուբյեկտով և created գործողությամբ Webhooks-ին, որոնք հաստատված են որպես Reviews իրենց օբյեկտների մեջ Webhook-ի էջում։ Այստեղ ավելացված Webhook-ը ստեղծվել է միայն սեղանի քարտի իրադարձությունների համար, այնպես որ այն ստանում է ակնարկները միայն այն ժամանակ, երբ Reviews-ը նշված է։

Վեբքուքը ուղարկվո՞ւմ է, երբ սկանավորումը որևէ տպագիր նշան չի ավելացնում:

Այո։ Սկանավորում, որը որևէ դրոշակ չի ավելացնում, օրինակ՝ եկամուտը դրոշակի գնի տակ, այնուհանդերձ ուղարկում է SCAN առանց ավելացված դրոշակների։

Որ իրադարձությունն է ինձ ասում, որ հաճախորդը հաղթել է անվասարքում?

LOTTERY_WIN, ուղարկվում է միայն մեկ անգամ, երբ եկանակը պտտվում է: Եկանակ, որը սպասում է պտտվելուն, դեռ ոչինչ չի ուղարկում:

Կարո՞ղ եմ իմանալ, երբ հաճախորդը քարտը հանում է իրենց դրամապանակից:

Այո: Հասցե ավելացնելը դրամապանակին և այն հեռացնելը ուղարկում է CARD_ADDED_TO_WALLET և CARD_REMOVED_FROM_WALLET՝ համապատասխանաբար դրամապանակով, Apple կամ Google։

Ինչպես կարող եմ ստանալ նոր հաճախորդի կարծիքներ Webhook-ի միջոցով?

Բացեք Webhook-ի էջը և նշեք Reviews դրա օբյեկտների մեջ: Ապա յուրաքանչյուր նոր ակնարկ գալիս է entity review և action created-ով; Webhook-ը, որը ավելացվել է API & integrations տակ, ստանում է միայն Stamp card-ի իրադարձություններ մինչև այդ պահը:

Երբ յուրաքանչյուր իրադարձություն ուղարկվում է

Հատուկ իրադարձությունՈւղարկվել է երբ
SCANԱշխատակիցը մուտք գործելու համար սկանավորում է քարտը՝ 7Stamp Scanner-ում, API-ի միջոցով կամ POS-ից՝ օրինակ Toast: 7Stamp Scanner-ում հանված թելերով նշումները SCAN են՝ բացասական stamps_added-ով
DELIVERY_INSERTՀաճախորդը բացում է Մուխկոդ, որը տալիս է Մուխեր՝ QR, հղում, ինքն кодը կամ հրավեր ստեղծված API-ի միջոցով
RECEIPT_SCANՀաճախորդը սկանավորում է ֆինանսական կտրոնը Գործունեության չատ-բոթում, և այն մրջնանշվում է; amount-ը կտրոնի ընդհանուր գումարն է
CARD_JOINEDՀաճախորդը ստանում է նոր տպագիր քարտ, ցանկացած ձևով, այն external_id համարը, որը դուք ներմուծեցիք
REWARD_EARNEDՄակնիշային սկանավորումը հասնում է Award նպատակին
VOUCHER_ISSUEDՄի սկան հասնում է վաուչերի նպատակին
LOTTERY_WINLottery գլորակը պտտվում է և տալիս է պարգև
VOUCHER_PACKՆոր քարտը ստանում է Տպման քարտի Ակտիվացման փաթեթը, բոլոր դրա Վաուչերները մեկ իրադարձության մեջ
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 նպատակով, յուրաքանչյուրը ուղարկվել է սկաների սեփական իրադարձությունից հետո։

Վեբհուկ ուղարկվո՞ւմ է, երբ մետաղադրամները հեռացվում են։

Այո։ 7Stamp Scanner-ում հանված նշանները գալիս են որպես SCAN՝ բացասական stamps_added-ով։

Ի՞նչ տարբերություն կա VOUCHER_ISSUED-ի և ADMIN_VOUCHER_ISSUE-ի միջև?

VOUCHER_ISSUED գալիս է, երբ սկանը հասնում է Վաուչեր նպատակին։ ADMIN_VOUCHER_ISSUE գալիս է, երբ Վաուչերը տրվում է անմիջապես քարտին, ձեռքով ադմինիստրատորի միջոցով կամ API-ի միջոցով։

Ուժկապը զանգվածված հաճախորդն ուղարկում է մեկ իրադարձություն՞, թե մի քանի:

Որոշ. CARD_JOINED գալիս է առաջինը, հետո VOUCHER_PACK, եթե Stamp քարտի մեջ կա Voucher փաթեթ, ապա DELIVERY_INSERT՝ կնիքները ցուցադրելով:

Իմն՞ է յուրաքանչյուր արշավային հաղորդագրության համար միջոցառման ստացումը:

CARD_CAMPAIGN-ը ուղարկվում է յուրաքանչյուր քարտի համար, որը հասնում է Գաղափարի, այն ժամանակ, երբ Գաղափարը ունի Վաուչեր։

Ինչ է ստանում Վեբհուկը

Յուրաքանչյուր իրադարձություն ունի նույն 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-ի գաղտնի բանալիով: Գաղտնի բանալին ցուցադրվում և վերաթ generación է Webhook-ի էջում: Basic auth գրանցում և գաղտնաբառ ևս կարելի է ավելացնել:

Ինչպե՞ս ստուգեմ, որ Webhook-ը իսկապես գալիս է 7Stamp-ից:

Հաշվել HMAC-SHA256-ը ժամանակի նշագծի և հում մարմնի վրա՝ օգտագործելով Webhook-ի գաղտնի բանալին և այն համեմատել X-Webhook-Signature հեդերի հետ։

Որտե՞ղ կարող եմ գտնել Webhook-ի գաղտնի բանալին։

Webhook-ի էջում, որտեղ այն նույնպես կարելի է վերականգնել։

Կարե՞մ արդյոք պաշտպանել իմ վերջնակետը գաղտնաբառով։

Այո։ Բազման աստիճանի վավերացում (Basic auth) նամականիշը և գաղտնաբառը կարող են ավելացվել Webhook-ին, կարգաբերումից բացի:

Անհաջող առաքումներ

Ներկայացում, որը չստանում է 2xx պատասխան երեսուն վայրկյանը ընթացքում, փորձարկվում է մինչև տաս անգամ, յուրաքանչյուր սպասման ժամանակը նախորդից չորս վայրկյալով ավելի երկար, այնպես որ փորձարկումները ավարտվում են մոտավոր չորս րոպեում: 429 պատասխան Retry-After-ով փորձարկվում է այդ ժամանակից հետո: Իշխողության առաջին ձախողումը հանդերձում է ծանուցում ադմինիստրատորի համար:

Դառան մեկ հարյուր անընդհատ ձախողված առաքումներից հետո Webhook-ը заблокирован է համակարգի կողմից և այլևս ոչ մի դեպք չի ստանում։ Նրա էջը նախազգուշացնում է դրանից առաջ և ունի Անբլոկի կոճակ։ Մի հաջողակ առաքումս վերականգնում է հաշիվը։

Յուրաքանչյուր Webhook-ի էջում կա դրա առաքումների տարեգրություն, որտեղ նշված է գնացյալ հարցումն ու ստացված պատասխանը: Վերսկսումը կրկին նույն իրադարձությունն է ուղարկում, միայն այս Webhook-ին:

Իմ սերվերը դադարեցվել էր: Արդյոք միջոցառումները կորե՞լ են:

Յուրաքանչյուր առաքում փորձարկվում է մինչև տաս անգամ մոտ չորս րոպեի ընթացքում: Դրանից հետո բացեք Webhook-ի գրացուցակը և օգտագործեք Resend՝ անհրաժեշտ իրադարձությունների համար:

Ինչո՞ւ է իմ Webhook-ը դադարեցրել իրադարձությունների ստացումը:

Հարյուր անքայլ հաջողված առաքումներից հետո համակարգը այն արգելափակել է։ Մերկացրեք վերջնակետը և սեղմեք «Անարգելափակել» Webhook էջում։

Կարո՞ղ եմ տեսնել, թե ինչ է ուղարկվել իմ Webhook-ին:

Այո։ Յուրաքանչյուր Webhook-ի էջը ունի առաքումների օրագիր, որտեղ նշված է ուղարկված հարցումը և ստացված պատասխանը։

ԱԿակցությունների ներդրման ներդիր

Ընդհանուր ինտեգրացիաների պահիկ

Միացման ներդիրում ցուցադրվում են պատրաստի ճանապարհները խմբերով՝

  • Մուսագրեք ձեր հաշվեգրման պահին — Poster, Toast, Ձեր սեփական POS կամ CRM և Չե՞ք տեսնում ձեր POS‑ը։
  • Ֆիսկալական եկամուտներ — SmartKasa;
  • Ավտոմատացում — Make, Zapier և Հասարակ Swagger.

Յուրաքանչյուր քարտ ցույց է տալիս, թե արդյոք այն պահանջում է API բանալին։ Թաբը առաջարկում է նույն քարտերը բոլոր երկրներում; միայն ֆիսկալական հաշիվներն են սահմանափակվում ըստ երկրի։

Քո սեփական POS կամ CRM

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 ստռափք բանալիով Staff Login-ի համար։ Նրա հայրանիշները համարվում են այդ Staff Login-ի Card Operations-ն։

Ինչպե՞ս կարող եմ միացնել Poster-ը:

Բացեք Ինտեգրացիաները → 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 կիոսկում կամ հյուրերի համար նախատեսված էկրանին՝ օգտագործելով հեռախոսահամար կամ էլեկտրոնային հասցե։ Stamp քարտը տրվում է անմիջապես; հյուրն ոչինչ չի ստանում 7Stamp-ից, մինչև այն չբացի նույն հեռախոսով կամ էլեկտրոնային հասցեով։

Ինչու է Toast ասում՝ Շուտով կհայտնվի՞

Toast հասանելիությունը մեկ միացուցիչ է ամբողջ պլատֆորմի համար, ոչ թե ձեր բիզնեսի կարգավորում: Մինչ այն միացված չէ, միանալու ոչինչ չկա:

Ինչպես է Toast գտնվելու վայրը կապակցված?

Իր GUID-ով մեկ Ստորաբաժնի մուտքի համար, առանց API բանալիի: Անդամի մուտքի դրոշմի քարտն ու պլանը կիրառվում են տեղանքի յուրաքանչյուր խնդրագրի վրա:

Ի՞նչ է լինում տոմսերին, երբ Toast-ը չեկը անվավեր ճանաչում է:

Երբ Toast-ը հետ է մնում գործարքից, դրա դրոշմերը հետ են վերցվում կամ դրա վերածված Վաուչերները վերականգնվում են:

SmartKasa

SmartKasa Ինտեգրացիաների ներդիրում

SmartKasa-ին ոչինչ չի պետք API բանալիից: Այն կտրոնի աղբյուր է Կտրոնների սկանավորման մեջ, ավելացվել է SmartKasa խանութի ID կողմից կամ ընկերության կոդի միջոցով, որպեսզի ընդգրկի յուրաքանչյուր խանութ։ Հաճախորդները սկանավորում են SmartKasa կտրոնը Բիզնեսի Չաթբոտում, և դրոշմերը գնում են այդ կտրոնի աղբյուրի Հիվանդառության մուտքի աշխատակցի հաշվին։

SmartKasa-ը ուկրաինացի է, և ֆինանսական կտրոնները գործում են միայն Ուկրաինայում, Սլովակիայում, Ղազախստանում և Ուզբեկստանում։

Ինձ պետք է API բանալի SmartKasa-ի համար?

Ոչ։ SmartKasa-ը կտրոնի աղբյուր է Կտրոնի սկանավորման մեջ, ավելացված է ID խանութի կողմից կամ ընկերության կոդի միջոցով։

Որտեղ հաճախորդները սկանավորում են SmartKasa քտրոնը?

Ձեր բիզնեսի զրույցային ռոբոտում։ Թռիչքները ուղարկվում են այդ քաղվածքի աղբյուրի աշխատակիցների մուտք էջին։

Որ երկրներում է գործում բյուջետային զանգվածը:

Ուկրաինայում, Սլովակիայում, Ղազախստանում և Ուզբեկստանում։

Make և Zapier

Make Ինտեգրացիաների ներդիրում

Make-ի համար 7Stamp հավելվածը Make-ի հանրային հավելվածների կատալոգում է՝ որոնեք 7Stamp ցանկացած Make սցենարում կամ օգտագործեք Open in Make Ինտեգրացիաների ներդիրում։ Մեր Zapier հավելվածը Zapier-ի հանրային կատալոգում չէ՝ Open in Zapier-ը հրավեր է, որն ավելացնում է հավելվածը Բիզնեսի սեփական Zapier հաշվին։ Երկու հավելվածներն էլ աշխատում են Staff Login-ի 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 վեբհուքերի միջոցով: Գործողություններ ինչպես մետաղադրամներ ավելացնելը կամ վաուչեր թողարկելն անհրաժեշտ է ընդամենը API բանալին:

Ինձ անհրաժեշտ է API բանալի Make-ի կամ Zapier-ի համար?

Այո։ Ծրավորները աշխատում են Staff Login-ի API կոդով։

Reference
Operations 28 October 2026

Պլաններ և հաշվառում

Երեք պլանները, ինչ է Card Operation-ը, ինչ է հաշվում և ինչ է անվճար, լրացումները, Packages-ը Access Code-ից և ինչ է տեղի ունենում վճարման ձախողման դեպքում։

Թարմացված: 28 October 2026

Բացել հոդվածը
Reference
Operations 28 October 2026

Աշխատակիցների հասանելիություն

Ինչ է աշխատակազմի մուտքագրումը, ինչպես ստեղծել, փոխել, անջատել և ջնջել այն, ինչպես աշխատակիցները մուտք են գործում 7Stamp Scanner, ինչ կարող են անել այնտեղ և ով է օգտագործում ադմինիստրատիվ պանելը:

Թարմացված: 28 October 2026

Բացել հոդվածը
Reference
Operations 28 October 2026

Հաճախորդներ և պատմություն

Հաճախորդների կնիքի քարտերի ցուցակը, Հաճախորդի քարտի էջը, քարտի ջնջում, Իրադարձությունների օրագիրը, ինչ է 7Stamp պահպանում Հաճախորդի մասին և ինչպես է Հաճախորդի տվյալները ջնջվում։

Թարմացված: 28 October 2026

Բացել հոդվածը