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

Buscar un cliente

GET /v1/clients encuentra a un cliente por su teléfono, su correo o el código de su tarjeta.

GET/v1/clients

Encuentra a un cliente del comercio. Indica solo uno de los tres parámetros de consulta (si no, 400 recherche_requise):

Parámetros de consulta

telephonestringopcional
El número, codificado en la dirección (%2B33612345678). Se interpreta en el país del comercio: 0612345678 y +33612345678 encuentran al mismo cliente.
emailstringopcional
Dirección de correo, sin distinguir mayúsculas.
cartestringopcional
El código de la tarjeta, el que lleva su QR.

Ejemplo

curl
curl "https://app.stampywallet.com/v1/clients?telephone=%2B33612345678" \
  -H "Authorization: Bearer sw_live_votre_cle"

Respuesta

200 OK
{
  "clients": [
    {
      "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7",
      "prenom": "Léa",
      "nom": "Martin",
      "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": 7, "points": null, "objectif": 10, "restants": 3,
                "prochaine_recompense": { "seuil": 10, "libelle": "Una baguette tradicional gratis" },
                "recompenses_disponibles": [], "recompenses_obtenues": 1,
                "dernier_passage": "2026-10-28T08:02:11.000Z", "premium": null }
    }
  ]
}

La lista está vacía ("clients": []) cuando no coincide nadie: no es un error. Cuando varias fichas tienen el mismo correo o el mismo número, se devuelve la que vino más recientemente. El detalle de los campos: el objeto cliente.

Actualizado el

¿Te ha sido útil esta página?