Display cart details

The built-in screen of the Verifone P400, BBPOS WisePOS E and Stripe Reader S700 can display line items. During the checkout process, you can update the reader’s screen to show individual items in the transaction, along with the total price.

Cart details screen

Set the reader display

To set the line items and total displayed on the reader during a payment, pass line items and total information into the setReaderDisplay method. The object you pass drives the contents displayed on the reader’s screen.

The amounts passed to the setReaderDisplay method are only used for display purposes. The reader won’t automatically calculate tax or the total—your application must calculate the tax and total before displaying the values. You can use the Stripe Tax API to calculate taxes. Similarly, the total passed to setReaderDisplay doesn’t control the amount charged to the customer. Make sure the amount displayed on the reader matches the amount you’re charging your customer.

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/set_reader_display \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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

Pre-dip a card

The Verifone P400, BBPOS WisePOS E, and Stripe Reader S700 support the ability to present a card to the reader before the transaction amount is finalized.

This option—known as pre-dip, pre-tap, or pre-swipe—can help speed up transaction times by allowing a customer to present a payment method before the end of the transaction.

The setReaderDisplay method prepares the reader for pre-dipping. Your customer can present a payment method at any point after this method is called. You can call setReaderDisplay multiple times to update the information displayed without impacting the pre-dipping process. Updating the display doesn’t invalidate a pre-dip, if one has already occurred.

Pre-dipping only allows your customer to present a card early in the payment process, it doesn’t move the payment process forward. Your integration can’t tell if pre-dipping has occurred, and you must implement the full payment flow for all transactions, regardless of pre-dipping.

Pre-dip disabled

If pre-dip isn’t available in your country, the screen shows only the subtotal and line items.

Pre-dip disabled