Votre boutique doit être approuvée pour le programme d’affiliation. Faites votre demande dans le tableau de bord, sous Affiliates. En attendant, chaque point de terminaison d’affiliation renvoie
403 avec le code FEATURE_NOT_ENABLED.Points de terminaison
L’approbation des partenaires, l’examen des conversions signalées et l’envoi des paiements restent dans le tableau de bord.
Montants et identifiants
- Dans les réponses de l’API, les montants sont des entiers en unités mineures.
commission: 499enUSDcorrespond à 4,99 $. - Les charges utiles des webhooks utilisent les unités majeures.
commission: 4.99correspond à 4,99 $. - Les partenaires et les paiements utilisent des identifiants publics de 16 caractères. Les conversions utilisent l’
invoice_idpublic de la commande.
Pagination
Les points de terminaison de liste renvoient 25 éléments par page avec unnext_cursor. Renvoyez-le dans cursor pour obtenir la page suivante. next_cursor vaut null sur la dernière page.
counts, le nombre d’enregistrements par statut :
Inviter un partenaire
Réponse (201)
Attribution des commandes
Une commande est créditée à un partenaire de l’une des façons suivantes, par ordre de priorité :- Coupon partenaire. L’acheteur a utilisé un coupon lié au partenaire.
- Lien de suivi. L’acheteur a ouvert un lien partenaire :
https://your-store.com/any-page?ref=CODEouhttps://your-store.com/r/CODE. La vitrine mémorise le clic pendant la durée de validité du cookie du programme. - API. Vous avez transmis
affiliateCodelors de la création de la facture. La conversion asource: "api".
États de commission
Les remboursements annulent automatiquement la commission.
commission correspond toujours au montant net.
Webhooks
Abonnez-vous à ces événements dans Developers › Webhooks. Ils utilisent la même enveloppe et le même en-têtePapelShip-Signature que les événements de commande.
affiliate.conversion
affiliate.payout_sent
Erreurs
Les erreurs d’affiliation incluent uncode lisible par machine :