Accueil
XtreamUIPro

Tutoriel

Connecter une boutique avec un connecteur

Laissez votre plateforme de facturation ou de boutique créer et renouveler les lines toute seule : une clé API, le connecteur de votre plateforme, une commande de test et des webhooks pour la suite.

À la fin, une commande payée sur votre plateforme crée une line et chaque paiement la renouvelle, sans passer par le tableau de bord. Il vous faut un compte partenaire (revendeur) avec des crédits et des packages qu'il peut vendre, et une plateforme dotée d'un connecteur — WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress avec WooCommerce ou Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, ou Shopify, Upmind et Invoice Ninja via le pont de webhooks.

Créer une clé API

Connectez-vous avec le compte partenaire et ouvrez API Key. Une clé n'est affichée qu'une fois, à sa création — copiez-la immédiatement. Créez une clé supplémentaire par système, avec un nom et les adresses autorisées à l'utiliser, pour pouvoir en révoquer une sans toucher aux autres ; le connecteur a besoin d'une clé autorisée à écrire, laissez donc l'indicateur lecture seule désactivé.

La page API Key d'un compte partenaire : la clé, les clés supplémentaires par système, les webhooks et les appels récents.
La page API Key d'un compte partenaire : la clé, les clés supplémentaires par système, les webhooks et les appels récents.

Choisir le connecteur

Ouvrez Resources → All Connectors et choisissez votre plateforme. Sa page indique les détails de connexion, les étapes d'installation, un bouton Download, le SHA-256 du fichier pour le vérifier, et jusqu'où ce connecteur a été testé — certains ont tourné dans la vraie plateforme, d'autres n'ont eu que leur cœur exercé. Le code source est ouvert ; les mêmes fichiers sont publiés sur le site des connecteurs.

La page All Connectors : une carte par plateforme avec sa version et jusqu'où elle a été testée.
La page All Connectors : une carte par plateforme avec sa version et jusqu'où elle a été testée.

L'installer sur votre plateforme

Vérifiez la somme de contrôle et installez le fichier là où la page du connecteur l'indique : le dossier des modules de WHMCS, Blesta ou FOSSBilling, l'envoi de plugin de WordPress, le dossier addons d'Odoo, l'installateur d'extensions d'OpenCart, etc. Le pont de webhooks pour Shopify, Upmind et Invoice Ninja est une petite application PHP que vous hébergez vous-même. Un connecteur ne fait qu'appeler la Reseller API avec votre clé : il peut faire ce que votre compte peut faire, rien de plus.

La page du connecteur WHMCS : détails de connexion, étapes d'installation, le téléchargement et son SHA-256.
La page du connecteur WHMCS : détails de connexion, étapes d'installation, le téléchargement et son SHA-256.

Le configurer

Dans les réglages du connecteur, saisissez l'adresse du serveur d'API (son chemin /reseller/v1) et la clé, puis associez chaque produit de votre plateforme à un package que votre groupe peut vendre. Les prix et le paiement restent sur votre plateforme : le panneau n'encaisse aucun argent et n'a pas de passerelle de paiement.

Passer une commande de test

Commandez le produit dans un environnement de test de votre plateforme. Le connecteur appelle create_line avec le package et un identifiant de requête ; la line apparaît dans Lines avec la durée du package comme expiration, et votre plateforme reçoit ses identifiants. Un renouvellement appelle renew_line avec son propre identifiant de requête, de sorte qu'une nouvelle tentative après une erreur réseau n'est jamais facturée deux fois. La page API Key liste les appels récents avec l'action, le résultat, le code d'erreur, l'adresse et le nom du connecteur.

La page Lines après une commande de test : la nouvelle line avec le package, l'expiration et les connexions demandés par le connecteur.
La page Lines après une commande de test : la nouvelle line avec le package, l'expiration et les connexions demandés par le connecteur.

Ajouter des webhooks (facultatif)

Sur la page API Key, ajoutez un point de terminaison de webhook (une adresse https de votre plateforme) pour les événements souhaités : line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Chaque notification est signée avec le secret affiché une seule fois à la création (X-Xtream-Signature) et ne contient jamais de mot de passe ; le bouton Test en envoie une aussitôt.

Sujets d'aide associés

Tutoriels suivants