Ir al contenido
StampyWalletDocs
API y webhooks / Referencia / Leer un cliente

Leer un cliente

GET /v1/clients/:id devuelve un cliente y el estado de su tarjeta de fidelidad, sellos, puntos y recompensas por entregar.

GET/v1/clients/:id

Devuelve un cliente y el estado de su tarjeta. :id es el UUID devuelto por POST /v1/clients o GET /v1/clients. Un identificador desconocido responde 404 client_introuvable.

curl
curl https://app.stampywallet.com/v1/clients/c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7 \
  -H "Authorization: Bearer sw_live_votre_cle"

El objeto cliente

El mismo objeto aparece en todas las rutas de cliente, y en el campo client de las demás respuestas:

200 OK
{
  "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7",
  "prenom": "Léa",
  "nom": "Martin",
  "telephone": "0612345678",
  "email": "lea@exemple.fr",
  "carte": "X7k2pQ9mLw",
  "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw",
  "cree_le": "2026-10-22T09:14:03.120Z",
  "etat": {
    "mode": "tampons",
    "tampons": 3,
    "points": null,
    "objectif": 10,
    "restants": 7,
    "prochaine_recompense": { "seuil": 10, "libelle": "Un café gratis" },
    "recompenses_disponibles": [
      { "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab", "libelle": "Un café gratis", "seuil": 10,
        "piste": "normal", "obtenue_le": "2026-10-20T16:03:44.000Z", "expire_le": null }
    ],
    "recompenses_obtenues": 1,
    "dernier_passage": "2026-10-22T09:20:00.000Z",
    "premium": null
  }
}
CampoSignificado
carteEl código de la tarjeta, el de su QR
lien_carteLa página de la tarjeta, que propone añadirla a Apple Wallet o Google Wallet
etat.tampons, etat.pointstampons en los modos tampons y paliers, points en modo points; el otro vale null
etat.restantsLo que falta para la próxima recompensa
etat.recompenses_disponiblesLas recompensas ganadas, aún no entregadas: su id sirve para entregarlas
etat.premium{ nom, tampons, objectif, restants } cuando el comercio ha abierto el segundo contador; si no, null

Nota : los identificadores son UUID. Se aceptan en la entrada prefijos cli_, pas_ o rec_ delante de un UUID, y se ignoran.

Actualizado el

¿Te ha sido útil esta página?