ÜbersichtOverview
SANDBOXAPI-Calls (Sandbox)API Calls
(Sandbox)
0
Nur im Sandbox-ModusSandbox mode only
Sandbox-CheckoutsSandbox
Checkouts
0
Simulierte DatenSimulated data
Aktive AngeboteActive
Offers
0
Keine Sandbox-OffersNo Sandbox Offers
Webhook-DeliveriesWebhook
Deliveries
0
Konfiguriere WebhooksConfigure webhooks
Du bist im Sandbox-Modus.You are in sandbox
mode. Alle APIs können risikofrei getestet werden, keine echten
Daten, keine echten Zahlungen. Für Live-Zugang:All APIs can be tested
risk-free, no real data, no real payments. For live access:
Paket & Live →Package
& Live →
API-KeysAPI Keys
Secret Keys (sk) niemals öffentlich teilen!Never share Secret Keys (sk) publicly! Verwende
Secret Keys nur serverseitig. Publishable Keys (pk) können im Frontend verwendet werden.Use Secret Keys only server-side. Publishable Keys (pk) can be used in the
frontend.
Test-Modus KeysTest Mode Keys Sandbox
Funktionieren nur mit Sandbox-Daten. Keine echten Transaktionen möglich.Work only with sandbox data. No real transactions possible.
Publishable Key (pk)
Laden...
Secret Key (sk)
Laden...
⚠️ Einmalige Anzeige!⚠️ One-time display!
Speichere deinen Secret Key jetzt. Nach Neuladen wird nur Präfix + Metadaten angezeigt.
Save your Secret Key now. After reload only prefix + metadata are shown.
Keys rotieren, falls kompromittiert. Dein aktueller Test-Key wird sofort ungültig und ein neuer wird erstellt.
Rotate if compromised. Your current test key is immediately revoked and replaced with a new one.
Aktive Test-Secret-KeysActive test secret keys
Live-Modus KeysLive Mode Keys Live
Live-Keys nicht verfügbarLive Keys Not Available
Für den Zugriff auf die Live-Umgebung benötigst du ein aktives
BEEP!-Paket (DISCOVER, ASSIST, GO, GROW oder PRIME) und einen verifizierten
Store.To access the live environment you need an active BEEP!
package (DISCOVER, ASSIST, GO, GROW or PRIME) and a verified store.
Du hast bereits ein Paket? Already have a package?
Support
kontaktierenContact Support um deinen
Developer-Account zu verknüpfen. to link your developer account.
Dein Account ist aktiviert. Generiere jetzt deine Live-Keys, um echte Daten zu verarbeiten.
Your account is activated. Generate your live keys now to process real data.
Publishable Key (pk): Live
–
Secret Key (sk): Live
–
⚠️ Einmalige Anzeige!⚠️ One-time display!
Speichere deinen Live Secret Key jetzt sicher. Nach Neuladen wird nur das Präfix angezeigt.
Save your Live Secret Key securely now. After reload only the prefix is shown.
Keys rotieren, falls kompromittiert. Deine aktuellen Live-Keys werden sofort ungültig. Alle Integrationen müssen danach aktualisiert werden.
Rotate if compromised. Your current live keys are immediately revoked. All integrations must be updated afterwards.
Aktive Live-Secret-KeysActive live secret keys
WebhooksWebhooks
Webhook Signing SecretWebhook Signing Secret
Verifiziere
eingehende Webhooks mit HMAC-SHA256. Nur serverseitig verwenden.Verify
incoming webhooks with HMAC-SHA256. Use server-side only.
Laden...
Neuer Webhook-EndpointNew Webhook Endpoint
Event-LogEvent Log
Sandbox-Events (simuliert)Sandbox events (simulated)Sandbox-Events werden simuliert. Echte Event-Logs sind nur
im Live-Modus mit aktivem Paket verfügbar.Sandbox events are simulated. Real
event logs are only available in live mode with an active package.
| Event | Store | Status | ZeitTime |
|---|---|---|---|
|
Keine EventsNo
events yet
Sandbox-Events erscheinen hier, sobald du
API-Calls im Sandbox-Modus machst.Sandbox events will appear here
once you make API calls in sandbox mode.
|
|||
Paket & Live-ZugangPackage & Live Access
So wirst du LiveHow to go live
Die Sandbox ist komplett kostenlos und uneingeschränkt. Für echte API-Calls gegen deine Live-Stores benötigst du:The sandbox is completely free and unlimited. For real API calls against your live stores you need:
1
BEEP! Paket wählenChoose a
BEEP! package
Wähle
DISCOVER (kostenlos), ASSIST, GO, GROW oder PRIME. Jedes Paket schaltet unterschiedliche API-Endpoints
frei.Choose DISCOVER (free), ASSIST, GO, GROW or PRIME. Each package
unlocks different API endpoints.
Pakete & Preise →Packages & Pricing →
2
Store verifizierenVerify
your store
Unser Team
verifiziert deinen Standort und richtet die PSP-Konfiguration (für Scan & Go Payments über dein
eigenes Zahlungssystem) ein.Our team verifies your location and sets up
the PSP configuration (for Scan & Go payments via your own payment system).
Vertrieb kontaktieren →Contact Sales →
3
Live-Keys erhaltenReceive
live keys
Nach
Aktivierung erscheinen deineAfter activation your
bk_live_* Keys hier im
Dashboard. Ersetzekeys appear here in the dashboard. Replace bk_test_* im Code,
fertig.in your code, done.API-Zugang pro PaketAPI access per package
| API / Feature | DISCOVER | ASSIST | GO | GROW | PRIME |
|---|---|---|---|---|---|
| fetchStores / fetchProducts | ✓ | ✓ | ✓ | ✓ | ✓ |
| insertProduct / bulkImportProducts | ✓ | ✓ | ✓ | ✓ | ✓ |
| In-Store-Chat (QR-Code) | – | ✓ | ✓ | ✓ | ✓ |
| Offers API (CRUD) | – | – | ✓ | ✓ | ✓ |
| Click & Collect | – | – | ✓ | ✓ | ✓ |
| checkIn / Scan & Go | – | – | – | ✓ | ✓ |
| startCheckout | – | – | – | ✓ | ✓ |
| fetchPurchase / History | – | – | – | ✓ | ✓ |
| POS/ERP/PSP-Sync (generisch) | – | – | – | ✓ | ✓ |
| exportSalesData / Kassenbon & TSE | – | – | – | ✓ | ✓ |
| Priority SLA / 24/7 Support | – | – | – | – | ✓ |
Sandbox = immer unbegrenzt.Sandbox = always
unlimited. In der Sandbox-Umgebung sind alle Endpoints
freigeschaltet, unabhängig vom Paket. So kannst du alles testen, bevor du dich entscheidest.In the sandbox environment all endpoints are unlocked, regardless of package.
This lets you test everything before deciding.
Händler-App Feature TestingApp Feature Testing
Zwei Felder, zwei Systeme:Two fields, two
systems:
Diese Seite zeigt dir, wie du beides getrennt steuerst, so testen, ohne in Produktion sichtbar zu sein.
This page shows you how to control both separately, so you can test without being visible in production.
subscriptionPackage steuert, welche Features der Händler in der
Händler-App sieht (locked vs. freigeschaltet).hasScanAndGo steuert, ob der Store in der Nutzer-App
sichtbar ist.Diese Seite zeigt dir, wie du beides getrennt steuerst, so testen, ohne in Produktion sichtbar zu sein.
subscriptionPackage controls which features the merchant sees in the
Merchant App (locked vs. unlocked).hasScanAndGo controls whether the store is visible in the
User App.This page shows you how to control both separately, so you can test without being visible in production.
Das Muster für sicheres Developer-TestingThe pattern for safe developer testing
HäNDLER-APP
subscriptionPackage: "PRIME"
→ Alle Features
freigeschaltet: Scan & Go, Offers, Analytics, Click & Collect→ All features unlocked: Scan & Go, Offers, Analytics, Click &
Collect
NUTZER-APP
hasScanAndGo: false
→ Store bleibt
für Endkunden unsichtbar, kein Scan & Go Button, kein Store-Listing→ Store stays invisible for end customers, no Scan & Go button, no store
listing
Firestore: stores/{testStoreId}
{
// Steuert Händler-App Feature Gates
"subscriptionPackage": "PRIME", // DISCOVER | ASSIST | GO | GROW | PRIME
// Steuert Sichtbarkeit in der Nutzer-App
"hasScanAndGo": false, // false = Consumer sieht NICHTS
// Weitere Legacy-Felder (rückwärtskompatibel, separat)
"hasOffers": false
}
Store Assist, Zone-FAQs und Customer-Chat laufen über Firebase SDK, kein
Wie Chat und FAQs in DISCOVER nutzen diese ASSIST-Features Firestore Echtzeit-Listener direkt im Client (
bk_*-Key benötigt.Store Assist, Zone FAQs and Customer
Chat run via Firebase SDK, no bk_* key required.Wie Chat und FAQs in DISCOVER nutzen diese ASSIST-Features Firestore Echtzeit-Listener direkt im Client (
store_assist_sessions,
zone_faqs, direct_messages). Test-Keys brauchen den Endpoint
checkIn (GROW) für den Scan & Go Kontext.Like Chat
and FAQs in DISCOVER, these ASSIST features use Firestore real-time listeners directly in the client
(store_assist_sessions, zone_faqs, direct_messages). Test keys
require the checkIn endpoint (GROW) for the Scan & Go context.
Was jedes Paket in der Händler-App freischaltetWhat each package unlocks in the Merchant App
| Feature (Händler-App)Feature (Merchant App) | DISCOVER | ASSIST | GO | GROW | PRIME |
|---|---|---|---|---|---|
| Angebote & MarketingOffers & Marketing | |||||
| Katalog-Sichtbarkeit in AppCatalog visibility in app | ✓ | ✓ | ✓ | ✓ | ✓ |
| Store-Profil & Mitarbeiter-VerwaltungStore profile & staff management | ✓ | ✓ | ✓ | ✓ | ✓ |
| In-App Listing & PromotionsIn-app listing & promotions | – | – | ✓ | ✓ | ✓ |
| Angebote erstellen & PDF-ViewerCreate offers & PDF viewer | – | – | ✓ | ✓ | ✓ |
| Produktlisten & ReaktionenProduct lists & reactions | – | – | ✓ | ✓ | ✓ |
| Shopping List IntegrationShopping list integration | – | – | ✓ | ✓ | ✓ |
| Preisalarm-BenachrichtigungenPrice alert notifications | – | – | ✓ | ✓ | ✓ |
| Click & Collect | – | – | ✓ | ✓ | ✓ |
| Store Assist | |||||
| QR-Code GeneratorQR code generator | – | ✓ | – | ✓ | ✓ |
| Im-Store Chat nach QR-Scan (Firestore)In-store chat after QR scan (Firestore) | – | ✓ | – | ✓ | ✓ |
| Zonen-Kontext & Zone-FAQs (Firestore)Zone context & zone FAQs (Firestore) | – | ✓ | – | ✓ | ✓ |
| Scan & Go | |||||
| Scan & Go (Checkout-Flow)Scan & Go (checkout flow) | – | – | – | ✓ | ✓ |
| Checkout-VerifizierungCheckout verification | – | – | – | ✓ | ✓ |
| EmpfehlungenRecommendations | – | – | – | ✓ | ✓ |
| POS-Integration & TransaktionsrückschreibungPOS integration & transaction write-back | – | – | – | ✓ | ✓ |
| Digitale Belege (TSE-konform)Digital receipts (TSE-compliant) | – | – | – | ✓ | ✓ |
| Multi-Store ManagementMulti-store management | – | – | – | ✓ | ✓ |
| Analytics & ReportingAnalytics & Reporting | |||||
| Basic Report (Angebots-Analytics)Basic report (offer analytics) | – | – | ✓ | ✓ | ✓ |
| Basis Verkaufsanalyse (Scan & Go)Basic sales analytics (Scan & Go) | – | – | – | ✓ | ✓ |
| Premium Analyse Tools & HeatmapsPremium analytics tools & heatmaps | – | – | – | – | ✓ |
| Erweitertes Reporting & ExporteExtended reporting & exports | – | – | – | – | ✓ |
| Direktkommunikation (alle via Firestore SDK)Direct communication (all via Firestore SDK) | |||||
| Chat-Inbox & Team-Chat (intern)Chat inbox & team chat (internal) | ✓ | ✓ | ✓ | ✓ | ✓ |
| Globale Chat-FAQsGlobal chat FAQs | ✓ | ✓ | ✓ | ✓ | ✓ |
| Assist-FAQs pro Zone (nach QR-Scan)Assist FAQs per zone (after QR scan) | – | ✓ | – | ✓ | ✓ |
| Angebots-FAQs pro KatalogOffer FAQs per catalog | – | – | ✓ | ✓ | ✓ |
| Kanäle im Angebote-Bereich sichtbarChannels visible in offers section | – | – | ✓ | ✓ | ✓ |
| Chat-Button beim Scan & Go aktivChat button active during Scan & Go | – | – | – | ✓ | ✓ |
| Loyalty & TreueprogrammeLoyalty & Reward Programs | |||||
| Stamps/Points Programm (1 Programm)Stamps/Points program (1 program) | – | – | ✓ | ✓ | ✓ |
| Earning: QR-Code, GPS Check-in, Click & CollectEarning: QR code, GPS check-in, Click & Collect | – | – | ✓ | ✓ | ✓ |
| Direkte Einlösung (Kunde löst selbst ein)Direct redemption (customer self-redeems) | – | – | ✓ | ✓ | ✓ |
| Loyalty Cashback & Custom RewardsLoyalty cashback & custom rewards | – | – | – | ✓ | ✓ |
| Earning via Scan & Go CheckoutEarning via Scan & Go checkout | – | – | – | ✓ | ✓ |
| Loyalty Tier-System (Bronze/Silber/Gold)Loyalty tier system (Bronze/Silver/Gold) | – | – | – | – | ✓ |
| Multi-Store-TreueprogrammeMulti-store loyalty programs | – | – | – | – | ✓ |
| Externe Loyalty-Anbindung (Sync API)External loyalty integration (Sync API) | – | – | – | – | ✓ |
| Support & ServiceSupport & Service | |||||
| Standard Support (E-Mail)Standard support (email) | – | ✓ | ✓ | ✓ | ✓ |
| Persönlicher Ansprechpartner & Premium SupportDedicated contact & premium support | – | – | – | – | ✓ |
| Vertrags- und IntegrationsserviceContract and integration service | – | – | – | – | ✓ |
Package per Cloud Function setzenSet package via Cloud Function
Anstatt Firestore direkt zu ändern kannst du auch die dedizierte CF aufrufen.
Diese schreibt ausschließlich subscriptionPackage. hasScanAndGo wird nie verändert.
Instead of editing Firestore directly you can call the dedicated CF. It only writes
subscriptionPackage. hasScanAndGo is
never modified.
JavaScript (Firebase SDK)
import { getFunctions, httpsCallable } from 'firebase/functions';
// Package on test store setzen (Sichtbarkeit in der Nutzer-App bleibt
unberührt)
const functions = getFunctions(app, 'europe-west1');
const enableTestMode = httpsCallable(functions, 'enableDeveloperTestMode');
const result = await enableTestMode({
storeId: 'sandbox_store_001',
package: 'GROW', //
DISCOVER | ASSIST | GO | GROW | PRIME
});
// { success: true, storeId: '...', subscriptionPackage: 'GROW', message: '...'
}
console.log(result.data);
// Zurück auf DISCOVER (sicherer Ausgangsstand)
const resetTestMode = httpsCallable(functions, 'resetDeveloperTestMode');
await resetTestMode({ storeId: 'sandbox_store_001' });
⚠️
Hinweis:Note: Pakete können auch intern durch einen BEEP!-Administrator geändert werden. Dabei
werden API-Berechtigungen und Händler-App-Features automatisch synchronisiert.Packages can also be changed internally by a BEEP! administrator. API permissions and
merchant app features are automatically synchronized.
Go LiveGo Live
Verbinde dich mit einer Organisation, um Live-APIs nutzen zu können. Connect to an organization to use live APIs.
Organisation erstellenCreate Organization
Du bist der Inhaber? Erstelle eine Organisation und werde Admin. You're the owner? Create an org and become the admin.
Einladung erhaltenGot an invite?
Dein Admin hat dich hinzugefügt? Dein Zugang wird automatisch erkannt. Your admin invited you? Access is detected automatically.
Neue OrganisationNew Organization
Sandbox = kostenlosSandbox = free: Teste alle APIs jetzt im Sandbox. Für Live-Zugang brauchst du eine Organisation mit einem BEEP!-Paket. Test all APIs now in Sandbox mode. For live access you need an organization with a BEEP! package.
OrganisationOrganization
Company
—
Package
—
Status
—
Deine RolleYour Role
—
Stores
0
Members
0
Mitglied seitMember since
—
TeamTeam
Neues Mitglied einladenInvite New Member
Lade Mitglieder…Loading members…