Collecter des pourboires avec le lecteur

Grâce à la fonctionnalité d’affichage des pourboires sur le lecteur, vous pouvez proposer différents montants de pourboire à vos clients avant qu’ils ne sélectionnent leur moyen de paiement. Le lecteur affiche automatiquement trois suggestions en fonction de l’option de pourboire que vous avez configurée chaque fois que vous vous apprêtez à encaisser un paiement. Lorsque vous confirmez le paiement, le PaymentIntent est confirmé pour un montant incluant le pourboire sélectionné.

Écran de paiement

Écran de sélection des pourboires (pourcentage)

Écran Total

Écran Approuvé

**Lecteurs **: Lecteur Stripe S700, BBPOS WisePOS E, BBPOS WisePad 3

Activer et personnaliser les pourboires au lecteur

Utilisez un objet Configuration afin de définir la configuration des pourboires pour votre lecteur :

• Suggérer des pourboires intelligents — le lecteur affiche de façon dynamique trois pourcentages ou montants, en fonction du montant avant pourboire.
• Suggérer des pourcentages — le lecteur affiche trois pourcentages de pourboires.
• Proposer des montants — le lecteur affiche trois montants de pourboire.

Pour utiliser la fonction de pourboires intégrée de votre lecteur BBPOS WisePad 3, vous devez utiliser l’une des versions du SDK Terminal suivantes :

• Android SDK 2.8.1 ou version ultérieure
• SDK iOS 2.16.1 ou version ultérieure

curl https://api.stripe.com/v1/terminal/configurations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "tipping[usd][percentages][]"=15 \
  -d "tipping[usd][percentages][]"=20 \
  -d "tipping[usd][percentages][]"=25 \
  -d "tipping[usd][fixed_amounts][]"=100 \
  -d "tipping[usd][fixed_amounts][]"=200 \
  -d "tipping[usd][fixed_amounts][]"=300 \
  -d "tipping[usd][smart_tip_threshold]"=1000

Si vous spécifiez plusieurs devises dans votre objet Configuration, vous devez fournir les mêmes clés de configuration pour chacune d’entre elles. Autrement dit, si vous spécifiez uniquement percentages pour la devise USD, vous ne pouvez pas spécifier fixed_amounts ou smart_tip_threshold pour d’autres devises.

Après avoir créé un objet Configuration avec votre configuration de pourboire, vous pouvez assigner la configuration à votre compte ou à un emplacement. Les lecteurs BBPOS WisePad 3 reçoivent les configurations nouvelles ou mises à jour lorsqu’ils se connectent à votre application POS. Les lecteurs BBPOS WisePOS E peuvent prendre jusqu’à 5 minutes pour recevoir des configurations nouvelles ou mises à jour.

Encaisser le paiement

Pour le versement de pourboires via un lecteur, suivez les instructions d’encaissement des paiements.

Lorsque vous collectez un moyen de paiement, un écran de sélection de pourboire est présenté au client sur le lecteur. Il est alors invité à sélectionner un pourboire avant de choisir son moyen de paiement.

Selon votre configuration des pourboires, le client peut choisir un pourboire suggéré, spécifier un pourboire personnalisé ou n’en laisser aucun.

Une fois que le client a fait son choix, le lecteur attend qu’il présente une carte bancaire.

Lorsque vous traitez le paiement, le lecteur ajoute le pourboire sélectionné. Si le paiement aboutit, le montant indiqué dans PaymentIntent et Charge est mis à jour pour inclure le montant du pourboire.

Avant une confirmation PaymentIntent, le montant du pourboire est renvoyé dans le champ amount_tip mais pas dans le amount. Après la confirmation PaymentIntent, le champ amount_tip est défini sur zéro, amount inclut le montant du pourboire qui est ensuite renvoyé dans l’objet amount_details :

Aucun écran de sélection des pourboires n’est présenté aux clients dans les cas suivants :

1. Aucune configuration de pourboire n’a été définie pour l’objet Configuration.
2. Vous avez activé skipTipping dans votre configuration des pourboires.
3. Le lecteur se trouve dans un pays qui n’est pas pris en charge.
4. Vous ne pouvez pas appliquer de configuration de pourboire à la devise de paiement actuellement sélectionnée (par exemple, si le paiement est en EUR mais que la configuration de l’objet Configuration ne prend en charge que les paiements en USD).

Lorsque vous testez des paiements avec le lecteur Stripe, le montant total (avec les éventuels pourboires) peut déclencher des réponses de refus en fonction de sa valeur décimale.

Ignorer les pourboires

Vous pouvez ignorer la configuration des pourboires, ce qui vous permet de masquer l’écran de sélection des pourboires sur votre lecteur lors de l’encaissement des paiements.

Vous pouvez masquer l’écran de sélection des pourboires pour des transactions spécifiques ou temporairement pour toutes les transactions, ce qui permet à vos clients d’accéder directement à l’écran de présentation de la carte.

Pour votre restaurant, par exemple, il peut s’avérer plus judicieux d’accepter les pourboires sur le lecteur pour les commandes à emporter, mais de n’autoriser que les pourboires à l’encaissement pour les clients sur place.

Utilisez l’une des options suivantes pour contourner l’écran de sélection de pourboire :

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent="<payment_intent>" \
  -d "process_config[skip_tipping]"=true

Montants admissibles à un pourboire

Lorsque vous encaissez un paiement, vous pouvez définir un montant admissible à un pourboire différent du montant du pourboire anticipé. Définir un montant admissible à un pourboire modifie la valeur à partir de laquelle un pourcentage est calculé en guise de pourboire. Sur l’écran de sélection du pourboire, le client voit également le montant admissible au pourboire ainsi que le montant avant pourboire.

Ce paramètre est utile pour les entreprises qui fournissent des services en plus de la vente de biens. Par exemple, dans le cas d’un salon proposant des services de coiffure et commercialisant des bouteilles de shampoing, il peut être utile d’informer la clientèle que le calcul des pourboires se fait uniquement sur un pourcentage du tarif des coupes de cheveux.

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent="<payment_intent>" \
  -d "process_config[tipping][amount_eligible]"=1500

L’exemple ci-dessus définit un montant admissible à un pourboire en fonction de la devise du paiement. Pour un paiement en USD, le montant admissible à un pourboire est de 15 USD.

La valeur de eligible_amount doit être supérieure ou égale à 0. Si eligible_amount est égal à 0, le pourboire est ignoré, quelle que soit la valeur de skip_tipping. Si eligible_amount est égal au montant prévu du Paymentintent, eligible_amount est ignoré, et le pourboire est calculé en fonction du montant spécifié.