Paiements Stripe automatiques

Le mode Stripe automatique est recommandé lorsque Stripe est la source de paiement d’un produit. Les liens affiliés ouvrent un Payment Link hébergé par Stripe, et AffiHQ reçoit automatiquement les informations sur les paiements, abonnements, remboursements et litiges.

Ce mode ne nécessite ni clé API produit AffiHQ, ni clé d’empreinte, ni SDK Stripe. Vous n’avez pas non plus à transmettre les webhooks Stripe depuis votre application. AffiHQ vérifie la livraison Stripe et rattache le résultat au produit, au compte, au Payment Link et au clic affilié correspondants.

Avant de configurer le produit

Le mode Stripe automatique utilise un compte Standard éligible, connecté à AffiHQ par OAuth. Ce compte doit posséder le Payment Link choisi.

Un déploiement AffiHQ utilise un seul mode Stripe à la fois :

un déploiement de développement ou de test utilise les données Stripe test ;
un déploiement de production utilise les données Stripe live.

Ne connectez pas un compte live et ne choisissez pas de Payment Link live dans un déploiement de test. N’utilisez pas non plus de données test en production. Un Payment Link de l’autre mode ne peut pas être sélectionné.

Conditions du Payment Link

Le sélecteur accepte uniquement une URL hébergée par Stripe sur buy.stripe.com, active, et réunissant toutes les propriétés suivantes :

exactement une ligne de produit ;
un prix fixe et une quantité 1 ;
un montant positif ;
une seule devise, identique à celle du prix ;
un paiement ponctuel ou un abonnement ;
pour un abonnement, une périodicité mensuelle ou annuelle uniquement.

Les liens inactifs, mal formés, à plusieurs lignes, à quantité variable ou autrement incompatibles restent indisponibles dans le sélecteur. Chaque produit AffiHQ possède un Payment Link sélectionné. AffiHQ conserve le montant, la devise et la périodicité du lien sélectionné comme instantané de validation du produit : le Checkout ou la facture doit continuer à correspondre à cet instantané.

Configurer Stripe automatique

Ouvrez Produits et modifiez le produit.
Dans Paiements Stripe, sélectionnez Stripe automatique.
Sélectionnez Connecter Stripe, puis autorisez le compte Standard qui possède le Payment Link.
Vérifiez que le compte est dans le mode attendu : Mode test ou Mode live.
Choisissez un Payment Link disponible. La liste affiche son montant et sa périodicité ; les liens inactifs ou incompatibles ne peuvent pas être sélectionnés.
Sélectionnez Utiliser ce Payment Link. AffiHQ enregistre immédiatement ce choix.

Le produit doit afficher le compte connecté et Prêt à côté du lien sélectionné. La devise du produit et celle du Payment Link doivent correspondre.

Ce que fait un clic affilié

Un lien affilié sous /r/ enregistre d’abord le clic. En mode Stripe automatique, il ouvre ensuite le Payment Link sélectionné et ajoute à l’URL un client_reference_id opaque tel que clk_….

AffiHQ conserve les autres paramètres de requête du Payment Link. Si l’URL contient déjà client_reference_id, la référence du clic AffiHQ remplace cette valeur afin que le Checkout puisse être rattaché au clic enregistré.

Si la configuration native est invalide ou indisponible au moment de la redirection, le lien revient de manière sûre à la destination historique du produit et y ajoute affihq_ref. Cette destination de secours ne constitue pas un paiement Stripe automatique : votre serveur doit capturer la référence, créer l’attribution et transmettre les faits de paiement avec le parcours API/SDK avancé.

Comment les paiements deviennent des commissions

Payment Link ponctuel

Un Checkout payé qui se termine immédiatement crée le paiement utilisé pour la commission. Certains moyens de paiement se terminent de manière asynchrone :

le Checkout peut enregistrer le clic et l’attribution avant la confirmation définitive du paiement ;
une réussite de paiement asynchrone crée le paiement et la commission ;
un échec de paiement asynchrone ne crée aucune commission.

AffiHQ ne crédite pas automatiquement un paiement qui ne peut pas être rattaché au produit, au Payment Link sélectionné, au compte Stripe, au client et au clic affilié correspondants. Vérifiez que le lien utilisé provient bien de l’URL /r/ du produit et que le produit utilise toujours ce Payment Link.

Payment Link d’abonnement

Le Checkout d’un abonnement verrouille l’attribution sur l’abonnement. Le Payment Link sélectionné détermine la périodicité mensuelle ou annuelle. Chaque invoice.paid de cet abonnement crée le paiement récurrent correspondant, selon la durée de commission et les règles de validation du produit.

Le Checkout établit l’attribution de l’abonnement ; les commissions récurrentes suivantes proviennent des factures payées. Une facture impayée ou échouée ne crée pas de paiement réussi.

Remboursements et litiges

AffiHQ corrige les données financières natives selon le statut de l’opération Stripe, et non simplement parce qu’une demande a été créée.

Remboursements

Seul un remboursement dont le statut Stripe est réussi corrige les données financières. Un remboursement en attente, nécessitant une action, échoué ou annulé ne crée pas encore de correction.

Les remboursements partiels et plusieurs remboursements du même paiement sont cumulés. AffiHQ répartit la part de taxe de manière déterministe, réduit le montant commissionnable en conséquence et ne corrige jamais plus que le montant du paiement d’origine. Ce même montant d’origine limite aussi les corrections dues aux litiges perdus.

Litiges

Lorsqu’un litige est ouvert, AffiHQ peut réserver ou corriger le montant associé au plus une fois. Si le litige est gagné, il est résolu sans nouvelle correction financière. S’il est perdu, AffiHQ applique la correction. Une issue terminale n’est résolue qu’une fois : les livraisons en double ne créent donc pas une seconde correction.

Ce qu’AffiHQ gère automatiquement

En mode natif, AffiHQ gère automatiquement :

la vérification des signatures des webhooks Stripe Connect ;
les contrôles de propriété du compte Standard connecté et du produit ;
les contrôles du mode test/live ;
la réception durable, les nouvelles tentatives et l’idempotence des livraisons Stripe ;
le rattachement d’un paiement, remboursement ou litige au paiement attribué exact.

Votre application n’a pas besoin de recevoir ni de transmettre les webhooks Stripe. Gardez à jour les règles, la devise et le Payment Link sélectionné du produit, puis consultez le guide de dépannage si le produit n’est pas prêt.

Marchand de référence et paiements aux affiliés

Vous restez le marchand de référence sur votre compte Stripe Standard. L’abonnement AffiHQ est facturé séparément de vos paiements clients. AffiHQ enregistre la commission et l’obligation de paiement ; il ne transfère pas les fonds aux affiliés par Stripe. Envoyez les paiements aux affiliés selon votre propre processus, comme expliqué dans Commissions et paiements.

Changer de mode ou révoquer l’accès

Le passage d’un produit au mode API/SDK avancé empêche le Payment Link natif sélectionné de piloter les redirections /r/ et le parcours de paiement automatique de ce produit. Le compte Stripe reste connecté. La destination historique du produit et affihq_ref reprennent le relais ; le parcours API/SDK doit donc réaliser l’attribution et transmettre les paiements.

Pour révoquer l’accès d’AffiHQ au compte Stripe, retirez l’application connectée depuis Stripe. Le traitement natif s’arrête alors et le produit doit être reconnecté et reconfiguré avant de réutiliser Stripe automatique. La révocation de l’accès est différente du passage d’un produit en mode API : ce passage ne déconnecte pas le compte.

Pour comparer les deux parcours d’intégration, consultez la vue d’ensemble de l’intégration.