Collecter des pourboires

Découvrez les différentes manières de collecter les pourboires de vos clients.

Utilisez Terminal pour collecter les pourboires de vos clients avant ou après l’autorisation d’un paiement. Pour collecter des pourboires à la discrétion des clients, deux options s’offrent à vous :

Pourboire sur le reçu : les pourboires sont collectés lorsque le paiement est capturé. Cette méthode est le plus souvent utilisée pour collecter des pourboires sur des reçus papier.
Pourboire sur le lecteur : le lecteur de cartes suggère des pourboires aux clients avant d’encaisser le paiement.

Pour les pourboires obligatoires, vous devez inclure le montant du pourboire dans le montant du PaymentIntent initial. Vous ne pouvez pas utiliser le pourboire sur le reçu ou sur le lecteur.

Pourboires sur le reçu ou sur le lecteur

Le tableau ci-dessous présente quelques différences dans le traitement des pourboires selon qu’ils apparaissent sur le reçu ou sur le lecteur.

	Pourboires sur le lecteur	Pourboires sur le reçu
Pays	BBPOS WisePad 3 : Disponible dans les pays suivants : Lecteur S700 et BBPOS WisePOS E de Stripe : Disponible dans les pays suivants :
Lecteur	BBPOS WisePad 3 BBPOS WisePOS E Lecteur Stripe S700	Tous
Intégrations/SDK	BBPOS WisePad 3 : SDK Android SDK iOS SDK React Native BBPOS WisePOS E et lecteur Stripe S700 : Tous les SDK pilotés par le serveur	Tous les SDK pilotés par le serveur
Catégorie de marchand	Tous	Limité
Marque de carte bancaire	Tous	Visa, Mastercard, American Express, Discover
Limite des pourboires	Montant de facturation maximum pour le montant total, pourboire compris, qui est de huit ou neuf chiffres selon la devise	Montant de facturation maximum pour le montant total, pourboire compris.
Expérience client	Suggestions de pourboire sur le lecteur	Pourboires définis par une intégration personnalisée au point de vente ou sur un reçu papier
Relevé de carte bancaire du client	Affiche le montant du paiement, pourboire compris, sans attendre le règlement	Affiche une autorisation initiale en attente qui est ensuite mise à jour pour refléter le montant initial, pourboire compris

Affichage du pourboire sur le reçu et sur le lecteur

Les pourboires sur reçu comme sur lecteur utilisent l’API PaymentIntents, fonctionnent avec tous les SDK Terminal et nécessitent une capture manuelle.

Mise en garde

Choisissez une seule méthode de pourboire par PaymentIntent. Si vous utilisez le pourboire sur lecteur, vous ne pouvez pas utiliser le même PaymentIntent pour un pourboire sur reçu.

Le tableau ci-dessous résume le comportement particulier de l’API.

Pourboires sur le lecteur Pourboires sur le reçu

Les pourboires dans la requête API Le lecteur ajoute automatiquement le pourboire sélectionné par le client au moment du traitement du paiement. Vous ajoutez le montant du pourboire et vous transmettez le montant total à capturer, amount_to_capture, lorsque vous capturez un PaymentIntent. Le champ amount_to_capture comprend le pourboire.

Pourboires et montant dans la réponse de l’API L’objet amount_details apparaît dans la réponse de l’API lors du traitement d’un paiement. Le montant du pourboire est renvoyé dans l’objet amount_details. Les pourboires ne sont pas directement représentés, mais peuvent être dérivés de l’objet Charge. Le montant amount dans la réponse de capture du PaymentIntent comprend le pourboire.

	Pourboires sur le lecteur	Pourboires sur le reçu
Les pourboires dans la requête API	Le lecteur ajoute automatiquement le pourboire sélectionné par le client au moment du traitement du paiement.	Vous ajoutez le montant du pourboire et vous transmettez le montant total à capturer, amount_to_capture, lorsque vous capturez un PaymentIntent. Le champ `amount_to_capture` comprend le pourboire.
Pourboires et montant dans la réponse de l’API	L’objet amount_details apparaît dans la réponse de l’API lors du traitement d’un paiement. Le montant du pourboire est renvoyé dans l’objet `amount_details`.	Les pourboires ne sont pas directement représentés, mais peuvent être dérivés de l’objet Charge. Le montant `amount` dans la réponse de capture du `PaymentIntent` comprend le pourboire.
Pourboires dans l’object `Charge` sous-jacent	Les pourboires ne sont pas directement représentés dans l’objet `Charge`. Après la capture, les champs ci-dessous affichent tous la même valeur, avec le pourboire compris. amount amount_authorized amount_captured	Les pourboires peuvent être dérivés de l’objet `Charge`. Vous pouvez dériver le pourboire en soustrayant `amount_authorized` de `amount`. `amount_authorized` est le montant initial autorisé, sans le pourboire. `amount_captured` et `amount` sont identiques et incluent tous les deux le pourboire.

Pourboires dans l’object Charge sous-jacent

Les pourboires ne sont pas directement représentés dans l’objet Charge.

Après la capture, les champs ci-dessous affichent tous la même valeur, avec le pourboire compris.

Les pourboires peuvent être dérivés de l’objet Charge. Vous pouvez dériver le pourboire en soustrayant amount_authorized de amount.

amount_authorized est le montant initial autorisé, sans le pourboire.
amount_captured et amount sont identiques et incluent tous les deux le pourboire.