Lien de paiement

À quoi sert cet écran. Laisser un joueur payer sa part lui-même, par carte, depuis le lien que vous lui envoyez : c’est la page qu’il ouvre sur son téléphone ou son ordinateur.

Créer le lien

1. Ouvrez la réservation sur le planning : en bas, dépliez À régler (ou ouvrez Encaisser).
2. Sur la part du joueur, encore « À régler », cliquez sur Lien de paiement. Il faut un client nommé, avec un e-mail ou un téléphone : un passage se règle à l’accueil.
3. Le lien s’affiche sous la part. Il est copié dans le presse-papiers quand le navigateur le permet (« Lien copié, à envoyer au joueur ») ; sinon, sélectionnez-le dans le champ (« Lien à envoyer au joueur »).
4. Envoyez-le au joueur par le canal de votre choix.

Un lien correspond à une part : redemander le lien d’une part déjà en attente redonne le même lien, sans créer de seconde commande. Quand la commande de la part est créée pour un membre, le club lui envoie aussi le message « Lien de paiement de part », sauf si vous l’avez désactivé dans les réglages des notifications.

Ce que voit le joueur

• La page porte les couleurs, le logo et les mentions du club, puis donne le libellé de la part (terrain, date, heure) et le montant restant.
• Payer par carte l’emmène sur la page de paiement sécurisée ; le bouton passe à « Redirection… » pour éviter un double envoi. S’il revient en arrière, le bouton redevient utilisable.
• Une part déjà réglée affiche « Déjà réglé. Merci. » à la place du bouton.
• Si le paiement en ligne n’est pas encore activé pour le club, la page « Paiement impossible » l’explique (« Le paiement en ligne n’est pas encore activé pour ce club. Réglez à l’accueil. ») avec un lien Revenir au paiement.

Le retour après paiement

Après le paiement, le joueur revient sur la page Merci. Le paiement est enregistré quand le prestataire de paiement le confirme au club, quelques secondes plus tard. La page ne dit « Paiement reçu » qu’à ce moment-là : en attendant, elle affiche « Paiement en cours de confirmation… » et se met à jour toute seule. Si la confirmation tarde plus de deux minutes, elle le dit et propose de revenir au paiement. Une fois confirmé, la part passe à « Payé · CB en ligne » dans l’encaissement et le paiement apparaît dans la caisse du jour.

Les états de l’écran

• Lien inconnu : « Lien invalide. Ce lien de paiement n’existe pas. Demandez un nouveau lien à l’accueil du club. »

• Déjà réglé : le montant et « Déjà réglé. Merci. », sans bouton.
• Paiement indisponible : « Paiement impossible », avec la raison et Revenir au paiement.
• Trop de tentatives : « Un instant. Trop de tentatives de paiement. Réessayez dans une minute. », avec Revenir au paiement. Le bouton est limité à 10 essais par minute pour un même lien.
• Cas normal : le montant et un seul bouton, Payer par carte.
• Part annulée : si la réservation a changé et que la part n’est plus due, la page le dit (« Cette part n’est plus à régler : la réservation a changé. ») ; un paiement arrivé quand même apparaît dans À rembourser de la caisse.
• Retour de paiement : « Paiement en cours de confirmation… » puis « Paiement reçu. Le club l’a bien enregistré. » ; si rien n’arrive en deux minutes, « La confirmation prend plus de temps que prévu. » ; sans JavaScript, la page invite à la recharger.

Voir aussi

• Le parcours Encaisser et clôturer.
• Les notions : lien de paiement, part, commande et paiement, messages.

Pour les développeurs

• La page est servie par l’API (/pay/<orderId>, puis /pay/<orderId>/merci, qui interroge /pay/<orderId>/statut), pas par l’application d’accueil.
• bo stripe listen relaie les événements Stripe en mode test vers le webhook de ce worktree (/webhooks/stripe), qui enregistre le paiement.
• bo mail last --to <email> montre le message « Lien de paiement de part » reçu dans la boîte de développement.
• bo ui shots refait les captures de cette page.