Paiements et boutiques

Pour : les paiements uniques et les abonnements, sur une page de paiement hébergée par Stripe. Les acheteurs ne saisissent jamais un numéro de carte dans votre application.

Se connecte avec : le bouton Set up Stripe. Vous remplissez le formulaire de Stripe lui-même et vous revenez, et aucune clé ne vous est montrée. Publiez d’abord l’application, car Stripe examine le site en ligne et refuse celui qui est encore en construction. Il demande une pièce d’identité et un compte bancaire. Vous pouvez utiliser des clés à la place : la clé publiable (elle commence par pk_) et la clé secrète (elle commence par sk_) de vos clés d’API Stripe, et un secret de signature de webhook (il commence par whsec_).

Clés collées uniquement : la carte Stripe affiche l’adresse du webhook à ajouter dans Stripe, avec un bouton de copie. Ajoutez-la pour les événements checkout.session.completed et checkout.session.async_payment_succeeded. Avec le bouton, il n’y a aucun webhook à configurer.

À demander :

• « Ajoutez un bouton Acheter maintenant pour le cours »
• « Ajoutez un abonnement mensuel et un bouton Manage billing »
• « Ajoutez une page Mes commandes »

Ce qui se passe : les commandes sont enregistrées quand Stripe indique qu’un paiement est passé, et apparaissent sous Manage, puis Payments. Consultez Boutiques en ligne.

Limites : une application peut lancer un paiement, le relire et lire votre liste de prix. Les remboursements, les clients et les versements sont inaccessibles depuis une application. Remboursez depuis Manage, puis Payments, ou dans Stripe. Manage billing ne fonctionne que pour une personne connectée qui a acheté quelque chose dans cette application.

Pour : les paiements et les abonnements où Paddle vend en tant que vendeur, si bien que la TVA et la taxe sur les ventes sont gérées pour vous. Utile quand vous vendez au-delà des frontières.

Se connecte avec : des clés, depuis la page d’authentification de Paddle.

• Client-side Token (commence par live_, ou test_ pour le bac à sable). Public par conception, donc intégré à l’application publiée.
• API Key (commence par pdl_live_apikey_ ou pdl_test_apikey_). Reste sur les serveurs de Setherion.
• Webhook Secret (commence par pdl_ntfset_). Facultatif.

À demander :

• « Ajoutez un forfait Pro avec un bouton S’abonner qui ouvre le paiement Paddle »
• « Affichez le prix et ce qui est inclus avant l’ouverture du paiement »

Comment cela fonctionne : le paiement s’ouvre dans la fenêtre superposée propre à Paddle, dans le navigateur du visiteur. Vous créez vos prix dans le tableau de bord de Paddle et l’application les utilise par leur identifiant pri_. La page n’envoie jamais de montant, car quiconque ouvre la page peut le modifier.

Limites : la clé d’API n’est pas utilisée par l’application publiée, qui n’a pas de serveur. Un jeton qui commence par test_ ne fonctionne qu’avec le bac à sable de Paddle. Test connection lit un produit de votre compte Paddle.

Pour : un bouton Acheter pour un article à prix fixe. Le prix, la taxe et la livraison se trouvent dans PayPal, si bien que personne qui ouvre la page ne peut changer ce qu’il paie. Les acheteurs paient dans la fenêtre propre à PayPal, avec PayPal ou par carte.

Se connecte avec : deux valeurs.

• Client ID : dans PayPal, ouvrez Pay links and buttons, puis un bouton, puis son code. C’est la valeur après client-id=. Public par conception.
• Currency : trois lettres, comme GBP ou EUR, les mêmes que sur vos boutons dans PayPal.

Créez d’abord vos boutons, sur la page des boutons de PayPal.

À demander :

• « Ajoutez un bouton Acheter PayPal pour chacune des trois estampes »
• « Placez le bouton PayPal sous le prix sur la page du produit »

Limites : chaque bouton achète un article au prix défini dans PayPal. Il n’y a pas de panier. Votre application n’est pas prévenue quand quelqu’un paie : PayPal vous envoie un e-mail, ainsi qu’à l’acheteur, et la vente n’est pas enregistrée dans l’application. Pour un panier, des commandes conservées dans votre application ou des abonnements, connectez plutôt Stripe ou Paddle. La page du connecteur dit la même chose.

Pour : la facturation d’abonnements. Un bouton S’abonner ouvre le paiement hébergé de Chargebee, un bouton Manage billing ouvre le portail client, et votre équipe peut voir les clients, les abonnements et les factures.

Se connecte avec : des clés.

• Site name : la partie avant .chargebee.com dans l’adresse de votre tableau de bord, en minuscules.
• API key : dans Chargebee, Settings, puis Configure Chargebee, puis API Keys, puis Add API Key. Choisissez une Write Key (créer, lire et mettre à jour, jamais supprimer). C’est tout ce dont une application a besoin.

À demander :

• « Ajoutez une page de tarifs à partir de mes forfaits Chargebee, avec un bouton S’abonner sur chacun »
• « Ajoutez un bouton Manage billing pour les clients connectés »
• « Créez une page d’équipe avec mes abonnements et mes factures impayées »

Qui peut faire quoi : les visiteurs peuvent lancer un paiement, ouvrir le portail de facturation et lire les forfaits et les prix en vente, pour une page de tarifs. Les clients, les abonnements et les factures, ainsi que modifier les forfaits et les prix, sont réservés à votre équipe. Marquez les comptes de votre équipe dans Manage, puis Cloud, puis Users.

Limites : il utilise Chargebee Product Catalog 2.0, donc les forfaits sont des prix d’article. Les montants arrivent en pence ou en cents. Supprimer n’est pas possible depuis une application. Dans Permissions, vous pouvez désactiver le paiement, le portail, ou la lecture et la modification de chacun des clients, abonnements, factures, forfaits et prix.

Pour : une nouvelle vitrine sur une boutique Shopify. Les produits, les prix et le stock restent dans Shopify, et les acheteurs paient sur la page de paiement propre à Shopify.

Se connecte avec : deux valeurs.

• Store domain : l’adresse en .myshopify.com, même si votre boutique montre un domaine personnalisé à ses clients.
• Storefront API token (public) : dans l’administration de Shopify, ouvrez Sales channels, puis Headless, puis Create storefront. Copiez son jeton d’accès public.

N’utilisez jamais le jeton d’API Admin (il commence par shpat_) : la carte le refuse, car ce jeton est intégré à l’application publiée et tout le monde peut le lire.

À demander :

• « Une nouvelle vitrine pour ma boutique Shopify, avec les collections sur la page d’accueil »
• « Ajoutez un panier qui envoie les acheteurs vers le paiement Shopify »
• « Ajoutez une recherche et des filtres sur mes produits Shopify »

Autorisations : Shopify est différent. Vos applications l’appellent directement depuis la page avec le jeton public, donc il n’y a aucun interrupteur dans Setherion. Définissez les limites dans Shopify : Sales channels, Headless, votre vitrine, puis Manage à côté de Storefront API, puis Permissions. Elles s’appliquent à toutes les vitrines du canal Headless.

Limites : le stock, les commandes et les paiements restent dans Shopify. Si un article est en rupture de stock, l’application dit ce qui a changé avant d’envoyer l’acheteur plus loin.

Pour : une vitrine qui affiche vos vrais produits WooCommerce et envoie les acheteurs vers votre propre page de paiement.

Se connecte avec : des clés.

• Shop address : l’adresse sur laquelle tourne votre boutique, celle qui a /wp-admin derrière elle.
• Consumer key (commence par ck_) et Consumer secret (commence par cs_) : dans WooCommerce, ouvrez Settings, puis Advanced, puis REST API, puis Add key, avec Permissions réglé sur Read.

Les deux clés restent sur les serveurs de Setherion.

À demander :

• « Affichez mes produits WooCommerce dans une grille avec un bouton Acheter sur chacun »
• « Ajoutez une page pour chaque produit avec ses photos et son prix »

Limites : les produits sont la seule chose qu’une application puisse lire. Les commandes et les clients sont refusés, donc il n’y a ni historique de commandes ni compte client ici. L’achat se fait sur votre boutique : le bouton envoie l’acheteur vers votre page de paiement avec le produit ajouté. Les prix arrivent dans la devise de la boutique, tels que la boutique les donne. Test connection lit un produit.

Pour : une vitrine qui affiche vos vrais produits PrestaShop et envoie les acheteurs vers la page de chaque produit dans votre boutique.

Se connecte avec : des clés.

• Shop address : l’adresse sur laquelle tourne votre boutique, celle qui a /admin derrière elle.
• Webservice key : 32 lettres et chiffres. Dans PrestaShop, ouvrez Advanced Parameters, puis Web service, puis Add new webservice key, et cochez View (GET) sur products.

La clé reste sur les serveurs de Setherion.

À demander :

• « Affichez mes produits PrestaShop avec leurs photos et leurs prix »
• « Reliez chaque produit à sa page dans ma boutique »

Limites : les produits sont la seule chose qu’une application puisse lire. Les commandes et les clients sont refusés, et les niveaux de stock ne sont pas disponibles, donc l’application n’affiche aucun badge « en stock ». Les prix PrestaShop s’entendent hors taxes, et l’application les présente ainsi. Les acheteurs sont envoyés vers la page du produit dans votre boutique, pas directement vers un panier.