ReCharge (Shopify)

Intégration ReCharge (Shopify)

Une intégration spécifique pour ReCharge n’est plus nécessaire. Veuillez utiliser à la place l’intégration Shopify habituelle  !

La plateforme ReCharge vous permet d’ajouter des produits par abonnement récurrents à votre boutique Shopify. Ce guide explique comment intégrer ReCharge avec Post Affiliate Pro pour suivre ces paiements récurrents.

Pour suivre les paiements récurrents, vous devez activer soit la fonctionnalité Commissions récurrentes ou le plugin Commissions à vie dans votre Post Affiliate Pro !

Le processus d’intégration dépend du type de passage en caisse utilisé dans la boutique : ReCharge Checkout sur Shopify ou Shopify Checkout.

Les clients ayant installé ReCharge après le 2 novembre 2020 utilisent Shopify Checkout, tandis que ceux ayant installé ReCharge avant cette date utilisent ReCharge Checkout sur Shopify. Vous pouvez vérifier le type de passage en caisse de votre boutique directement dans le panneau d’administration ReCharge de votre boutique -> Paramètres (icône clé) -> Boutique (Mon compte) -> Statut du compte. Cliquez ici pour plus de détails.

Si votre boutique utilise Shopify Checkout, vous devez créer un jeton API comme décrit à l’étape 1 et configurer le plugin webhook ReCharge comme décrit à l’étape 2. Ensuite, poursuivez l’intégration de votre boutique Shopify comme décrit dans ce guide. Vous n’avez pas besoin de faire les étapes 3 et 4 ci-dessous.

Si votre boutique utilise ReCharge Checkout sur Shopify, vous devez suivre les quatre étapes décrites ci-dessous.

Créer un jeton API

En premier lieu, vous devrez contacter ReCharge pour demander l’accès à l’API. Cliquez ici pour plus de détails.

Une fois l’accès à l’API accordé, vous pouvez créer votre jeton API. Pour cela, connectez-vous à votre panneau d’administration Shopify, rendez-vous dans la section Applications et cliquez sur Recurring Billing par ReCharge pour accéder au panneau ReCharge.

Une fois sur place, cliquez sur l’onglet Intégrations dans le menu du haut, puis sur Intégrations activées, puis sur Jetons API. Sur le côté droit de la page. Ensuite, cliquez sur Créer un jeton API.

Nommez le jeton API selon votre choix, ajoutez un email qui sera notifié en cas d’échec du webhook, et surtout assurez-vous d’ajouter la permission d’accès en lecture aux Commandes. Si vous voyez également la permission Webhooks, définissez-la sur Lecture et écriture, cependant il se peut qu’elle ait été supprimée et il n’est donc plus nécessaire de la configurer.

Enregistrez le jeton et copiez sa clé API.

Configurer le plugin webhook ReCharge

L’étape suivante consiste à vous connecter à votre panneau marchand Post Affiliate Pro , allez dans Configuration -> Plugins et activez le plugin nommé ReCharge webhook handling. Une fois actif, cliquez sur le bouton Configurer et ajoutez la clé API Recharge sur la page de configuration du plugin. Sur cette page, vous pouvez également configurer ce qui sera suivi comme Product ID, et choisir de suivre des données de commande supplémentaires dans les champs de données supplémentaires. Lorsque vous avez terminé, enregistrez la configuration du plugin en bas de page.

Modifier votre page de remerciement

Si votre boutique utilise ReCharge Checkout sur Shopify comme décrit ci-dessus, connectez-vous à votre panneau d’administration Shopify, allez dans la section Applications et cliquez sur Recurring Billing by ReCharge pour accéder au panneau d’administration ReCharge. Une fois sur place, cliquez sur Paramètres (icône clé) en haut à droite puis rendez-vous dans la section Checkout. Faites défiler jusqu’à la section Page de remerciement et collez le code suivant dans le champ Additional & scripts et trackers :

<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
PostAffTracker.setAccountId('Account_ID');
var discountMultiplier = 1 - {{total_discounts}} / ({{subtotal_price}} + {{total_discounts}});
{% for item in line_items %}
var itemPrice = {{item.price}} * {{item.quantity}};
  var sale{{ loop.index }} = PostAffTracker.createSale();
  sale{{ loop.index }}.setTotalCost(itemPrice * discountMultiplier);
  var subscriptionId = '{{item.subscription_id}}';
  if (subscriptionId  != '') {
    sale{{ loop.index }}.setOrderID(subscriptionId);
  } else {
    sale{{ loop.index }}.setOrderID('{{id}}({{ loop.index }})');
  }
  sale{{ loop.index }}.setProductID('{{item.product_id}}');
  sale{{ loop.index }}.setCoupon('{{discount_code}}');
{% endfor %}
PostAffTracker.register();
</script>

Si vous souhaitez enregistrer le nom ou l’email du client, vous pouvez ajouter les lignes suivantes :

  sale{{ loop.index }}.setData1('{{email}}');
  sale{{ loop.index }}.setData2('{{first_name}} {{last_name}}');

sous :

sale{{ loop.index }}.setCoupon('{{discount_code}}');

Vous trouverez d’autres variables disponibles dans la base de connaissances ReCharge .

Suivi des clics

Connectez-vous à votre panneau d’administration Shopify, allez dans la section Boutique en ligne puis cliquez sur Thèmes. Dans cette section, cliquez sur le bouton Actions dans l’aperçu de votre thème actif, puis choisissez Modifier le code dans le menu déroulant.

Dans le répertoire Layout, trouvez le fichier nommé theme/liquid. Insérez le code de suivi des clics depuis votre panneau marchand Post Affiliate Pro - > Outils -> Intégration -> Suivi des clics juste au-dessus de la balise </BODY> dans ce fichier et enregistrez-le.