Pilih jalur integrasi
Referensi Public API menjelaskan endpoint /api/public/v1 yang didukung. API publik berbeda dari API internal widget resmi. Administrasi membership, penemuan benefit lengkap, pengelolaan review, dan seluruh tindakan dashboard tidak otomatis tersedia melalui publik v1.
Gunakan autentikasi yang tepat
- Program dan pertukaran token: kirim publishable key melalui
X-API-Key. - Endpoint pelanggan: tambahkan JWT pelanggan sebagai bearer token. Tanda tangani identitas di server menggunakan secret key, lalu tukarkan melalui
/auth/customer-token. - Endpoint server:
/customers,/orders, dan/coupons/*memakai secret key sebagai bearer token. Endpoint ini tidak memerlukan publishable key tambahan.
Ikuti field respons yang tersedia
Gunakan saldo poin tersedia, bukan penjumlahan seluruh poin historis. Untuk menyertakan voucher terpakai dan kedaluwarsa, panggil /customer/redemptions?include_history=true. Riwayat poin publik memakai page dan limit; opsi include_balance widget internal tidak tersedia pada endpoint ini.
Katalog reward publik hanya memuat reward aktif dengan biaya poin positif. Field konfigurasi khusus merchant tidak otomatis terbuka hanya karena ada di dashboard. Gunakan spesifikasi OpenAPI untuk skema permintaan dan respons; referensi API juga mendukung akses MCP.