1. Récupère ta clé API

Ta clé est fournie par MySargal (elle est liée à ta boutique). Demande-la sur WhatsApp ou par mail à support@mysargal.com. Elle ressemble à :

msk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Ton URL webhook personnelle est :

https://iiocxlvcuoqafzlisqwd.supabase.co/functions/v1/api-order?key=TA_CLE

Shopify

1. Admin Shopify → Paramètres → Notifications → onglet Webhooks
2. Créer un webhook : Événement = Paiement de commande (Order payment), Format = JSON
3. URL = ton URL webhook ci-dessus → Enregistrer

C'est tout. À chaque commande payée : si le client a un numéro de téléphone, sa carte est trouvée (ou créée + envoyée par WhatsApp) et ses points sont crédités selon ta règle « 1 point = X FCFA ».

WooCommerce (WordPress)

1. Admin WordPress → WooCommerce → Réglages → Avancé → Webhooks
2. Ajouter un webhook : Sujet = Commande mise à jour (ou « Commande créée »), Statut = Actif
3. URL de livraison = ton URL webhook → Enregistrer

Les commandes en statut pending / cancelled / refunded / failed sont ignorées automatiquement — pas de points sur les commandes annulées.

Site custom (n'importe quel langage)

Appelle l'endpoint après chaque paiement confirmé :

curl -X POST \
  "https://iiocxlvcuoqafzlisqwd.supabase.co/functions/v1/api-order" \
  -H "x-api-key: TA_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+221771234567",
    "name": "Awa Ndiaye",
    "amount": 15000,
    "order_id": "CMD-2024-001"
  }'

Réponse :

{
  "success": true,
  "card_code": "LC-A1B2C3",
  "card_url": "https://mysargal.com/c/?code=LC-A1B2C3",
  "new_client": true,
  "points_added": 15,
  "total_points": 15
}

Champs

• phone (requis) — numéro du client, avec indicatif
• amount — montant FCFA (points calculés selon la règle de ta boutique). Sans montant : 1 commande = 1 point
• points — pour forcer un nombre de points précis (ignore le calcul)
• order_id — fortement conseillé : empêche tout double crédit si le webhook est rejoué

Les autres endpoints

Même authentification (x-api-key) :

Consulter un solde

POST /functions/v1/api-balance   { "card_code": "LC-A1B2C3" }

Créditer des points (scan caisse / POS)

POST /functions/v1/api-scan      { "card_code": "LC-A1B2C3", "points": 5 }

Utiliser une récompense (déduction en caisse)

POST /functions/v1/api-redeem    { "card_code": "LC-A1B2C3" }
→ { "success": true, "reward": "Café offert", "points_used": 50, "points_remaining": 10 }
→ 402 si pas assez de points (avec points_disponibles / points_requis)

Flux POS complet : api-balance renvoie reward_ready: true et la liste rewards_available dès que le client a atteint sa récompense → l'écran de caisse l'affiche → api-redeem déduit les points au moment de l'achat. La carte Wallet du client se met à jour aussitôt.

Bon à savoir

• Tout passe en HTTPS ; les clés sont révocables à tout moment
• Les jours « points x2 » de la boutique s'appliquent aussi aux commandes en ligne
• Un nouveau client reçoit sa carte par WhatsApp automatiquement
• La carte Apple/Google Wallet du client se met à jour en quelques secondes

Besoin d'aide pour l'intégration ?

On la fait avec toi, gratuitement.