Paiements

Configurer Square

Acceptez les paiements par carte avec Square dans votre widget de réservation et sur votre page de réservation. Les clients paient par carte, et Apple Pay et Google Pay fonctionnent une fois votre site web enregistré. L'argent arrive directement sur votre propre compte Square. FullClass ne le reçoit ni ne le détient jamais.

Ce que vous obtenez Ce dont vous avez besoin Configuration en bac à sable Tester une réservation Apple Pay et Google Pay Passer en mode réel Clé de signature de webhook Remboursements Cartes cadeaux dans votre comptabilité Dépannage

Ce que vous obtenez

  • Une configuration en un clic, en vous connectant à Square. Il n'y a rien à copier ni à coller, et FullClass renouvelle la connexion pour vous.
  • Un formulaire de carte dans votre widget de réservation. Square le fournit, donc les numéros de carte vont directement chez Square.
  • Apple Pay et Google Pay sur les sites web que vous enregistrez. Vous n'avez aucun fichier à ajouter à votre site.
  • Des remboursements que vous pouvez faire depuis la page de la réservation dans l'administration.
  • En option, la synchronisation des remboursements que vous faites dans Square, pour que la réservation dans FullClass™ se mette aussi à jour. Cela utilise un webhook (voir plus bas).

Ce dont vous avez besoin

  • Un compte Square.
  • L'accès propriétaire à FullClass. Seul le propriétaire peut ouvrir les paramètres de paiement.
  • Environ 15 minutes pour configurer un test, plus une courte réservation de test.

Se connecter avec Square (la méthode simple)

Avec Se connecter avec Square, vous ne copiez rien. FullClass remplit vos informations Square pour vous et choisit Square comme moyen de paiement de vos clients.

  1. Connectez-vous à FullClass en tant que propriétaire et ouvrez Paramètres → Paiements.
  2. Sous Choisissez comment vos clients paient, choisissez Square. Cliquez ensuite sur Se connecter avec Square.
  3. Connectez-vous à Square et autorisez l'accès. Vous revenez sur la page Paiements, qui affiche Square connecté avec succès.
  4. C'est tout. Pour arrêter d'accepter les paiements Square plus tard, cliquez sur Déconnecter sur la même page.
Les renouvellements sont automatiques. En vous connectant à Square, vous donnez à FullClass un accès qu'il renouvelle pour vous. Votre connexion continue de fonctionner et vous n'avez plus jamais rien à saisir. Vous préférez coller vos informations vous-même ? Ouvrez Saisir plutôt les identifiants manuellement et suivez les étapes ci-dessous.
Vous ne voyez pas le bouton ? Utilisez la configuration manuelle ci-dessous. Une fois enregistrée, elle fonctionne exactement de la même façon.

Configuration en bac à sable (à faire en premier)

Le bac à sable (sandbox) est le mode test de Square. Vous pouvez réserver et payer avec des numéros de carte de test, et aucun argent réel ne circule. Testez-y d'abord. Quand tout vous convient, remplacez les informations par vos informations réelles, que Square appelle « production ».

Étape 1. Récupérez vos informations Square

  1. Connectez-vous à developer.squareup.com. C'est le site de Square pour connecter d'autres applications, comme FullClass.
  2. Ouvrez une application existante, ou créez-en une. Ici, une application est simplement une connexion nommée à votre compte Square.
  3. Sous Credentials, copiez l'Application ID (le nom de la connexion) et l'Access token (son mot de passe secret). Les identifiants du bac à sable commencent par sandbox-. Ceux de production commencent par sq0idp-.
  4. Ouvrez Locations dans la même application, ou dans votre tableau de bord Square. Copiez le Location ID du point de vente qui doit recevoir les paiements.
FullClass reconnaît le mode test ou réel pour vous. Il lit le début de l'Application ID pour distinguer le bac à sable de la production. Il n'y a aucun interrupteur à régler. Copiez simplement toutes vos informations depuis le même onglet de Square.

Étape 2. Collez les informations dans FullClass

  1. Connectez-vous à FullClass en tant que propriétaire.
  2. Ouvrez Paramètres → Paiements.
  3. Sous Choisissez comment vos clients paient, choisissez Square. Si vous voyez Se connecter avec Square, ouvrez Saisir plutôt les identifiants manuellement pour accéder aux champs.
  4. Collez l'Application ID dans Identifiant d'application, l'Access token dans Jeton d'accès et le Location ID dans Identifiant d'établissement.
  5. Cliquez sur Enregistrer les modifications. (Vous pouvez ajouter la clé de webhook facultative plus tard, voir plus bas.)
Passer à Stripe plus tard. Une fois Square configuré, vous ne pouvez pas choisir Stripe. Un clic malheureux ne peut donc pas vous faire perdre vos informations Square. Pour passer à Stripe, cliquez d'abord sur Déconnecter. Cela efface vos informations Square enregistrées, puis vous pouvez choisir Stripe. Pour changer vos informations Square, modifiez-les simplement et enregistrez. Vous n'avez pas besoin de vous déconnecter.

Testez une réservation du début à la fin

  1. Ouvrez votre page de réservation, comme le ferait un client.
  2. Choisissez un événement payant et remplissez le formulaire de réservation.
  3. Payez avec une carte de test du bac à sable Square. Square les liste sur sa page cartes de test du bac à sable Square.
  4. Vérifiez que la réservation apparaît dans l'administration, payée par Square, avec un ID de paiement Square.
Le mode test dans FullClass. Tant que vos informations du bac à sable sont enregistrées, FullClass est en mode test. Chaque page de l'administration affiche une bannière Mode test. Votre page de réservation affiche un message indiquant qu'aucun paiement réel ne sera pris. Les deux disparaissent dès que vous enregistrez vos informations de production. Tout ce qui est vendu en mode test reste hors de vos rapports de chiffre d'affaires et des recettes du tableau de bord, même après votre passage en mode réel. Pour en savoir plus, voir Testez des réservations avant de passer en mode réel.

Apple Pay et Google Pay

Square vérifie votre site lui-même, il n'y a donc aucun fichier à y ajouter. Ouvrez Paramètres → Paiements → Domaines de paiement par portefeuille. Trouvez chaque site où apparaît votre widget et cliquez sur Enregistrer.

Pour toutes les étapes et les solutions, voir Apple Pay et Google Pay.

Retirer un site enregistré. Square ne permet pas aux autres applications de retirer un site enregistré. Le supprimer dans FullClass le retire seulement de votre liste. Pour le retirer aussi de Square, contactez l'assistance Square.

Passer en mode réel

  1. Sur developer.squareup.com, passez à l'onglet Production.
  2. Copiez l'Application ID de production (il commence par sq0idp-), l'Access token et le Location ID.
  3. Collez-les dans Paramètres → Paiements dans FullClass et cliquez sur Enregistrer les modifications.
  4. Faites une petite réservation réelle. Puis remboursez-la depuis la page de la réservation, pour vérifier que les paiements et les remboursements fonctionnent.

Clé de signature de webhook (facultative, recommandée)

Un webhook est un message que Square envoie à FullClass quand quelque chose change dans Square. Sans webhook, un remboursement fait dans Square (et non depuis l'administration FullClass) n'apparaîtra pas sur la réservation. La clé de signature de webhook est un secret qui permet à FullClass de vérifier que chaque message vient bien de Square.

  1. Sur developer.squareup.com, ouvrez l'onglet Webhooks de votre application.
  2. Ajoutez un abonnement de webhook qui pointe vers https://votre-domaine-fullclass/webhooks/square.
  3. Abonnez-vous aux événements de remboursement.
  4. Square crée une signature key. Copiez-la.
  5. Collez-la dans le champ Clé de signature de webhook de Paramètres → Paiements dans FullClass.
En mode réel, les messages ont besoin de la clé. En production, FullClass refuse les messages de webhook Square qui ne sont pas signés avec une clé valide. Si vous avez un abonnement de webhook Square activé, vérifiez que sa clé de signature est enregistrée ici.
Vous vous êtes connecté avec Square ? La clé de webhook est séparée de la connexion. Pour que les remboursements faits dans Square reviennent sur vos réservations, vous ajoutez quand même l'abonnement de webhook et collez sa clé de signature ici. Ouvrez Mettre à jour les identifiants manuellement pour trouver le champ. Les paiements et les remboursements que vous faites dans FullClass fonctionnent sans elle.

Remboursements

  • Remboursez depuis la page de la réservation dans l'administration. Vous pouvez rembourser le montant total ou une partie.
  • Si vous avez aussi configuré le webhook ci-dessus, les remboursements que vous faites dans Square (par exemple depuis le tableau de bord Square) mettent à jour la réservation automatiquement.

Un remboursement fait depuis FullClass arrive dans Square comme une somme d'argent, et non comme le retour des articles vendus. C'est parce que Square ne permet pas aux autres applications de retourner des articles un par un. Si Square se synchronise avec QuickBooks Online, le remboursement est enregistré sur l'article Square sales item sans taxe, quelle que soit la vente d'origine. Demandez à votre comptable de corriger ces remboursements comme suit.

  • Remboursements de cartes cadeaux (une carte avec un solde en argent) : déplacez le montant des revenus de ventes vers votre compte de passif des cartes cadeaux, où la vente a été enregistrée.
  • Autres remboursements (réservations, carnets de séances, événements privés) : déplacez la taxe comprise dans le remboursement des revenus de ventes vers votre compte de taxes de vente à payer.

Chaque remboursement dans QuickBooks Online porte la description de la vente d'origine, comme Gift card purchase ou le numéro de réservation. Utilisez-la pour les retrouver.

Cartes cadeaux dans votre comptabilité

Une carte cadeau vendue avec Square arrive dans Square comme une vente d'un seul article. Votre comptabilité peut ainsi la distinguer des revenus de cours.

  • Gift card : une carte avec un solde en argent, sans taxe. La taxe est perçue plus tard, quand la carte paie un cours.
  • Class pass : un carnet pour un nombre de cours. Il porte la taxe que vous avez réglée pour les carnets de séances dans vos paramètres de cartes cadeaux.

Si Square se synchronise avec QuickBooks Online, associez l'article Gift card à votre compte de passif des cartes cadeaux, et non aux revenus de ventes. Les cartes non utilisées ne sont alors pas comptées comme revenus.

Une carte cadeau remboursée ne suit pas cette association. Voir Remboursements pour la correction à faire.

Dépannage

Le formulaire de carte n'apparaît pas
Vérifiez que Square est choisi sous Choisissez comment vos clients paient, et que les trois informations sont enregistrées. L'Application ID décide du mode test ou réel. Un Access token venant de l'autre onglet fera donc échouer la vérification de la carte.
La vérification de la carte échoue
L'Application ID et l'Access token doivent venir du même onglet de Square (Sandbox ou Production). Vous ne pouvez pas les mélanger.
Le bouton Apple Pay manque sur un site enregistré
Vérifiez le navigateur du client. Apple Pay demande Safari sur un Mac, un iPhone ou un iPad. Google Pay demande Chrome avec une carte de paiement configurée. Vérifiez aussi que le site affiche Enregistré sous Domaines de paiement par portefeuille.
Un remboursement fait dans Square n'a pas mis à jour la réservation
Il vous faut un abonnement de webhook dans Square et une clé de signature enregistrée dans FullClass. Voir Clé de signature de webhook.

Voir aussi Dépannage → Le paiement échoue.

← Retour àEncaisser les paiements
Centre d'aide FullClass · Configurer Square