Reference Operations

API, ওয়েবহুক ও ইন্টিগ্রেশন

স্টাফ লগইনগুলো-এর জন্য API কী, API কী করে, ওয়েবহুক এবং তাদের ইভেন্ট, পে-লোড, সিগনেচার এবং পুনরায় চেষ্টা, এবং প্রস্তুত ইন্টিগ্রেশনগুলো: Poster, Toast, SmartKasa, Make এবং Zapier।

Quick read

আপডেট হয়েছে: 19 November 2026

API এবং ইন্টিগ্রেশন

API কীস API এবং ইন্টিগ্রেশনগুলিতে

সেটিংস → API এবং ইন্টিগ্রেশনগুলিতে তিনটি ট্যাব রয়েছে: API কী, ওয়েবহুক এবং ইন্টিগ্রেশন।

API এবং API কী প্রতিটি পরিকল্পনায় মুক্ত, Free Forever সহ; কোনো API অ্যাড-অন নেই। স্ট্যাম্প যা API এর মাধ্যমে দেওয়া হয় তা অন্যান্য যেকোনো Card Operations এর মতো, তাই এগুলি পরিকল্পনার Card Operations শেষ হলে বন্ধ হয়ে যায়। ওয়েবহুক হল পেইড অংশ, নিচে দেখুন।

API কি অতিরিক্ত খরচ করবে?

না। API এবং API চাবিগুলি প্রতিটি প্ল্যানে ফ্রি, Free Foreverসহ। এর মাধ্যমে দেওয়া স্ট্যাম্প যেকোনো অন্য Card Operations এর মতো।

আমি কি API Free Forever তে ব্যবহার করতে পারি?

হ্যাঁ। যখন পরিকল্পনার Card Operations শেষ হয়ে যাবে, স্ট্যাম্প API এর মাধ্যমে অন্য কোনও মতো বন্ধ হয়ে যাবে।

API সেটিংস কোথায়?

সেটিংস → API ও ইন্টিগ্রেশনে, তিনটি ট্যাবসহ — API কী, ওয়েবহুক এবং ইন্টিগ্রেশন।

API চাবি

স্টাফ লগইন এর জন্য API কী তৈরি করুন

API কী এর অধীনে একটি API কী তৈরি করা হয়েছে → একটি স্টাফ লগইন জন্য একটি API কী যোগ করুন। একটি স্টাফ লগইন-এর সর্বাধিক একটি API কী থাকতে পারে, এবং বন্ধ করা স্টাফ লগইন নির্বাচন করা যায় না। কোন স্টাফ লগইন নির্বাচন করার জন্য না থাকলে, Generate API কী উইন্ডো সেখানে একটি তৈরি করার প্রস্তাব দেয়; একটি নতুন স্টাফ লগইন একটি ফ্রি Staff Seat প্রয়োজন, এবং পরিপূর্ণ প্লানে উইন্ডো একটি আসন যোগ করতে বা পরিবর্তে একটি প্ল্যান নির্বাচন করতে প্রস্তাব দেয়।

API কী দিয়ে প্রতিটি কল করা হয় তার স্টাফ লগইন হিসাবে কাজ করে: এটি শুধুমাত্র সেই স্টাফ লগইন এর ব্যবসা, স্ট্যাম্প স্বয়ংক্রিয় স্ট্যাম্প অনুযায়ী নির্বাচিত স্ট্যাম্প কার্ড, এবং এর স্ট্যাম্প গণনা সেই স্টাফ লগইন এর Card Operations হিসাবে পৌঁছায়।

চাবিটি যে কোনো সময় API চাবির তালিকা থেকে দেখানো এবং কপি করা যেতে পারে। এটি একটি QR কোড হিসেবে দেখানোও যেতে পারে, টার্মিনালে স্ক্যান করার জন্য, এবং স্টাফ লগইন-এর নামসহ মুদ্রণ করা যেতে পারে।

আমি কিভাবে একটি API কী তৈরি করব?

সেটিংসে → API & ইন্টিগ্রেশনস → API কি-তে, Add API কি বেছে নিন এবং একটি স্টাফ লগইন নির্বাচন করুন। প্রতিটি স্টাফ লগইন-র সর্বোচ্চ একটিমাত্র API কী থাকতে পারে।

আমি আমার API চাবি হারিয়েছি। আমার কি নতুন একটি প্রয়োজন?

না। চাবিটি যে কোনো সময় API চাবির তালিকা থেকে দেখা এবং অনুলিপি করা যেতে পারে, বা QR কোড হিসেবে প্রদর্শিত হতে পারে।

কোন স্ট্যাম্প কার্ড কে API স্ট্যাম্প কল করে?

যে ব্যক্তিকে কীগুলির স্টাফ লগইন-এর জন্য স্বয়ংক্রিয় স্ট্যাম্প-এর অধীনে নির্বাচিত করা হয়েছে। এর স্ট্যাম্প সংখ্যা সেই স্টাফ লগইন-এর Card Operations হিসাবে।

আমি নতুন চাবির জন্য কেন স্টাফ লগইন বাছাই করতে পারছি না?

একটি বন্ধ স্টাফ লগইন কে বাছাই করা যায় না, এবং একটি স্টাফ লগইন যার কাছে ইতিমধ্যেই একটি চাবি রয়েছে তা আরেকটি পেতে পারবে না। বাছাই করার মতো কিছু না থাকায়, উইন্ডো একটি স্টাফ লগইন তৈরি করার প্রস্তাব দেয়।

যখন একটি API কী কাজ করা বন্ধ করে

একটি API কী কখনো মেয়াদ শেষ হয় না। এটি কেবল তখনই কাজ করা বন্ধ করে যখন এটি পুনরায় তৈরি করা হয় বা মুছে ফেলা হয়, অথবা যখন এর স্টাফ লগইন বন্ধ করা হয় বা মুছে ফেলা হয়। স্টাফ লগইন এর নতুন পাসওয়ার্ড বা লগইন এটি প্রভাবিত করে না।

  • Regenerate স্টাফ লগইন-কে একটি নতুন API কী দেয়; পুরানোটি সঙ্গে সঙ্গে কাজ করা বন্ধ করে।
  • মুছে ফেলা চাবিটি সঙ্গে সঙ্গে থামিয়ে দেয়। স্টাফ লগইন নিজেই 7Stamp Scanner-এ কাজ চালিয়ে যায় এবং পরে একটি নতুন চাবি পেতে পারে।
  • স্টাফ লগইন বন্ধ করলে তার কি বজায় থাকে: যখন স্টাফ লগইন পুনরায় চালু করা হয়, একই কি আবার কাজ করে।

একটি API কী কি আবদ্ধ হয়?

না। এটি কেবল তখনই কাজ করা বন্ধ করে যখন এটি পুনঃউত্পাদিত বা মুছে ফেলা হয়, অথবা যখন এর স্টাফ লগইন বন্ধ বা মুছে ফেলা হয়।

আমি স্টাফ লগইন-এর পাসওয়ার্ড পরিবর্তন করেছি। কি আমাকে একটি নতুন API কী প্রয়োজন?

না। একটি নতুন পাসওয়ার্ড বা লগইন API কী এর উপর কোনও প্রভাব ফেলে না।

আমি একটি স্টাফ লগইন আবার চালু করেছি। এর পুরানো API কী কাজ করবে কি?

হ্যাঁ। একটি স্টাফ লগইন বন্ধ করলে তার কী অক্ষুন্ন থাকে, এবং এটি পুনরায় চালু হলে একই কী আবার কাজ করে।

API কী করে

API-এর মাধ্যমে একটি সিস্টেম করতে পারে:

  • স্ট্যাম্প কার্ড লিঙ্ক হিসেবে বা QR হিসেবে বিতরণ করুন;
  • স্ট্যাম্প যোগ করুন;
  • এর স্ট্যাম্প, লক্ষ্য এবং ভাউচার এর সাথে একটি কার্ড পড়ুন;
  • ভাউচার সরাসরি একটি কার্ডে ইস্যু করুন;
  • ভাউচার কোড দিয়ে একটি ভাউচার রিডিম করুন;
  • গ্রাহক-কে একটি বার্তা পাঠান।

API ব্যবসা-এর নিজস্ব শনাক্তকারী যেমন CRM ID, ফোন বা ইমেইল, যা external_id হিসেবে পাঠানো হয়, দিয়ে গ্রাহক-এর কার্ড খুঁজে পায়। শনাক্তকারী কার্ডে সংরক্ষিত হয় এবং এর সম্পর্কে প্রতিটি ওয়েবহুকে ফিরে আসে। API-এর কোন কল নেই যা ব্যবসা-এর গ্রাহকরা তালিকাভুক্ত করে: পুরো গ্রাহক বেস কেবল প্রশাসক রপ্তানি মাধ্যমে বের করা হয়।

একটি API কী-এর পরিবর্তে, একটি অ্যাপ একটি স্টাফ লগইন-এর লগইন এবং পাসওয়ার্ড দিয়ে সাইন ইন করতে পারে — একটি ডিভাইসের জন্য যা একটি ক্যাশিয়ার সাইন ইন করে। একটি API কী এমন একটি ডিভাইসের সাথে মানানসই যা অযথা চলতে থাকে। ওয়েবহুক শুধুমাত্র অ্যাডমিনে যোগ করা হয়; API-এর ইভেন্টে সাবস্ক্রাইব করার বা তালিকা দেখানোর কোনো কল নেই।

API কোনো অনুরোধের হার সীমা নির্ধারণ করে না: কলের সংখ্যা বা ঘনত্বের দ্বারা এটি সীমাবদ্ধ হয় না, এবং একই কার্ড তৎক্ষণাৎ পুনরায় স্ক্যান করা যেতে পারে। যা এর মাধ্যমে স্ট্যাম্প করতে সীমিত করে তা হলো প্ল্যানের Card Operations।

আমরা কি আমাদের নিজস্ব CRM বা POS থেকে স্ট্যাম্প যোগ করতে পারি?

হ্যাঁ, API-এর মাধ্যমে। এটি স্ট্যাম্প কার্ড বিতরণ করে, স্ট্যাম্প যোগ করে, কার্ড পড়ে এবং ভাউচার ছাড় দেয়। ইভেন্ট সম্পর্কে আপনার সিস্টেমকে জানানোর জন্য একটি Webhook যোগ করুন — এর জন্য Webhooks & Events অ্যাড-অন প্রয়োজন।

আমরা কি তথ্য রপ্তানি করতে পারি?

API এর মাধ্যমে আপনি আপনার নিজস্ব পরিচয়কারীর মাধ্যমে কার্ডগুলি পড়েন, এবং Webhooks ঘটনার মতো ঘটনাগুলি পাঠায়। API এর কাছে সমস্ত গ্রাহকরা এর তালিকা নেই — পুরো গ্রাহক বেসটি অ্যাডমিন এক্সপোর্টের মাধ্যমে বের করা হয়।

API কীভাবে গ্রাহক-এর কার্ড খুঁজে পায়?

আপনার নিজের পরিচয়কারী দ্বারা — একটি CRM ID, ফোন বা ইমেল — external_id হিসেবে পাঠানো। এটি কার্ডে সংরক্ষিত হয় এবং এর সাথে সম্পর্কিত প্রতিটি Webhook-এ ফিরে আসে।

আমি কি API এর মাধ্যমে ওয়েবহুকস সাবস্ক্রাইব করতে পারি?

না। ওয়েবহুক শুধুমাত্র অ্যাডমিনে যোগ করা হয়।

API এর কি একটি রেট সীমা আছে?

না। কলগুলো সংখ্যা বা ঘনত্ব দ্বারা সীমাবদ্ধ নয়, এবং একই কার্ড আবারও সঙ্গে সঙ্গে স্ক্যান করা যেতে পারে। স্ট্যাম্পing শুধুমাত্র পরিকল্পনার 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 কী এবং ওয়েবহুকস একইভাবে কাজ করে।

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 কী এবং ওয়েবহুকগুলি একইভাবে কাজ করে।

ওয়েবহুক

API এ ওয়েবহুক এবং ইন্টিগ্রেশন

একটি ওয়েবহুক API এর অধীনে যোগ করা হয়েছে এবং ইন্টিগ্রেশন → ওয়েবহুক → ওয়েবহুক যোগ করুন, যেখানে URL ইভেন্টগুলি গ্রহণ করে। 7Stamp এ স্ট্যাম্প কার্ড ইভেন্টের জন্য একটি ওয়েবহুক তৈরি করা হয়েছে। একটি ব্যবসা বিভিন্ন ওয়েবহুক যোগ করতে পারে, প্রতিটির সাথে তার নিজস্ব URL রয়েছে।

ওয়েবহুকগুলির জন্য Webhooks & Events অ্যাড-অন প্রয়োজন, $19 প্রতি মাসে, শুধুমাত্র পেইড প্ল্যানে উপলব্ধ। প্রথম ওয়েবহুক যোগ করার সময় এটি কিনতে প্রস্তাব দেওয়া হয়; এটি ছাড়া কোনো ওয়েবহুক তৈরি বা পুনরায় চালু করা যায় না। একটি অ্যাড-অন একটি ওয়েবহুক চালু রাখে: আরও যোগ করা যায়, কিন্তু সাবস্ক্রিপশনের প্রতিটি বিলিং আপডেটে সবচেয়ে পুরনোটি ছাড়া সবগুলো বন্ধ হয়ে যায়।

ওয়েবহুক যোগ করার মুহূর্ত থেকে ইভেন্টগুলি ঘটে যাওয়ার সাথে সাথেই পাঠায়। পূর্বের ইভেন্টগুলি পাঠানো হয় না।

ওয়েবহুক কি বিনামূল্যে?

না। তাদের Webhooks & Events অ্যাড-অন, $19 প্রতি মাসে প্রয়োজন, যা কেবল পেইড প্ল্যানে প্রদান করা হয়। API নিজেই বিনামূল্যে।

আমি একটি দ্বিতীয় ওয়েবহুক যোগ করেছি এবং এটি বন্ধ ছিল। কেন?

একটি Webhooks & Events অ্যাড-অনের একটি ওয়েবহুক চালু রাখে। সাবস্ক্রিপশনের প্রতিটি বিলিং আপডেট সবকটি ওয়েবহুক বন্ধ করে দেয় কেবল সবচেয়ে পুরনোটি ছাড়া।

নতুন ওয়েবহুক কি অতীতের ঘটনা পাঠাবে?

না। ইভেন্টগুলি তখন থেকেই পাঠানো হয় যখন ওয়েবহুকটি যোগ করা হয়।

ওয়েবহুক ইভেন্টস

একটি ওয়েবহুক পনেরোটি স্ট্যাম্প কার্ড ইভেন্ট পায়, 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। শেষ দুটি আসে যখন পাসটি একটি ওয়ালেটে যুক্ত করা হয় বা তা থেকে সরানো হয়, ওয়ালেটটি, অ্যাপল বা গুগল দিয়ে।

একটি স্ক্যান যা কোনো স্ট্যাম্প যোগ করে না, যেমন স্ট্যাম্প-এর নিচের ক্রয়, তবুও শূন্য স্ট্যাম্প যোগ সহ SCAN প্রেরণ করে। একটি চক্রে জয়ী হওয়া একটি পুরস্কার চক্র ঘুরালে একটি LOTTERY_WIN দ্বারা ঘোষণা করা হয়, REWARD_EARNED বা VOUCHER_ISSUED দ্বারা নয়; ঘোরানোর জন্য অপেক্ষমাণ একটি চক্র এখনও কিছুই প্রেরণ করে না।

গ্রাহক পর্যালোচনা স্ট্যাম্প কার্ড ঘটনা নয়। প্রতিটি নতুন পর্যালোচনা একটি ইভেন্ট প্রেরণ করে যার সত্তা review এবং ক্রিয়া created, সেই ওয়েবহুকগুলিতে যেগুলির অবজেক্টে ওয়েবহুক পৃষ্ঠায় Reviews টিক চিহ্নিত রয়েছে। এখানে যুক্ত করা একটি ওয়েবহুক শুধুমাত্র স্ট্যাম্প কার্ড ঘটনার জন্য সেট করা হয়, তাই এটি পর্যালোচনা পায় যখন Reviews টিক করা হয়।

একটি স্ক্যান যখন কোনো স্ট্যাম্প যোগ করে না তখন কি একটি ওয়েবহুক পাঠানো হয়?

হ্যাঁ। একটি স্ক্যান যা কোনও স্ট্যাম্প যোগ করে না, যেমন স্ট্যাম্প মূল্যের নিচে একটি ক্রয়, তবুও SCAN পাঠায় শূন্য স্ট্যাম্প যোগ করা হলো।

কোন অনুষ্ঠান আমাকে বলে যে গ্রাহক চাকাতে জিতেছে?

LOTTERY_WIN, একবার পাঠানো হয় যখন চাকা ঘোরানো হয়। ঘোরানোর জন্য অপেক্ষা করা একটি চাকা এখনও কিছু পাঠায় না।

আমি কি বলতে পারি কখন কোনো গ্রাহক তাদের ওয়ালেট থেকে কার্ডটি বের করে?

হ্যাঁ। একটি ওয়ালেটে পাস যোগ করা এবং তা অপসারণ করা CARD_ADDED_TO_WALLET এবং CARD_REMOVED_FROM_WALLET পাঠায়, ওয়ালেট, অ্যাপল বা গুগলের সাথে।

আমি কীভাবে একটি ওয়েবহুকের মাধ্যমে নতুন গ্রাহক রিভিউ পেতে পারি?

ওয়েবহুকের পেজ খুলুন এবং এর অবজেক্টগুলির মধ্যে রিভিউগুলো টিক করুন। প্রতিটি নতুন রিভিউ এরপর এন্টিটি রিভিউ এবং অ্যাকশন ক্রিয়েটেড সহ আসে; API এর অধীনে একটি ওয়েবহুক এবং ইন্টিগ্রেশনগুলো তখন পর্যন্ত শুধুমাত্র স্ট্যাম্প কার্ড ইভেন্টগুলো পায়।

যখন প্রতিটি ঘটনা পাঠানো হয়

ঘটনাযখন প্রেরিত হয়
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_WINএকটি Lottery চাকা ঘুরানো হয় এবং একটি পুরস্কার দেয়
VOUCHER_PACKএকটি নতুন কার্ড স্ট্যাম্প কার্ড এর ভাউচার প্যাক পায়, তার সমস্ত ভাউচার এক ঘটনা মধ্যে
ADMIN_VOUCHER_ISSUEA ভাউচার সরাসরি একটি কার্ডে ইস্যু করা হয়, অ্যাডমিনে বা 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 যদি স্ট্যাম্প কার্ড এর একটি ভাউচার প্যাক থাকে, তারপর DELIVERY_INSERT আসে স্ট্যাম্প-এর সাথে।

প্রতিটি প্রচারণার মেসেজের জন্য কি আমি একটি ইভেন্ট পাবো?

CARD_CAMPAIGN প্রতিটি কার্ডকে পাঠানো হয় যার কাছে ক্যাম্পেইন পৌঁছায়, ক্যাম্পেইনের ভাউচার সহ যখন এটি একটি বহন করে।

একটি ওয়েবহুক যা গ্রহণ করে

প্রতিটি ইভেন্টের একই JSON বডি আছে: ইভেন্ট ID, ব্যবসা, এবং তার প্রকারের ইভেন্ট, স্ট্যাম্প কার্ড, স্ট্যাম্প আগে এবং পরে, ক্রয় পরিমাণ, অর্ডার ID এবং external_id ইন্টিগ্রেশন যা পাঠিয়েছে, স্টাফ লগইন যা এটি পরিবেশন করেছে, ভাউচার এবং পুরস্কার এটি দিয়েছে, এবং গ্রাহক এর নাম, ইমেল, Telegram, WhatsApp ফোন এবং জন্মতারিখ।

amount হল ক্ষুদ্র এককে (সেন্টে) ক্রয় পরিমাণ: 12.50 পরিমাণ স্ক্যানের মাধ্যমে পাঠালে এটি 1250 আসে। যখন ইভেন্টে কোনো পরিমাণ থাকে না তখন এটি শূন্য থাকে।

ইভেন্ট ID বডিতে এবং X-Webhook-Event-Id হেডারে রয়েছে। একই ইভেন্ট পুনরায় চেষ্টা করলে এর ID থাকে, তাই রিসিভার পুনরাবৃত্তি বাদ দিতে পারে। একটি Make বা Zapier URL এর জন্য ইভেন্টটি data এর পরিবর্তে card_event কী-এর অধীনে থাকে।

গ্রাহক সম্পর্কে একটি ওয়েবহুক কোন ডেটা বহন করে?

নাম, ইমেইল, Telegram, WhatsApp ফোন এবং জন্ম তারিখ, একত্রে স্ট্যাম্প কার্ড, স্ট্যাম্প আগে এবং পরে, এবং ভাউচার এবং পুরস্কার দেওয়া হয়েছে।

পরিমাণ কোন এককে আছে?

ক্ষুদ্র এককে (সেন্টে)। স্ক্যানের সঙ্গে পাঠানো 12.50 পরিমাণটি 1250 হিসেবে আসে; যখন ঘটনায় কোনো পরিমাণ থাকে না তখন এটি খালি থাকে।

আমি কীভাবে একই ইভেন্ট দুবার প্রক্রিয়াকরণ থেকে বিরত থাকতে পারি?

বডিতে এবং X-Webhook-Event-Id হেডারে ইভেন্ট ID ব্যবহার করুন। পুনরায় চেষ্টা করলে একই ID থাকবে।

Make-তে card_event-এর অধীনে ইভেন্ট কেন আছে?

Make বা Zapier URL এর জন্য ইভেন্টটি data এর পরিবর্তে card_event কী এর নিচে থাকে, তাই তাদের অ্যাপগুলো এটি আলাদা চিহ্নিত করতে পারে।

স্বাক্ষর

প্রতি ডেলিভারিতে স্বাক্ষর করা হয়। X-Webhook-Signature হেডারটি একটি timeস্ট্যাম্প এবং সেই timeস্ট্যাম্প এবং কাঁচা বডির HMAC-SHA256 ধারণ করে, যা ওয়েবহুকের সিক্রেট কী দিয়ে কী করা হয়েছে। সিক্রেট কীটি ওয়েবহুকের পৃষ্ঠায় প্রদর্শিত হয় এবং পুনরায় উত্পন্ন করা যায়। একটি বেসিক অথ লোগইন এবং পাসওয়ার্ডও যোগ করা যেতে পারে।

আমি কীভাবে পরীক্ষা করব যে একটি ওয়েবহুক সত্যিই 7Stamp থেকে এসেছে?

Webhook-এর গোপন কী ব্যবহার করে timeস্ট্যাম্প এবং কাঁচা বডির HMAC-SHA256 হিসাব করুন এবং এটি X-Webhook-Signature হেডারের সাথে তুলনা করুন।

আমি ওয়েবহুকের গোপন কী কোথায় পাব?

ওয়েবহুকে-এর পৃষ্ঠায়, যেখানে এটি পুনরায় তৈরি করাও সম্ভব।

আমি কি একটি পাসওয়ার্ড দিয়ে আমার এন্ডপয়েন্ট নিরাপদ করতে পারি?

হ্যাঁ। একটি বেসিক অথেন্টিকেশন লগইন এবং পাসওয়ার্ড সিগনেচারের উপরে ওয়েবহুকে যোগ করা যেতে পারে।

ব্যর্থ বিতরণ

যে ডেলিভারিতে ত্রিশ সেকেন্ডের মধ্যে 2xx উত্তর আসে না তা সর্বাধিক দশবার পুনরায় প্রচেষ্টা করা হয়, প্রতিটি অপেক্ষা শেষটির চেয়ে চার সেকেন্ড বেশি হয়, তাই পুনরায় প্রচেষ্টা প্রায় চার মিনিটের মধ্যে শেষ হয়। Retry-After সহ 429 উত্তর সেই সময়ের পরে পুনরায় চেষ্টা করা হয়। একটি ইভেন্টের প্রথম ব্যর্থতা প্রশাসকে একটি বিজ্ঞপ্তি প্রদান করে।

ক্রমাগত একশোটি ব্যর্থ ডেলিভারির পর সিস্টেম দ্বারা ওয়েবহুক ব্লক করা হয় এবং আর কোনো ইভেন্ট পায় না। এর পেইজ আগে সতর্ক করে এবং একটি আনব্লক বাটন থাকে; একবার সফল ডেলিভারিটি গণনা রিসেট করে।

প্রতিটি ওয়েবহুকের পৃষ্ঠায় এর ডেলিভারির একটি জার্নাল থাকে, যেখানে পাঠানো অনুরোধ এবং প্রাপ্ত উত্তর থাকে। পুনঃপ্রেরণ একই ঘটনা আবার পাঠায়, শুধুমাত্র এই ওয়েবহুকের জন্য।

আমার সার্ভার ডাউন ছিল। ইভেন্টগুলো কি হারিয়ে গেছে?

প্রতিটি ডেলিভারিকে প্রায় চার মিনিটের মধ্যে সর্বাধিক দশবার পুনরায় চেষ্টা করা হয়। এর পরে, Webhook-এর জার্নাল খুলুন এবং প্রয়োজনীয় ইভেন্টগুলির জন্য Resend ব্যবহার করুন।

আমার ওয়েবহুক কেন ইভেন্ট গুলি গ্রহণ বন্ধ করেছে?

ক্রমাগত একশটি ব্যর্থ ডেলিভারির পর এটি সিস্টেম দ্বারা ব্লক করা হয়েছে। এন্ডপয়েন্ট ঠিক করুন এবং ওয়েবহুকের পৃষ্ঠায় আনব্লক চাপুন।

আমি কি দেখতে পারি আমার ওয়েবহুকে কী পাঠানো হয়েছে?

হ্যাঁ। প্রতিটি ওয়েবহুকের পৃষ্ঠায় ডেলিভারির একটি জার্নাল থাকে, যেখানে পাঠানো অনুরোধ এবং প্রাপ্ত উত্তর দেখানো থাকে।

ইন্টিগ্রেশনস ট্যাব

ইন্টিগ্রেশন্স ট্যাব

ইন্টিগ্রেশন ট্যাবটি গোষ্ঠী অনুযায়ী প্রস্তুত উপায়গুলি তালিকাভুক্ত করে:

  • স্ট্যাম্প আপনার চেকআউটে — Poster, Toast, আপনার নিজস্ব POS বা CRM এবং কি আপনার POS দেখাচ্ছে না?
  • আর্থিক রসিদসমূহ — SmartKasa;
  • Automation — Make, Zapier এবং Public Swagger।

প্রতিটি কার্ডে বলা থাকে যে এটি কি একটি API কী প্রয়োজন। ট্যাবটি প্রতিটি দেশে একই কার্ড অফার করে; শুধুমাত্র আর্থিক রসিদ দেশ দ্বারা সীমিত।

আপনার নিজের POS অথবা CRM

একটি White Label ব্যবসা কোনও Make, Zapier বা পাবলিক Swagger কার্ড দেখে না এবং Poster বা 7stamp.com-তে সেটআপ গাইড দেওয়া হয় না।

কোন কোন POS সিস্টেম সংযোগের জন্য প্রস্তুত?

Poster, এবং Toast একবার প্ল্যাটফর্মের জন্য চালু হলে — সেই পর্যন্ত এটি দেখায় শীঘ্রই আসছে। অন্যান্য সিস্টেমগুলি API মাধ্যমে সংযুক্ত হয়, আপনার নিজস্ব POS বা CRM দিয়ে।

ইন্টিগ্রেশন কি দেশের দ্বারা সীমিত?

না। ট্যাবটি প্রতিটি দেশে একই কার্ড প্রদান করে। শুধুমাত্র ফিসকাল রসিদ দেশভেদে সীমাবদ্ধ।

আমি কেন Make এবং Zapier দেখতে পাচ্ছি না?

তাদের একটি White Label ব্যবসা এ দেখানো হয় না। এর API কী এবং ওয়েবহুক একইভাবে কাজ করে।

Poster

Poster হল আমাদের অ্যাপ Poster মার্কেটপ্লেসে। Poster-তে ইনস্টল করলে তার লিস্টিং খোলে, এবং অ্যাপটি API কী সহ একটি স্টাফ লগইন দিয়ে সেটআপ করা হয়েছে। এর স্ট্যাম্প গণনা হিসাবে সেই স্টাফ লগইন-এর Card Operations।

আমি কিভাবে Poster সংযুক্ত করব?

ইনটিগ্রেশন খুলুন → Poster এবং Poster-এ ইনস্টল নির্বাচন করুন। অ্যাপটি একটি স্টাফ লগইন-এর API কী দিয়ে সেটআপ করা হয়েছে।

কার Card Operations কি Poster স্ট্যাম্প ব্যবহার করে?

যাদের স্টাফ লগইন আছে যাদের API কী অ্যাপটি ব্যবহার করে।

Poster এর জন্য কি আমার API চাবির প্রয়োজন?

হ্যাঁ, স্টাফ লগইন এর একটি API কী।

Toast

Toast প্রতিটি ব্যবসা-এর জন্য ‘শীঘ্রই আসছে’ দেখায় যতক্ষণ না Toast অ্যাক্সেস প্ল্যাটফর্মে সেট আপ হয়। এটি পুরো প্ল্যাটফর্মের জন্য একটি সুইচ, ব্যবসা-এর সেটিং নয়; একবার এটি অন হয়ে গেলে, Toast কার্ড নিজেই সেটআপ ধারণ করে।

প্রত্যেকটি Toast অবস্থান তার GUID এর মাধ্যমে একটি স্টাফ লগইন এর সাথে সংযুক্ত থাকে, কোনো API কী ছাড়াই: সেই স্টাফ লগইন এর ব্যবসা, স্ট্যাম্প কার্ড এবং পরিকল্পনা প্রতিটি Toast অনুরোধের জন্য প্রযোজ্য অবস্থান থেকে। একটি অবস্থান কেবল একটি স্টাফ লগইন এর সাথে সংযুক্ত হতে পারে, এবং একটি স্টাফ লগইন একটি অবস্থান ধরে রাখে। একটি অবস্থান থেকে অনুরোধগুলি প্রত্যাখ্যাত হয় একবার এটি সংযোগ বিচ্ছিন্ন হলে, অথবা যখন তার স্টাফ লগইন বন্ধ বা মুছে ফেলা হয়।

প্রতিটি ভাউচার একটি Toast মেনু প্রোডাক্ট দেওয়া যেতে পারে: Toast POS-এ এটি তখন সেই প্রোডাক্টে একটি ছাড় হয়ে যায়। একটি ভাউচার যার সাথে কিছু নেই, তা চেক-এ শূন্য ছাড় হিসেবে প্রয়োগ করা হয়, এবং ক্যাশিয়ার উপহারটি হাতে তুলে দেয়। ভাউচার গুলি Toast POS-এ রিডিম করা হয়, এবং একটি প্রদত্ত চেকের মাধ্যমে পৌঁছানো চাকা একবার ঘূর্ণন করা হয়। যখন Toast একটি লেনদেন রদ করে, তখন এর স্ট্যাম্প ফেরত নেওয়া হয় বা এর রিডিম করা ভাউচার পুনঃস্থাপন করা হয়।

একজন অতিথি Toast কিওস্ক বা অতিথি-সম্মুখ স্ক্রিনে ফোন নম্বর বা ইমেইল দিয়ে যোগদান করতে পারেন। স্ট্যাম্প কার্ড একবারে ইস্যু করা হয়; অতিথি 7Stamp থেকে কিছুই পান না যতক্ষণ না তারা তা একই ফোন বা ইমেইল দিয়ে খোলেন।

Toast কেন বলছে শীঘ্রই আসছে?

Toast অ্যাক্সেস হলো পুরো প্ল্যাটফর্মের জন্য একটি সুইচ, এটি আপনার ব্যবসা এর একটি সেটিং নয়। এটি চালু না হওয়া পর্যন্ত, সংযোগ করার কিছু নেই।

Toast অবস্থানটি কীভাবে সংযুক্ত?

এটি তার GUID-এর মাধ্যমে একটি স্টাফ লগইন-র কাছে, কোনও API কী ছাড়া। সেই স্টাফ লগইন-এর স্ট্যাম্প কার্ড এবং পরিকল্পনা প্রতিটি অনুরোধের জন্য প্রযোজ্য স্থান থেকে।

Toast একটি চেক বাতিল করলে স্ট্যাম্প এর কি হয়?

যখন Toast একটি লেনদেন বাতিল করে, তখন এর স্ট্যাম্প ফিরে নেওয়া হয় বা এর উদ্ধারকৃত ভাউচার পুনরুদ্ধার করা হয়।

SmartKasa

ইন্টিগ্রেশনস ট্যাবে SmartKasa

SmartKasa-কে কোনো API কীয়ের প্রয়োজন নেই। এটি রিসিপ্ট স্ক্যানিং-এ একটি রিসিপ্ট উৎস, যা একটি SmartKasa দোকান ID দ্বারা অথবা প্রতিটি দোকান কভার করতে কোম্পানি কোড দ্বারা যোগ করা হয়। গ্রাহকরা-কে SmartKasa রিসিপ্টটি ব্যবসা-এর চ্যাটবট-এ স্ক্যান করতে হবে, এবং স্ট্যাম্প সেই রিসিপ্ট উৎসের স্টাফ লগইন-তে যাবে।

SmartKasa ইউক্রেনীয়, এবং আর্থিক রসিদ শুধু ইউক্রেন, স্লোভাকিয়া, কাজাখস্তান এবং উজবেকিস্তানে কাজ করে।

SmartKasa এর জন্য কি আমার API চাবির প্রয়োজন?

না। SmartKasa হল রসিদ স্ক্যানিংয়ে একটি রসিদ উৎস, যা একটি দোকান ID বা কোম্পানি কোড দ্বারা যোগ করা হয়েছে।

গ্রাহকরা কোথায় একটি SmartKasa রশিদ স্ক্যান করে?

আপনার ব্যবসা-এর চ্যাটবট-এ। স্ট্যাম্প সেই রসিদ উৎসের স্টাফ লগইন-তে যায়।

কোন কোন দেশে আর্থিক রসিদ কার্যকর হয়?

ইউক্রেন, স্লোভাকিয়া, কাজাখস্তান এবং উজবেকিস্তানে।

Make এবং Zapier

ইন্টিগ্রেশনস ট্যাবে Make

Make-এর জন্য 7Stamp অ্যাপটি Make-এর পাবলিক অ্যাপ লাইব্রেরিতে আছে: যেকোনো Make সিনারিওতে 7Stamp খুঁজুন, অথবা ইন্টিগ্রেশনস ট্যাবে Make-এ ওপেন ব্যবহার করুন। আমাদের Zapier অ্যাপটি Zapier-এর পাবলিক ডিরেক্টরিতে নেই: Zapier-এ ওপেন হল একটি আমন্ত্রণ যা অ্যাপটি ব্যবসা-এর নিজস্ব Zapier অ্যাকাউন্টে যুক্ত করে। দুটি অ্যাপই স্টাফ লগইন-এর একটি API কী সহ কাজ করে।

Make পরিস্থিতি এবং Zaps 7Stamp ওয়েবহুক দ্বারা শুরু হয়, তাই ট্রিগারগুলির জন্য Webhooks & Events অ্যাড-অন প্রয়োজন। স্ট্যাম্প যোগ করা বা ভাউচার ইস্যু করা মতো অ্যাকশনগুলোর জন্য শুধুমাত্র একটি API কী প্রয়োজন। Make এবং Zapier একটি White Label ব্যবসা-এ দেওয়া হয় না।

Make এবং Zapier-এ 7Stamp অ্যাপটি কোথায় পাব?

Make-এ যেকোনো সিনারিওতে 7Stamp খুঁজুন — অ্যাপটি Make-এর পাবলিক অ্যাপ লাইব্রেরিতে আছে। Zapier-এ এটি এখনও পাবলিক নয়, তাই ইন্টিগ্রেশনস ট্যাবে Zapier-এ ওপেন ব্যবহার করুন — আমন্ত্রণটি অ্যাপটি আপনার নিজের অ্যাকাউন্টে যোগ করে।

Make এবং Zapier এর কি Webhooks & Events অ্যাড-অন প্রয়োজন?

ট্রিগার কাজ করে, কারণ সিনারিও এবং জ্যাপগুলি 7Stamp ওয়েবহুক দ্বারা শুরু হয়। স্ট্যাম্প যোগ করা বা ভাউচার ইস্যু করার মতো ক্রিয়াগুলির জন্য কেবল একটি API কী প্রয়োজন।

আমার কি Make বা Zapier এর জন্য API কী প্রয়োজন?

হ্যাঁ। এই অ্যাপগুলো স্টাফ লগইন এর API কী এর সঙ্গে কাজ করে।

Reference
Operations 28 October 2026

প্ল্যান ও বিলিং

তিনটি পরিকল্পনা, একটি Card Operation কী, কী গণনা করা হয় এবং কী ফ্রি, অ্যাড-অন্স, একটি Access Code থেকে Packages এবং পেমেন্ট ব্যর্থ হলে কী ঘটে।

আপডেট হয়েছে: 28 October 2026

প্রবন্ধ খুলুন
Reference
Operations 28 October 2026

কর্মীদের প্রবেশাধিকার

একটি স্টাফ লগইন কী, কীভাবে তৈরি করবেন, পরিবর্তন করবেন, বন্ধ করবেন এবং মুছবেন, কর্মীরা কীভাবে 7Stamp Scanner-তে সাইন ইন করে, তারা সেখানে কী করতে পারে, এবং প্রশাসক প্যানেল কে ব্যবহার করে।

আপডেট হয়েছে: 28 October 2026

প্রবন্ধ খুলুন
Reference
Operations 28 October 2026

গ্রাহক ও ইতিহাস

গ্রাহকরা' স্ট্যাম্প কার্ড তালিকা, একটি গ্রাহক এর কার্ড পৃষ্ঠা, একটি কার্ড মুছে ফেলা, ইভেন্ট লগ, 7Stamp একটি গ্রাহক সম্পর্কে কি রাখে এবং কীভাবে একটি গ্রাহক এর ডেটা মুছে ফেলা হয়।

আপডেট হয়েছে: 28 October 2026

প্রবন্ধ খুলুন