Collecter des pourboires à l'encaissement

Certains types d’entreprises permettent aux clients d’ajouter un pourboire à une transaction une fois la carte autorisée. Outre-Atlantique, cette possibilité est très répandue dans l’hôtellerie et la restauration (par exemple un restaurant ou un bar) afin que le client rajoute un pourboire sur le reçu.

Aux États-Unis, suite à la confirmation d’un PaymentIntent, vous pouvez collecter un pourboire en capturant une somme supérieure au montant autorisé. Il s’agit d’une surcapture. Une fois que vous avez capturé le PaymentIntent, votre client voit le montant total capturé sur son relevé.

Pour collecter un pourboire, créez et confirmez un PaymentIntent en définissant capture_method sur manual. Pour déterminer l’éligibilité à la surcapture, développez la propriété latest_charge du PaymentIntent et inspectez sa propriété overcapture_supported.

curl -G https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=latest_charge

Ensuite, associez le paramètre capture à un montant supérieur au montant autorisé en fournissant un paramètre amount_to_capture égal à la somme du PaymentIntent et du montant du pourboire confirmés.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=1800

La surcapture met à jour le montant du PaymentIntent afin de refléter le nouveau total, avec les éventuels pourboires. Cela n’aboutit pas à une autorisation supplémentaire, de sorte que votre client ne verra pas immédiatement les mises à jour sur ses relevés de carte bancaire. Pour voir le montant autorisé d’origine, utilisez le champ amount_authorized de l’objet sous-jacent Charge du PaymentIntent.

Limites

Vous pouvez capturer jusqu’à 50 % de plus que le montant amount autorisé du PaymentIntent, ou 50 USD, selon le montant le plus élevé. Par exemple, si le amount autorisé de votre PaymentIntent est de 40 USD, vous pouvez capturer jusqu’à 90 USD ; si le amount s’élève à 100 USD, vous pouvez capturer jusqu’à 150 USD.

Si vous devez capturer un montant supérieur aux limites autorisées, voici les deux options qui s’offrent à vous :

• Si votre MCC est éligible, vous pouvez avoir recours à une autorisation complémentaire pour augmenter le paramètre amount du PaymentIntent.
• Vous pouvez créer un nouveau PaymentIntent pour capturer le montant du pourboire à l’aide du moyen de paiement generated_card du premier PaymentIntent.

Disponibilité

La fonction de pourboires sur le reçu est disponible pour les entreprises aux États-Unis dont les codes de catégorie d’activité (Merchant Category Code ou MCC) sont éligibles, pour les paiements effectués à l’aide des cartes bancaires Visa, Mastercard, Discover et American Express.

Les entreprises appartenant aux catégories suivantes peuvent collecter des pourboires en effectuant une surcapture :

• Taxis et limousines
• Lieux de restauration et restaurants
• Lieux servant des boissons (alcoolisées)
• Restaurants de fast-food
• Coiffeurs pour hommes et instituts de beauté
• Salons de beauté et de bien-être