Zum Inhalt springen

Für KI-Agenten: Das Verzeichnis der Dokumentation steht unter https://stampywallet.com/de/docs/llms.txt, die gesamte Dokumentation in einer Datei unter https://stampywallet.com/de/docs/llms-full.txt, und diese Seite gibt es als Markdown: https://stampywallet.com/de/docs/api/geschaeft.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
API und Webhooks / Referenz / Geschäft abrufenAls Markdown ansehen

Geschäft abrufen

GET /v1/commerce liefert die Daten des Geschäfts, zu dem der Schlüssel gehört, und die Regeln seiner Stempelkarte.

GET /v1/commerce

Liefert das Geschäft, zu dem der Schlüssel gehört: Name, Währung, Zeitzone und die Regeln der Karte (Modus, Ziel, Prämien, Betragsregel). Praktisch, um einen Schlüssel zu prüfen oder die Regel der Karte in Ihrer Kasse anzuzeigen.

Beispiel

curl https://app.stampywallet.com/v1/commerce \
  -H "Authorization: Bearer sw_live_votre_cle"

Antwort

200 OK
{
  "id": "5f0c8e2a-3b1d-4c9e-9a51-2d7f3e8b6a10",
  "nom": "Boulangerie Lemaire",
  "mode": "tampons",
  "tampons_requis": 10,
  "recompense": "Ein Baguette gratis",
  "recompenses": [ { "seuil": 10, "libelle": "Ein Baguette gratis" } ],
  "devise": "EUR",
  "montant_par_tampon": 10,
  "points_par_unite": null,
  "tampons_bienvenue": 1,
  "conditions_exigees": false,
  "premium": null,
  "fuseau": "Europe/Paris",
  "langue": "fr"
}
FeldBedeutung
modetampons, paliers oder points (die Kartentypen)
recompensesJede Prämie mit ihrer Schwelle seuil
montant_par_tamponDie Regel „10 € = 1 Stempel“, oder null
points_par_uniteIm Punktemodus: wie viele Punkte es für 1 Währungseinheit gibt
conditions_exigeestrue, wenn das Geschäft die Zustimmung zu seinen Bedingungen verlangt: Übergeben Sie dann conditions_acceptees: true, wenn Sie einen Kunden anlegen
premiumDer zweite Zähler, wenn das Geschäft ihn aktiviert hat, sonst null
War diese Seite hilfreich?