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/kunden-anlegen.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
API und Webhooks / Referenz / Kunden anlegenAls Markdown ansehen

Kunden anlegen

POST /v1/clients meldet einen Kunden im Treueprogramm an und liefert den Link zu seiner Karte, den Sie ihm per SMS oder E-Mail schicken.

POST /v1/clients

Meldet einen Kunden an, als hätte er den Aufsteller gescannt, und liefert das Kundenobjekt mit lien_carte: die Seite, auf der er seine Karte zu Apple Wallet oder Google Wallet hinzufügt. Die Willkommensstempel des Geschäfts werden vergeben, wie bei der Anmeldung.

Body (JSON)

prenom
string
optional
Vorname des Kunden, auf seiner Karte angezeigt.
nom
string
optional
Nachname.
telephone
string
optional
Eine Mobilnummer, im Format des Landes des Geschäfts oder international (+33612345678). Sonst 400 telephone_invalide.
email
string
optional
E-Mail-Adresse.
conditions_acceptees
boolean
optional
Pflicht (true), wenn das Geschäft die Zustimmung zu seinen Bedingungen verlangt (conditions_exigees aus GET /v1/commerce); sonst 422 conditions_requises.

Achtung : diese Route prüft nicht auf Dubletten: Zweimal aufgerufen, legt sie zwei Kunden an. Suchen Sie zuerst mit GET /v1/clients, oder gehen Sie direkt über POST /v1/passages mit creer_si_absent: true, das den Kunden nur anlegt, wenn es ihn noch nicht gibt.

Ein über die API angelegter Kunde wird nie für Angebots-SMS angemeldet: Er wurde darüber nicht informiert.

Beispiel

curl https://app.stampywallet.com/v1/clients \
  -H "Authorization: Bearer sw_live_votre_cle" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: inscription-0412" \
  -d '{"prenom": "Léa", "telephone": "+33612345678"}'

Antwort

201 Created und das Kundenobjekt, zum Beispiel:

201 Created
{
  "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7",
  "prenom": "Léa",
  "nom": null,
  "telephone": "+33612345678",
  "email": null,
  "carte": "X7k2pQ9mLw",
  "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw",
  "cree_le": "2026-10-25T10:41:52.120Z",
  "etat": { "mode": "tampons", "tampons": 1, "points": null, "objectif": 10, "restants": 9,
            "prochaine_recompense": { "seuil": 10, "libelle": "Ein Baguette gratis" },
            "recompenses_disponibles": [], "recompenses_obtenues": 0,
            "dernier_passage": null, "premium": null }
}

Hinweis : schicken Sie lien_carte über einen Kanal Ihrer Wahl an den Kunden: StampyWallet schreibt ihm in diesem Schritt nicht.

War diese Seite hilfreich?