API & Integrations

< id=“api-integrations”></>

14. API & Integrations

The API & Integrations section contains tools untuk programmatic integration dari 7stamp dengan Anda external systems — CRM, POS, ERP, analytics, messenger bots.

API Keys

The main halaman dari section adalah API key list. Columns:

• Name — key name (usually matches linked Staf name).
• Login — Staf login key adalah tied untuk.
• API Key — key itself (starts dengan 7loc_sc_..., hidden by default, copyable dengan satu click).
• Status — Aktif.
• 🔄 — regenerate key.
• 🗑️ — delete key.

Creating API key

Tap + ADD API KEY — Generate API Key popup membuka:

• Pemindai — dropdown untuk pick Staf Login key akan menjadi bound untuk (satu Staf dapat memiliki satu key).
• Buttons CANCEL / GENERATE.

Setelah GENERATE key adalah dibuat dan appears di list. Copy ini immediately — full key may not menjadi shown again.

Apa you dapat do via API

• Terbitkan kartu untuk pelanggan by email/phone.
• Tambah Stamp untuk specific pelanggan.
• Terbitkan voucher (templated atau custom, dengan Redeem Code).
• Redeem voucher (jika you bekerja via Anda own POS).
• Baca status dari kartu, progres, history.
• Subscribe untuk Webhooks untuk receive events di nyata time.

< id=“webhook-events”></>

Webhooks

Webhooks send kartu events untuk external system. Supported (see event glosarium):

• kartu_diterbitkan, kartu_disimpan, kartu_opened.
• Stamp_ditambahkan.
• target_reached, hadiah_diterbitkan.
• voucher_diterbitkan, voucher_ditebus, voucher_kedaluwarsa.
• lotere_played (dengan result).
• birthday_reached.
• inactivity_trigger.
• kampanye_sent.

Webhook payload example

{
 "event": "voucher_ditebus",
 "timestamp": "2026-05-11T12:34:56Z",
 "bisnis_id": "b_123",
 "lokasi_id": "loc_45",
 "pelanggan": {
 "id": "c_789",
 "wallet_pass_id": "wp_abc",
 "language": "en"
 },
 "kartu": { "id": "kartu_001", "target_index": 2 },
 "voucher": {
 "id": "v_555",
 "type": "voucher",
 "redeem_code": "FREECOFFEE",
 "redeem_code_formats": ["text", "qr", "barcode"],
 "status": "ditebus",
 "ditebus_via": "staf_pemindai"
 }
}

Ready-made POS integrations

• Poster — ready-made integration, connects di few clicks.
• Serve — ready-made integration.
• Other tills — made on request. Gratis jika technically feasible (i.e., Anda till exposes buka API atau Webhooks).

Messenger broadcasts via 7loc.com

Untuk WhatsApp, Telegram, Viber broadcasts, 7loc.com integration adalah connected. Once aktif, “messengers” channel becomes tersedia di Kampanye next untuk PUSH dan Email.

Tidak-code scenarios: Zapier dan Make

7stamp API + Webhooks bekerja dengan Zapier dan Make (Integromat), letting you bangun scenarios tanpa coding:

• “Saat voucher_ditebus — tambah tag di Mailchimp”.
• “Saat target_reached — send notification untuk Slack”.
• “Saat birthday_reached — buat task di CRM”.

---