Points d’entrée de l’API — API/SDK avancé

Ces points d’entrée concernent les intégrations API/SDK avancées. Stripe automatique utilise le Payment Link sélectionné et les livraisons Stripe Connect gérées par AffiHQ ; il n’a pas besoin de clés produit ni de ces points d’entrée pour les faits de paiement Stripe connectés. En mode API/SDK avancé, tous les corps de requête utilisent JSON. Les dates suivent RFC 3339 avec un décalage explicite. Les montants sont des entiers positifs ou nuls dans l’unité mineure de la devise.

POST/api/v1/references/validate

Prévisualise une référence de lien opaque ou un code manuel, puis renvoie l’admissibilité et les instructions de remise.

La validation ne réserve ni ne verrouille une attribution. Ajoutez l’empreinte client propre au produit lorsque la protection contre l’auto-parrainage est nécessaire.

POST/api/v1/attributions

Verrouille le premier affilié admissible pour un produit et un identifiant client marchand opaque.

La réponse contient les copies immuables des règles de commission et de remise. Le rejeu de la même intention renvoie l’attribution existante ; une référence ultérieure ne peut pas la remplacer.

GET/api/v1/attributions/{id}/discount?billingCycle=monthly

Renvoie les instructions de remise figées lors de la création de l’attribution.

Votre application traduit ces instructions pour Stripe ou son propre système de facturation. AffiHQ ne crée ni n’utilise de coupon.

POST/api/v1/billing-events

Accepte les paiements, remboursements et litiges personnalisés ou non natifs vérifiés avec une clé d’idempotence obligatoire.

Pour le mode API/SDK avancé, authentifiez d’abord le webhook du prestataire. Utilisez ce point d’entrée pour les faits de facturation personnalisés ou non natifs. Stripe automatique transmet lui-même les événements Stripe connectés à AffiHQ : ne transmettez jamais les mêmes événements et ne les dupliquez pas via ce point d’entrée. Un paiement accepté peut créer une commission ; une inscription seule n’en crée aucune.

Codes de statut

Statut	Signification
`200`	Lecture, validation ou rejeu idempotent
`201`	Attribution créée
`202`	Événement financier accepté
`400`	JSON ou contrat invalide
`401`	Clé produit absente ou invalide
`404`	Référence ou attribution introuvable
`409`	Conflit d’attribution ou d’idempotence
`422`	Référence connue mais non admissible
`429`	Débit limité ; retenter avec un délai croissant
`5xx`	Erreur temporaire ; retenter avec un délai croissant