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.
/v1/clientsMeldet 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)
+33612345678). Sonst 400 telephone_invalide.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"}'const r = await fetch('https://app.stampywallet.com/v1/clients', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.STAMPY_CLE}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'inscription-0412',
},
body: JSON.stringify({ prenom: 'Léa', telephone: '+33612345678' }),
});
const client = await r.json();
console.log(client.lien_carte);import os, requests
r = requests.post(
"https://app.stampywallet.com/v1/clients",
headers={"Authorization": f"Bearer {os.environ['STAMPY_CLE']}",
"Idempotency-Key": "inscription-0412"},
json={"prenom": "Léa", "telephone": "+33612345678"},
)
lien = r.json()["lien_carte"]Antwort
201 Created und das Kundenobjekt, zum Beispiel:
{
"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.