Dépannage de Stripe automatique

Ce guide concerne un produit configuré avec Stripe automatique. Commencez par vérifier l’état Stripe du produit, le mode du déploiement et le Payment Link sélectionné. Pour toutes les conditions, consultez Paiements Stripe automatiques.

Aucun compte Stripe n’est connecté

Ouvrez l’éditeur du produit, sélectionnez Stripe automatique, puis Connecter Stripe. Autorisez le compte Stripe Standard qui possède le Payment Link.

Si le compte est déjà connecté à un autre produit, réutilisez-le uniquement s’il correspond au mode configuré pour le déploiement. Le développement utilise Stripe test ; la production utilise Stripe live. Un produit test ne peut pas utiliser un Payment Link live, et un produit live ne peut pas utiliser de données test.

Si Connecter Stripe n’aboutit pas, recommencez depuis l’éditeur du produit et vérifiez que l’autorisation du compte Stripe est toujours valide. Ne collez jamais de clé secrète ni de jeton OAuth dans une demande d’assistance.

Le Payment Link est absent ou indisponible

AffiHQ liste les Payment Links du compte, mais seul un lien actif et compatible peut être sélectionné. Vérifiez dans Stripe que le lien :

est hébergé à l’adresse https://buy.stripe.com/... ;
contient exactement une ligne à prix fixe ;
utilise la quantité 1 et un montant positif ;
utilise une seule devise ;
correspond à un paiement ponctuel ou à un abonnement ;
utilise une périodicité mensuelle ou annuelle s’il s’agit d’un abonnement ;
appartient au même mode Test ou Live que le compte connecté.

Les liens inactifs et ceux dont le prix, la quantité, la périodicité ou l’URL sont incompatibles restent indisponibles. Si le sélecteur contient davantage de résultats, utilisez Charger plus avant de conclure que le lien est absent.

Le produit est connecté, mais pas prêt

Un compte connecté ne suffit pas. Le produit doit aussi avoir un Payment Link sélectionné. Dans l’éditeur, choisissez un lien compatible puis sélectionnez Utiliser ce Payment Link. Vérifiez son montant, sa devise et sa périodicité.

Si le lien sélectionné a été désactivé ou modifié dans Stripe, sélectionnez un autre lien compatible et choisissez Utiliser ce Payment Link. Un produit utilise un seul Payment Link à la fois.

Un paiement n’est pas crédité

Un paiement natif n’est crédité que si AffiHQ peut le rattacher à tous les éléments suivants :

le compte Stripe Standard connecté ;
le Payment Link sélectionné du produit et l’instantané enregistré de son montant, de sa devise et de sa périodicité ;
un clic AffiHQ /r/ ;
le client et l’attribution affiliée du produit.

Vérifiez que le client a utilisé le lien /r/ généré et que celui-ci a ouvert le Payment Link sélectionné. Confirmez aussi que le produit n’est pas passé en mode API/SDK avancé et que le déploiement utilise le même mode Test ou Live que Stripe.

Les paiements impossibles à rattacher ne sont pas crédités automatiquement. Corrigez la configuration du lien, du produit ou du compte, puis utilisez le mode API/SDK avancé si le parcours client exige une attribution personnalisée avant le Checkout ou un autre flux.

Le compte Stripe a été révoqué ou déconnecté

Si le produit affiche Reconnecter Stripe, ou si les paiements automatiques sont suspendus, l’application connectée n’a plus un accès utilisable. Reconnectez le même compte Standard dans le mode attendu, puis choisissez et enregistrez à nouveau un Payment Link compatible.

Le retrait de l’application connectée depuis Stripe arrête le traitement natif. Le passage du produit au mode API/SDK avancé est différent : il laisse le compte Stripe connecté et ne change que le parcours de paiement de ce produit.

Un paiement asynchrone est encore en cours

Un paiement immédiat peut créer une commission lorsque le Checkout réussit. Avec un moyen de paiement asynchrone, le Checkout peut d’abord établir le clic et l’attribution ; la commission est créée seulement lorsque Stripe signale la réussite du paiement asynchrone. Un échec asynchrone ne crée aucune commission.

Pour un abonnement, le Checkout verrouille l’attribution et chaque invoice.paid réussi crée un paiement récurrent. La périodicité mensuelle ou annuelle du lien sélectionné détermine la période. Une facture impayée ou échouée n’est pas un paiement réussi.

Un remboursement ou un litige n’a pas modifié la commission

AffiHQ applique uniquement un remboursement dont le statut est réussi. Un remboursement en attente, nécessitant une action, échoué ou annulé ne corrige pas encore les données financières.

Les remboursements partiels et répétés sont cumulés, avec une répartition déterministe de la taxe et un plafond fixé au montant du paiement d’origine. Un litige ouvert peut réserver ou corriger le montant associé au plus une fois. Un litige gagné se résout sans nouvelle correction ; un litige perdu applique la correction, et l’issue terminale n’est appliquée qu’une fois.

La correction peut d’abord modifier une commission en période de validation ou réduire le montant prêt à payer. Si la commission d’origine a déjà été payée, AffiHQ enregistre le solde négatif qui sera compensé par les commissions futures ; il ne prélève pas automatiquement d’argent sur l’affilié.

Le lien affilié a ouvert le site historique

Lorsque l’état Stripe natif est invalide ou indisponible, /r/ utilise de manière sûre la destination historique du produit avec affihq_ref. Cette solution conserve la référence du clic, mais ne crée pas automatiquement un paiement Stripe natif.

Votre serveur doit suivre le parcours API/SDK avancé : capturer affihq_ref, créer l’attribution avant ou pendant le parcours client, puis transmettre les paiements vérifiés. Si vous ne souhaitez pas cette solution de secours, rétablissez un compte connecté et un Payment Link sélectionné compatible avant d’envoyer du trafic.

Informations à transmettre à l’assistance

Fournissez uniquement un contexte sans secret :

le nom du produit ;
le mode du déploiement : Test ou Live ;
le nom affiché du compte Stripe, si disponible ;
l’URL du Payment Link ;
le montant, la devise et la périodicité ponctuelle/mensuelle/annuelle ;
l’URL affiliée /r/ et l’heure approximative avec son fuseau ;
l’état ou le message d’erreur visible dans le produit ;
une référence Stripe non sensible du Checkout, de la facture, du remboursement ou du litige si l’assistance la demande.

N’envoyez jamais de clé API, clé d’empreinte, jeton OAuth, secret de signature de webhook, donnée de carte, adresse email client ni payload complet du prestataire. La vue d’ensemble de l’intégration explique quel parcours choisir si le mode natif ne convient pas.