How to use Stripe Terminal for in-person payments

1// server.js
2const express = require('express');
3const Stripe = require('stripe');
4const stripe = Stripe(process.env.STRIPE_SECRET_KEY);
5const app = express();
6app.use(express.json());
7
8app.post('/api/connection-token', async (req, res) => {
9  try {
10    const token = await stripe.terminal.connectionTokens.create();
11    res.json({ secret: token.secret });
12  } catch (err) {
13    res.status(500).json({ error: err.message });
14  }
15});
16
17app.listen(3001);

1const terminal = StripeTerminal.create({
2  onFetchConnectionToken: async () => {
3    const res = await fetch('/api/connection-token', { method: 'POST' });
4    const data = await res.json();
5    return data.secret;
6  },
7  onUnexpectedReaderDisconnect: () => {
8    console.log('Reader disconnected unexpectedly');
9  }
10});

1const discoverResult = await terminal.discoverReaders({
2  simulated: false  // set to true for testing without a physical reader
3});
4
5if (discoverResult.error) {
6  console.error('Discovery failed:', discoverResult.error);
7} else {
8  const reader = discoverResult.discoveredReaders[0];
9  const connectResult = await terminal.connectReader(reader);
10  if (connectResult.error) {
11    console.error('Connection failed:', connectResult.error);
12  } else {
13    console.log('Connected to:', connectResult.reader.label);
14  }
15}

1// Server: create PaymentIntent
2app.post('/api/create-terminal-intent', async (req, res) => {
3  const intent = await stripe.paymentIntents.create({
4    amount: req.body.amount,  // in cents
5    currency: 'usd',
6    payment_method_types: ['card_present'],
7    capture_method: 'manual'  // optional: authorize first, capture later
8  });
9  res.json({ client_secret: intent.client_secret });
10});
11
12// Client: collect payment
13const res = await fetch('/api/create-terminal-intent', {
14  method: 'POST',
15  headers: { 'Content-Type': 'application/json' },
16  body: JSON.stringify({ amount: 2000 })
17});
18const { client_secret } = await res.json();
19
20const collectResult = await terminal.collectPaymentMethod(client_secret);
21if (collectResult.error) {
22  console.error('Collection failed:', collectResult.error);
23} else {
24  const confirmResult = await terminal.confirmPaymentIntent(collectResult.paymentIntent);
25  if (confirmResult.error) {
26    console.error('Confirmation failed:', confirmResult.error);
27  } else {
28    console.log('Payment succeeded:', confirmResult.paymentIntent.id);
29  }
30}