API & Integrations

14. API & Integrations

Naglalaman ang seksyong API & Integrations ng mga tool para sa programmatic integration ng 7stamp sa iyong external systems — CRM, POS, ERP, analytics, messenger bots.

API Keys

Ang pangunahing page ng seksyong ito ay ang listahan ng API keys. Mga column:

• Name — pangalan ng key (karaniwang tumutugma sa naka-link na Staff name).
• Login — ang Staff login na nakakabit sa key.
• API Key — ang key mismo (nagsisimula sa 7loc_sc_..., nakatago by default, puwedeng i-copy sa isang click).
• Status — Active.
• 🔄 — i-regenerate ang key.
• 🗑️ — burahin ang key.

Paglikha ng API key

Pindutin ang + ADD API KEY — bubukas ang popup na Generate API Key:

• Scanner — dropdown para piliin ang Staff Login na pagtatalian ng key (ang isang Staff ay puwedeng magkaroon ng isang key).
• Mga button na CANCEL / GENERATE.

Pagkatapos ng GENERATE, malilikha ang key at lilitaw ito sa listahan. Kopyahin ito kaagad dahil baka hindi na ipakita muli ang buong key.

Ano ang magagawa mo sa API

• Mag-isyu ng card sa customer sa pamamagitan ng email/phone.
• Magdagdag ng Stamp sa partikular na customer.
• Mag-isyu ng voucher (templated o custom, may Redeem Code).
• Mag-redeem ng voucher (kung gumagana ka sa sarili mong POS).
• Basahin ang state ng card, progress, at history.
• Mag-subscribe sa Webhooks para makatanggap ng events in real time.

Webhooks

Nagpapadala ang Webhooks ng card events sa external system. Supported ang mga ito (tingnan ang event glossary):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (kasama ang result).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Webhook payload example

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Ready-made POS integrations

• Poster — ready-made integration, nakakabit sa ilang click lang.
• Serve — ready-made integration.
• Other tills — ginagawa kapag hiniling. Libre kung technically feasible (ibig sabihin, may open API o Webhooks ang iyong till).

Messenger broadcasts via 7loc.com

Para sa WhatsApp, Telegram, at Viber broadcasts, ginagamit ang integration na 7loc.com. Kapag active na ito, magiging available ang channel na “messengers” sa Campaigns katabi ng PUSH at Email.

No-code scenarios: Zapier and Make

Gumagana ang 7stamp API + Webhooks kasama ang Zapier at Make (Integromat), kaya puwede kang bumuo ng scenarios nang walang coding:

• “Kapag voucher_redeemed — magdagdag ng tag sa Mailchimp”.
• “Kapag goal_reached — magpadala ng notification sa Slack”.
• “Kapag birthday_reached — gumawa ng task sa CRM”.

---