Afficher les détails du panier
Mettez dynamiquement à jour les détails du panier sur l'écran du lecteur.
L’écran intégré des terminaux Stripe Reader S700/S710 et BBPOS WisePOS E peut afficher des articles. Pendant le processus de paiement, vous pouvez mettre à jour l’écran du lecteur pour afficher les articles individuels de la transaction, ainsi que le prix total.
Écran de détail du panier
Configurer l’affichage du lecteur
Pour afficher les postes de facture et le total sur le lecteur, appelez setReaderDisplay avant de traiter le paiement et transmettez les informations dans le paramètre cart.
Les montants transmis à la méthode setReaderDisplay sont exclusivement destinés à l’affichage. Le lecteur ne calcule pas automatiquement les taxes ou le montant total : votre application doit effectuer ces calculs avant que les valeurs ne soient affichées. Vous pouvez utiliser l’API Stripe Tax pour calculer le montant des taxes. De même, le total transmis à setReaderDisplay ne correspond pas nécessairement au montant facturé au client. Il convient donc de s’assurer que le montant indiqué sur le lecteur correspond bien à celui facturé au client.
curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/set_reader_display \ -u ":" \ -d type=cart \ -d "cart[line_items][0][description]=Caramel latte" \ -d "cart[line_items][0][amount]=659" \ -d "cart[line_items][0][quantity]=1" \ -d "cart[line_items][1][description]=Dozen donuts" \ -d "cart[line_items][1][amount]=1239" \ -d "cart[line_items][1][quantity]=1" \ -d "cart[currency]=usd" \ -d "cart[tax]=100" \ -d "cart[total]=1998"sk_test_VePHdqKTYQjKNInc7u56JBrQ
Pour effacer l’affichage du lecteur sur l’intégration pilotée par serveur, appelez l’endpoint cancel_action.
Pré-insérer une carte
Remarque
La pré-insertion d’une carte n’est prise en charge que pour les paiements effectués aux États-Unis.
Les terminaux Stripe Reader S700/S710 et BBPOS WisePOS E permettent de présenter une carte au lecteur avant que le montant de la transaction ne soit finalisé.
Cette option est connue sous le nom de pre-dip, pre-tap ou pre-swipe, et peut aider à accélérer les délais de transaction en permettant à un client de présenter un moyen de paiement avant la fin de la transaction.
La méthode setReaderDisplay prépare le lecteur pour la préinsertion de la carte. Une fois que vous avez appelé cette méthode, votre client peut présenter un moyen de paiement à tout moment. Vous pouvez appeler setReaderDisplay plusieurs fois pour mettre à jour les informations affichées sans affecter le processus de préinsertion. La mise à jour de l’affichage n’invalide pas la préinsertion, si elle a déjà eu lieu.
Le pré-trempage permet à votre client de présenter une carte dès le début du processus de paiement sans effectuer la transaction associée. Le lecteur enregistre alors le moyen de paiement présenté et le sauvegarde pour une utilisation ultérieure, bien que Stripe ne fournisse aucune mise à jour ni aucun événement indiquant que le client a pré-trempé sa carte. Vous pouvez traiter la transaction normalement. Par exemple, vous pouvez créer et traiter une PaymentIntent pour effectuer la transaction sans traitement particulier.
Pré-insertion désactivée
Si la pré-insertion n’est pas disponible dans votre pays, l’écran n’affiche que le sous-total et les postes de facture.
Pré-insertion désactivée