Integrasi pengembang
7stamp Integration API memungkinkan CRM, platform e-niaga, POS, backend khusus, atau alat otomatisasi mengelola kartu loyalitas dompet dengan pengidentifikasi kontak yang sudah ada di sistem Anda kegunaan. Ini adalah pilihan universal ketika integrasi khusus tidak ada.
Basis API URL adalah https://api.7loc.com/cards-api. Otentikasi setiap permintaan dengan kunci API sebagai token Bearer. Gunakan referensi OpenAPI tertaut untuk skema permintaan dan respons langsung sebelum membangun logika produksi.
API adalah sisi tulis dari tumpukan integrasi. Gunakan kapan pun perangkat lunak Anda harus tetap menjadi sumber kebenaran operasional sementara 7stamp menangani lapisan loyalitas dompet.
Buat tautan kartu dompet pribadi untuk setiap pelanggan di sistem Anda. Kirimkan melalui email Anda sendiri, SMS, push, atau aliran dalam aplikasi. Pelanggan membuka tautan dan menyimpan kartu ke Apple Wallet atau Google Wallet.
Saat pembelian ditutup sesuai kebiasaan Anda POS, saat pesanan online dibayar di situs web Anda, atau saat layanan diselesaikan di sistem pemesanan Anda, hubungi API untuk memberi stempel kredit. Kartu diperbarui dalam hitungan detik.
Terbitkan voucher satu kali kepada pelanggan tertentu, buat aliran hadiah siap kampanye, dan tarik status voucher kembali ke sistem yang menangani keuangan dan kualitas layanan.
Ini adalah rute publik API di belakang Make dan tindakan Zapier. Baca skema persisnya di referensi API; jangan menyimpulkan nama bidang dari titik akhir yang berbeda.
POST /cards/invite Membuat instalasi pribadi baru URL untuk kontak eksternal.
POST /cards/invite/bulk Membuat hingga 100 tautan undangan dalam batch terkontrol.
GET /cards Mencari catatan kartu berdasarkan pengenal kontak eksternal.
GET /cards/{user_card_id} Mengembalikan status lengkap satu kartu berdasarkan internalnya 7stamp ID.
POST /cards/scan Menambahkan prangko berdasarkan kartu ID atau External ID dan mencatat urutan sumber saat disediakan.
GET /templates Daftar templat kartu yang tersedia untuk tempat kerja kunci/profile.
GET /templates/{template_id}/design Membaca pengaturan visual untuk templat kartu yang dikenal.
POST /vouchers/issue Menerbitkan voucher kepada pemilik kartu.
POST /messages/send Mengirim push kartu dompet dan/or konten email ke pemilik kartu.
Ini adalah layar 7stamp Admin nyata. Buka API & Integrasi, tambahkan kunci, lalu salin ke koneksi rahasia atau otomatisasi sisi server yang aman.
Buat kunci di 7stamp Admin di bawah API Integrations → API Keys → Add API Key. Sebuah kunci dimiliki oleh satu tempat kerja/profile, jadi buatlah kunci terpisah untuk pengembangan dan produksi ketika pengaturan akun Anda mengizinkannya. Memutar atau mencabut akses dari dasbor jika ada rahasia yang terungkap.
External ID adalah pengidentifikasi kontak stabil dari sistem Anda: CRM ID, pelanggan UUID, nomor telepon, atau email. Lebih suka sistem yang tidak dapat diubah ID. Secara opsional, tambahkan External Source untuk menghindari tabrakan antar sistem dan membuat korelasi webhook menjadi eksplisit.
Ketika profil memiliki satu templat yang aktif, template_id dapat dihilangkan dan 7stamp memilihnya secara otomatis. Jika memiliki beberapa templat aktif, teruskan template_id yang diinginkan. Bacalah GET /templates terlebih dahulu daripada membuat kode keras untuk menebak ID.
bash curl -X POST "https://api.7loc.com/cards-api/cards/invite" \
-H "Authorization: Bearer YOUR_7STAMP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}'Masuk ke 7stamp Admin dan buat kunci: API Integrations → API Keys → Add API Key. Simpan di manajer rahasia Anda, bukan kode sumber atau aplikasi sisi klien.
Tetapkan basis URL menjadi https://api.7loc.com/cards-api dan tambahkan Authorization: Bearer diikuti dengan kunci untuk setiap permintaan sisi server.
Hubungi GET /templates terlebih dahulu. Respons yang berhasil akan mengonfirmasi token dan menampilkan templat yang tersedia untuk tempat kerja tersebut/profile.
Pilih yang stabil External ID dan opsional External Source dari sistem Anda sendiri. Gunakan pasangan identitas yang sama persis dalam logika pembuatan, pemindaian, pencarian, dan webhook.
Hubungi POST /cards/invite dengan kontak uji sekali pakai. Verifikasi instalasi yang dikembalikan URL sebelum mengotomatiskan pengiriman ke pelanggan sebenarnya.
Tambahkan POST /cards/scan, voucher, atau tindakan pesan hanya setelah Anda melakukan logging, penanganan kesalahan, dan strategi coba ulang yang aman/idempotency di backend Anda sendiri.
Referensi publik Swagger/OpenAPI berisi titik akhir, parameter, isi permintaan, respons, dan skema webhook saat ini. Interaktif URL adalah https://api.7loc.com/cards-api/docs dan kontrak yang dapat dibaca mesin adalah https://api.7loc.com/cards-api/openapi.json. Bacalah sebelum menerapkan penanganan kesalahan atau menambahkan kolom opsional.
Kuncinya adalah rahasia sisi server. Jangan memaparkannya di JavaScript browser, bundel aplikasi seluler, formulir publik, tangkapan layar, kolom teks Make/Zapier, atau tiket dukungan. Gunakan server, koneksi otomatisasi yang aman, atau manajer rahasia. Jika kunci dibagikan secara tidak sengaja, cabut atau putar kunci tersebut di 7stamp Admin dan perbarui koneksi yang terpengaruh.
Di 7stamp Admin, buka API Integrations → API Keys → Add API Key. Token kemudian dikirim dalam header Authorization sebagai Bearer diikuti dengan kunci.
Gunakan https://api.7loc.com/cards-api dan kirim Authorization: Bearer YOUR_7STAMP_API_KEY pada setiap permintaan resmi.
Hanya jika profil yang terhubung memiliki tepat satu templat kartu yang aktif. Jika beberapa templat aktif, pilih template_id yang benar dari GET /templates.
Gunakan API untuk POS khusus, backend, situs, atau kontrol penuh. Gunakan Make untuk skenario percabangan visual. Gunakan Zapier untuk alur kerja aksi pemicu yang sebagian besar linier. Ketiganya mengandalkan kunci API dan kontrak API yang sama.
Halaman terkait
Langkah selanjutnya
Buat kuncinya, panggil GET /templates, buat satu undangan untuk kontak sekali pakai, lalu tambahkan rahasia produksi, logging, percobaan ulang, dan penanganan webhook di sekitar permintaan yang terbukti.