Paiements et Stripe

Relier une session CheckoutCopier le lien de cette section

Récupérez l'identifiant visiteur après consentement et transmettez-le à votre backend. Ajoutez les metadata à la session Stripe Checkout créée côté serveur :

metadata: {
  lunetric_visitor_id: visitorId,
  lunetric_user_id: userId
}

N'envoyez pas de valeur null dans les metadata. Si l'identifiant manque, continuez le paiement normalement : il restera non attribué. Validez les champs client ; ces identifiants ne remplacent pas l'authentification de votre application.

Webhook signéCopier le lien de cette section

Dans Stripe, créez un endpoint avec l'URL affichée dans Configuration → Intégrations, sous la forme :

https://analytics.votre-domaine.com/webhooks/stripe/VOTRE_SITE_ID

Sélectionnez checkout.session.completed et checkout.session.async_payment_succeeded. Enregistrez le secret de signature whsec_… dans Lunetric. Gardez des endpoints et secrets distincts pour la sandbox et la production.

Le serveur vérifie la signature et traite uniquement les paiements confirmés. Un clic, une page de succès ou une session non payée ne crée pas de revenu. Les répétitions de webhooks sont dédupliquées.

Autre prestataireCopier le lien de cette section

Depuis votre backend après confirmation :

POST /v1/payments
Authorization: Bearer VOTRE_CLE_ECRITURE
Content-Type: application/json

{"transaction_id":"order_001","amount_minor":4900,"currency":"EUR","visitor_id":"ID_VISITEUR"}

La référence doit être unique pour ce paiement. Le montant est en unités mineures. La devise ne mélange pas automatiquement les taux de change.

Limites actuellesCopier le lien de cette section

La connexion Stripe utilise des webhooks Checkout, sans OAuth Stripe. Les renouvellements d'abonnements, remboursements Stripe et imports historiques ne sont pas automatiques. L'API /v1/refunds permet un remboursement explicite pour un paiement connu.