Card readers
Aperçu
Se connecte à Square. La caisse envoie le montant à un Square Terminal posé sur votre comptoir. Le client approche ou insère sa carte et peut ajouter un pourboire. Le personnel voit ce qui a été encaissé, le pourboire à part, ainsi que la marque de la carte et ses quatre derniers chiffres. Un encaissement se termine encaissé, ou annulé avec le motif donné par Square. Votre boutique est le vendeur : le compte Square, le jeton d’accès et l’argent sont à vous, et Adminium n’est partie à aucun paiement. La carte est lue par le Terminal et va chez Square, si bien qu’aucun numéro de carte n’atteint votre serveur. Un remboursement fait dans Adminium repasse par Square. Un paiement Interac (Canada) ne se rembourse que sur le Terminal, donc Adminium le refuse. Les remboursements et les litiges faits dans le Square Dashboard sont lus eux aussi par Adminium. Il se configure dans Studio → Paiements avec un jeton d’accès de votre propre compte Square : le jeton sandbox pour les paiements de test, le jeton de production pour les paiements réels. Vous jumelez chaque lecteur dans Paiements → Card readers avec un code d’appareil que vous saisissez sur le Terminal. Adminium interroge les lecteurs depuis le serveur, donc un serveur sans adresse publique convient. Square garde un encaissement Terminal pendant 30 jours, et Adminium garde sa propre copie de ce qui a été encaissé. Square n’est pas proposé en Allemagne ; dans ce cas, utilisez plutôt un lecteur Stripe via Card payments. Il n’a ni écrans ni tables à lui, et il fonctionne avec toutes les applications. Il nécessite Adminium 0.3.60 ou plus récent.
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 un jeton d’accès de votre propre compte Square : le jeton sandbox pour les paiements de test, le jeton de production pour les paiements réels. Les deux sont gardés chiffrés sur votre serveur, et aucune partie du module n’atteint jamais un navigateur. Le jeton ouvre tout le compte Square, car Square n’a pas de jeton plus étroit pour une application à vous ; gardez-le dans Studio et nulle part ailleurs, et s’il fuit un jour, créez-en un nouveau dans la Square Developer Console. Il n’apporte aucune table à lui. Sa partie serveur peut appeler les deux adresses ci-dessous, une pour le test et une pour le réel, et rien d’autre.
Adresses que son code serveur peut joindre
- connect.squareupsandbox.com
- connect.squareup.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 4
- Dans Adminium : sa carte sous Studio → Paiements, où vous collez le jeton d’accès du sandbox ou de la production, et « Vérifier » dit de qui est le compte Square
- Dans Adminium : Paiements → Card readers, où « Jumeler un lecteur » donne un nom au lecteur et affiche un code d’appareil à saisir sur le Square Terminal
- À la caisse : le montant part vers le Square Terminal, le client approche ou insère sa carte et peut ajouter un pourboire, et la caisse montre ce qui a été encaissé, le pourboire à part, avec la marque de la carte et ses quatre derniers chiffres ; un encaissement se termine encaissé, ou annulé avec le motif donné par Square
- Remboursements : un remboursement fait dans Adminium repasse par Square, sauf un paiement Interac (Canada), qui ne se rembourse que sur le Terminal ; les remboursements et les litiges faits dans le Square Dashboard apparaissent dans Paiements → Activité
Tables qu’il apporte 0
Aucune — il n’apporte aucune table à lui.
Paramètres que vous configurez 1
- Jeton d'accès
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 déjà encaissé reste enregistré sur sa fiche, avec le pourboire à part, la marque de la carte et ses quatre derniers chiffres. Adminium garde sa propre copie, si bien qu’un paiement se lit encore en totalité après les 30 jours pendant lesquels Square garde un encaissement Terminal. Il n’a apporté aucune table à lui. Votre compte Square et l’argent qu’il contient restent intacts.
Ce qui disparaît
Card readers disparaît de Studio → Paiements, et la caisse ne peut plus envoyer de montant à un Terminal. Les remboursements et les litiges faits dans le Square Dashboard ne sont plus lus. Square ne permet pas de dissocier un Terminal depuis l’extérieur : déconnectez chaque Terminal sur l’appareil lui-même.
À 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.60 ou plus récent), installez Card readers depuis les modules, ouvrez Studio → Paiements et connectez-le avec le jeton d’accès sandbox de votre propre compte Square, pour faire des paiements de test avant d’utiliser le jeton de production. Les lecteurs se jumellent dans Paiements → Card readers.
Adminium n’est pas affilié à cette société.