Aller au contenu
QR code to Stripe paymentsDocumentation QR2Stripe

← Tous les guides

Webhook après le paiement

Le téléphone peut appeler une adresse de votre choix après chaque paiement réussi, afin que votre propre système en soit informé. Ce n'est pas le webhook de Stripe : l'appel vient du téléphone.

Appeler après chaque paiement L'interrupteur.
Adresse L'adresse HTTPS de votre récepteur, comme dans le premier exemple. Après l'hôte, on peut utiliser des variables comme {reference}.
Méthode GET, POST ou PUT. La valeur par défaut est POST.
Format du corps JSON, FORM ou TEXT. La valeur par défaut est JSON.
En-têtes Un Name: value par ligne, par exemple pour une clé d'API ou un jeton.
Corps (modèle) Le corps avec des variables. Par défaut, c'est le JSON du deuxième exemple, avec l'ID du paiement, la référence, le montant, la devise et l'heure.
Secret de signature (facultatif) S'il est défini, chaque appel porte X-QR2Stripe-Timestamp et X-QR2Stripe-Signature (HMAC-SHA256).

Quand il est appelé : une fois après chaque paiement réussi, dans tous les modes, depuis le téléphone tant que l'application est ouverte. Si le réseau est coupé, l'application réessaie, met l'appel en file d'attente et le livre au prochain démarrage ou quand vous touchez Les livrer maintenant. Après 10 tentatives, l'appel est abandonné.

Le configurer dans l'application : Paramètres du commerçant → Webhook après le paiement → Configurer le webhook. Activez Appeler après chaque paiement, saisissez l'adresse, touchez Envoyer un appel de test puis Enregistrer. L'appel de test envoie un paiement fictif, vous voyez donc tout de suite si le récepteur l'accepte.

Le récepteur peut être votre propre serveur ou un outil sans code (n8n, Make, Zapier) avec un déclencheur de type webhook. Répondez vite par un statut 2xx ; le même paiement peut arriver deux fois, reconnaissez-le donc grâce à payment_id.

Des variables comme {reference}, {amount}, {amount_decimal}, {currency} et {payment_id} remplissent les données du paiement (la liste complète est dans la spécification). Le corps par défaut est le JSON du deuxième exemple.

Définissez un secret de signature pour que votre système puisse vérifier la signature de chaque appel, et ne publiez pas l'adresse. Sans lui, n'importe qui connaissant l'adresse pourrait vous envoyer un appel falsifié.

L'appel vient du téléphone, pas de Stripe. En mode inline, amount_from_qr vaut true, ce qui signifie qu'aucun serveur n'a vérifié le montant. Avant de remettre des biens de valeur, retrouvez le paiement dans le Dashboard Stripe.

https://example.com/hook
{
  "event": "payment.succeeded",
  "payment_id": "{payment_id}",
  "reference": "{reference}",
  "description": "{description}",
  "amount": {amount},
  "currency": "{currency}",
  "merchant": "{merchant}",
  "site": "{site}",
  "paid_at": "{paid_at}",
  "amount_from_qr": {amount_from_qr}
}