Capture de la référence dans le navigateur — API/SDK avancé

La capture dans le navigateur concerne uniquement les intégrations API/SDK avancées. L’entrée navigateur de @affihq/sdk stocke seulement une référence opaque et ses dates. Elle n’effectue aucune requête authentifiée et ne contient aucun code cryptographique serveur.

En mode Stripe automatique, /r/ enregistre le clic puis redirige directement vers le Payment Link sélectionné ; aucune capture via le SDK navigateur n’est nécessaire.

Capturer un lien

import { readReferralFromUrl, storeReferral } from '@affihq/sdk/browser'

const reference = readReferralFromUrl(window.location.href)

if (reference) {
  storeReferral(reference, {
    enabled: attributionStorageAllowed,
    maxAgeDays: 90,
  })
}

Renseignez enabled à partir de la politique de stockage d’attribution de votre application. L’attribution affiliée peut répondre à une finalité distincte de la mesure d’audience ; appliquez les règles de consentement et de stockage de la juridiction du client avant de stocker la référence.

Résoudre un code manuel

import { chooseReferral, loadReferral } from '@affihq/sdk/browser'

const referral = chooseReferral({
  manualCode: form.partnerCode,
  storedReference: loadReferral()?.reference,
})

À ce stade, un code saisi volontairement prime sur un lien mémorisé. Aucun des deux ne peut remplacer une attribution déjà verrouillée par votre serveur.

Comportement du stockage

Le cookie par défaut utilise SameSite=Lax, devient Secure en HTTPS et expire à la fin de la fenêtre d’attribution. Fournissez une implémentation ReferralStorage personnalisée si votre application utilise un autre mécanisme.

Ne stockez dans ce cookie ni taux d’affiliation, ni email client, ni remise, ni réponse de l’API.