Wallet payments
Aperçu
Se connecte à PayPal. Vos clients paient une facture, ou toute fiche portant un montant, avec leur compte PayPal, sur la page PayPal. Le client y approuve le paiement puis revient ; Adminium encaisse alors l’argent (PayPal appelle cela une capture) et l’enregistre une fois sur la fiche. Si le client ne revient jamais, le webhook ou la vérification d’Adminium l’encaisse à sa place, et un paiement que PayPal retient apparaît « en cours », avec la raison donnée par PayPal. Votre boutique est le vendeur : il lui faut son propre compte PayPal Business, et l’argent va directement du client à ce compte. Adminium ne détient aucun compte de paiement, aucun identifiant à lui et aucun argent, et ne traite rien ; rien de ce que le client saisit sur la page PayPal n’atteint votre serveur. Il se configure dans Studio → Paiements, dans la sandbox d’abord : une app REST avec son ID client et son secret, et un webhook par mode, puis un paiement test en tant qu’acheteur sandbox, qui n’écrit rien dans vos tables. Les remboursements se font depuis le panneau Paiement d’une fiche ou depuis Activité, et un remboursement fait dans le tableau de bord PayPal est lui aussi enregistré. Un paiement contesté est suivi jusqu’à ce que PayPal tranche le litige ; vous y répondez dans le tableau de bord PayPal. Il propose un seul moyen de paiement, le compte PayPal du client, et accepte les 24 devises que PayPal accepte, HUF, JPY et TWD en unités entières seulement. Il nécessite Adminium 0.3.33 ou plus récent, sur une adresse https publique au port 443, où PayPal envoie ses webhooks.
Ce à quoi il se greffe
Celui-ci n’est lié à aucune application en particulier. Il fonctionne dans Adminium même, et dans toute application qui accueille des modules.
Ce que la connexion lui permet de faire
Il lui faut une app REST de votre propre compte PayPal Business, une pour la sandbox et une pour le mode en direct : son ID client, son secret et l’ID de son webhook. Le secret ouvre tout le compte PayPal — PayPal n’a pas de clé plus restreinte —, c’est pourquoi les trois sont gardés chiffrés sur votre serveur, mode par mode, et aucune partie du module n’atteint jamais un navigateur. La signature de chaque webhook est vérifiée sur votre serveur avec l’ID du webhook. Les paiements ne sont écrits que sur les lignes des tables que vous choisissez sous « Ce qui peut être payé ». Sa partie serveur peut appeler les six adresses ci-dessous, et rien d’autre.
Adresses que son code serveur peut joindre
- api-m.paypal.com
- api-m.sandbox.paypal.com
- www.paypal.com
- www.sandbox.paypal.com
- api.paypal.com
- api.sandbox.paypal.com
Cette liste est la liste complète : tout appel vers une autre adresse est refusé et consigné.
Ce qu’il faut pour la connexion
Une clé d’API
Ce qu’il ajoute
Où il apparaît 3
- Dans Adminium : sa carte sous Studio → Paiements → Configuration, avec la liste App sandbox, Webhook sandbox, Envoyer un paiement test, App en direct, Webhook en direct, Premier paiement réel reçu
- Sur la page de paiement d’une fiche : « Payer avec PayPal », qui envoie le client sur la page PayPal
- Dans le panneau Paiement d’une fiche et dans Activité : les paiements qu’il a encaissés, avec leurs remboursements et leurs litiges
Tables qu’il apporte 0
Aucune — il n’apporte aucune table à lui.
Paramètres que vous configurez 3
- ID client
- Secret
- ID du webhook
Si vous le désactivez
La déconnexion retire les écrans du module. Elle ne supprime jamais les tables qu’il a créées, ni les fichiers qu’il a écrits, ni les lignes qu’il a ajoutées — tout ce qu’il a écrit reste dans votre base de données. Les identifiants qui lui avaient été confiés sont révoqués et supprimés avec lui.
Ce qui reste
Chaque paiement et chaque remboursement déjà enregistrés restent : sur leur fiche, dans Activité et dans votre propre table de paiements si vous en avez choisi une. Il n’a apporté aucune table à lui. Les moyens de paiement manuels et l’enregistrement d’un paiement à la main fonctionnent comme avant, et votre compte PayPal et l’argent qu’il contient restent intacts.
Ce qui disparaît
« Déconnecter » sur sa carte propose deux issues. Arrêter les nouveaux paiements : aucun nouveau paiement ne démarre, et Adminium garde les identifiants pour terminer les paiements en attente et rembourser. Supprimer les clés : les identifiants sont effacés de ce serveur, et Adminium ne peut plus terminer un paiement ni rembourser via PayPal. Les supprimer ici ne les annule pas chez PayPal ; par précaution, créez un nouveau secret pour l’app dans le tableau de bord développeur PayPal.
À propos de la démo
Aucune démo de ce site n’appelle réellement le service d’une autre société. Chaque module embarque un transport de remplacement qui répond à partir de données intégrées, et il est actif d’emblée. Les véritables identifiants relèvent de l’auto-hébergement et sont décrits dans le README du module.
Comment l’activer Aucune des démos de ce site ne l’inclut. Dans votre propre Adminium (0.3.33 ou plus récent), installez Wallet payments depuis les modules, ouvrez Studio → Paiements et suivez la liste de contrôle de sa carte, dans la sandbox d’abord. Chaque page de paiement de test propose aussi le service de démonstration, qui ne demande aucun compte : tout le parcours, remboursements compris, peut être essayé avant de connecter quoi que ce soit.
Adminium n’est pas affilié à cette société.