Vue d’ensemble de l’intégration

AffiHQ propose deux modes d’intégration par produit. Choisissez celui qui gère le parcours de paiement de ce produit ; n’envoyez pas les mêmes faits de paiement natifs et avancés comme s’il s’agissait de ventes distinctes.

Matrice de décision

Question	Stripe automatique	API/SDK avancé
Où le Checkout a-t-il lieu ?	Sur un Payment Link hébergé par Stripe et sélectionné	Dans votre Checkout ou votre système de facturation
Quand l’utiliser ?	Stripe est la source de paiement et la forme du Payment Link convient au produit	Checkout personnalisé, facturation non-Stripe, attribution avant Checkout, remises/essais/onboarding personnalisés ou événements non financiers
Quels identifiants sont nécessaires ?	Un compte Stripe Standard connecté et un Payment Link compatible ; aucune clé API ni aucun identifiant SDK AffiHQ	Une clé API produit et une clé d’empreinte conservées sur votre serveur
Qui gère les webhooks Stripe ?	AffiHQ les vérifie et les traite automatiquement ; votre application ne transmet pas les webhooks Stripe	Votre serveur vérifie le webhook du prestataire d’origine avant d’envoyer le fait de facturation à AffiHQ
Que fait la redirection affiliée ?	Elle enregistre le clic puis ouvre le Payment Link avec un `client_reference_id=clk_*` opaque	Elle enregistre ou transmet un `affihq_ref` opaque à votre destination pour l’attribution serveur

Commencez par le guide Stripe automatique lorsque Stripe est votre source de paiement. Pour le parcours avancé, utilisez l’authentification de l’API et le SDK serveur.

Parcours Stripe automatique de bout en bout

Dans Produits, choisissez Stripe automatique et connectez le compte Stripe Standard qui possède le Payment Link.
Sélectionnez un Payment Link actif buy.stripe.com avec exactement une ligne à prix fixe, une quantité 1, un montant positif, une seule devise et une facturation ponctuelle ou par abonnement. Les abonnements doivent être mensuels ou annuels.
Le lien /r/ d’un affilié enregistre le clic puis ouvre ce Payment Link avec un client_reference_id=clk_* opaque. Les paramètres existants sont conservés et un ancien client_reference_id est remplacé.
Pour un paiement ponctuel, un Checkout immédiatement réussi ou la réussite ultérieure d’un paiement asynchrone crée le paiement. Un échec asynchrone ne crée aucune commission.
Pour un abonnement, le Checkout verrouille l’attribution et chaque invoice.paid crée un paiement récurrent selon le lien mensuel ou annuel sélectionné.
AffiHQ applique les règles de commission et de validation du produit et gère automatiquement les signatures Stripe, la propriété du compte, le mode test/live, la réception durable, les nouvelles tentatives, l’idempotence et le rattachement.
Les remboursements réussis et les issues de litige créent la correction cumulative applicable. Les commissions prêtes peuvent ensuite rejoindre un paiement que vous envoyez séparément.

Si l’état natif est invalide ou indisponible, /r/ revient à la destination historique avec affihq_ref. Ce parcours de secours nécessite le flux serveur avancé pour terminer l’attribution et transmettre les paiements.

Parcours API/SDK avancé de bout en bout

Configurez le produit en API/SDK avancé et conservez sa clé API et sa clé d’empreinte dans le gestionnaire de secrets du serveur.
Capturez affihq_ref dans le navigateur ou acceptez un code partenaire saisi à la main selon vos règles de consentement et de stockage. Ne placez jamais de secret produit dans le code navigateur.
Lorsque votre application crée le client ou le prospect, votre serveur crée l’attribution avec un identifiant client opaque et stable ainsi qu’une empreinte propre au produit. La première attribution admissible reste la référence.
Votre serveur termine son inscription ou son Checkout, vérifie le webhook du prestataire de paiement d’origine et envoie le paiement vérifié avec une identité d’événement stable.
Envoyez les remboursements et issues de litige vérifiés avec l’identité du paiement d’origine lorsque le prestataire les signale.
AffiHQ crée ou corrige la commission correspondante. Retentez les erreurs temporaires sans changer l’identité de l’événement d’origine ; examinez les rejets métier stables au lieu de modifier automatiquement les données financières.

Le parcours avancé convient lorsque le paiement ne vient pas directement du Payment Link Stripe sélectionné ou lorsque votre événement métier n’est pas un paiement Stripe. Continuez avec la capture de la référence dans le navigateur, le SDK serveur, les événements de facturation et la livraison durable.

Identifiants, webhooks et responsabilités

Stripe automatique ne nécessite ni clé API produit AffiHQ, ni clé d’empreinte, ni SDK Stripe. AffiHQ reçoit et vérifie les livraisons Stripe du compte connecté. Vous restez le marchand de référence sur votre compte Stripe Standard, et l’abonnement AffiHQ est séparé. AffiHQ enregistre les obligations de paiement aux affiliés, mais ne transfère pas les fonds par Stripe.

Le mode API/SDK avancé nécessite la clé API produit et la clé d’empreinte sur votre serveur. Votre serveur doit vérifier le webhook du prestataire d’origine avant d’envoyer un événement de facturation, ne pas transmettre l’email du client dans les données AffiHQ et utiliser des identités d’idempotence stables pour les nouvelles tentatives. Le navigateur ne doit transporter que la référence affiliée opaque.

Pour les erreurs natives et la solution de secours, consultez le guide de dépannage Stripe automatique. Pour les limites d’accès, consultez Permissions de l’espace de travail.