Aller au contenu
Reponse.ai LogoDocs
DocsAPISDKsGuides

Rechercher dans la documentation

Rechercher un article...

Premiers pas

  • Overview
  • Architecture
  • Installation
  • Authentication
  • First Request

Produits & Collections

  • Products — List
  • Products — Get
  • Products — Metafields
  • Collections — List
  • Collections — Get
  • Collections — Products

Panier & Checkout

  • Cart — Create
  • Cart — Get
  • Cart — Add Item
  • Cart — Update Item
  • Cart — Remove Item
  • Cart — Apply Promotion
  • Checkout — Stripe
  • Checkout — Payment Intent
  • Checkout — ACP

Commandes & Fulfillment

  • Orders — Create
  • Orders — Get
  • Orders — Confirm
  • Orders — Cancel
  • Orders — Fulfill
  • Orders — Refund

Commerce

  • Inventory — Get
  • Inventory — Update
  • Shipping — Rates
  • Discounts — List
  • Discounts — Create
  • Discounts — Validate
  • Subscriptions — Manage

Fidélité & Cartes cadeaux

  • Loyalty — Balance
  • Loyalty — Redeem
  • Loyalty — Referral
  • Gift Cards — List
  • Gift Cards — Redeem

Tickets & Support

  • Tickets — List
  • Tickets — Create
  • Tickets — Reply

Plateforme

  • Product Feed — JSON
  • Product Feed — CSV
  • Theme — Get
  • Approvals — Execute
  • Approvals — Reject
  • Geocode

SDKs

  • SDK Overview
  • TypeScript SDK
  • React Hooks

Guides

  • Chat Widget
  • Shopify Sync
  • Storefront Starter
  • Loyalty Program
  • Discounts & Promotions
  • Subscriptions
  • Klaviyo Integration
  • Custom Domains
  • Agentic Commerce (ACP)
  • A2A Protocol
  • AI Engines
  • MCP Server

Webhooks

  • Webhooks Overview
  • Events Reference
  • Shopify Webhooks
  • Stripe Webhooks
  • Reviews (Stamped / Trustpilot)
  • Logistics
  • Email Inbound

Ressources

  • Environment Variables
  • Rate Limits
  • Changelog
DocsFidélité & Cartes cadeauxLoyalty — Balance

Loyalty — Balance

Récupère le solde de points fidélité et le palier d'un contact.

1 min de lecture/Mis à jour le 19 août 2026
Sur cette page

Vue d'ensemble

Retourne le solde de points, le total cumulé gagné et le palier actuel d'un contact. Retourne un solde à zéro si le contact n'a pas encore d'enregistrement fidélité.

Authentification

Cet endpoint requiert un token Bearer. Incluez votre clé API workspace dans le header `Authorization`.

Authorization: Bearer <votre_cle_api>

Requête

**GET** `/v1/loyalty`

Paramètres de requête

NomTypeRequisDescription
contact_idstring (uuid)✅Le contact à consulter.

Réponse

json
{
  "points_balance": 1200,
  "points_earned_total": 3400,
  "tier": { "id": "tier_uuid", "name": "Gold", "slug": "gold" }
}

Exemple SDK

typescript
const { data } = await reponse.loyalty.getBalance({ query: { contact_id: contactId } });
PrécédentSubscriptions — Manage
SuivantLoyalty — Redeem