How to use Stripe API with Node.js

1# Create project and install dependencies
2mkdir stripe-node-app && cd stripe-node-app
3npm init -y
4npm install stripe express dotenv

1// .env
2// STRIPE_SECRET_KEY=sk_test_your_key_here
3// STRIPE_PUBLISHABLE_KEY=pk_test_your_key_here
4// STRIPE_WEBHOOK_SECRET=whsec_your_secret_here
5
6// server.js
7require('dotenv').config();
8
9const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY, {
10  apiVersion: '2024-12-18.acacia',
11  maxNetworkRetries: 2,
12});
13
14const express = require('express');
15const app = express();
16
17console.log('Stripe initialized. API version:', stripe.getApiField('version'));

1app.use(express.json());
2
3app.post('/api/customers', async (req, res) => {
4  try {
5    const customer = await stripe.customers.create({
6      email: req.body.email,
7      name: req.body.name,
8      metadata: {
9        app_user_id: req.body.userId,
10      },
11    });
12    res.json({ customerId: customer.id, email: customer.email });
13  } catch (err) {
14    res.status(400).json({ error: err.message });
15  }
16});

1app.post('/api/create-payment-intent', async (req, res) => {
2  try {
3    const { amount, customerId } = req.body;
4
5    const paymentIntent = await stripe.paymentIntents.create({
6      amount: amount, // Amount in cents (e.g., 2500 = $25.00)
7      currency: 'usd',
8      customer: customerId,
9      automatic_payment_methods: { enabled: true },
10      metadata: {
11        order_id: req.body.orderId,
12      },
13    });
14
15    res.json({
16      clientSecret: paymentIntent.client_secret,
17      paymentIntentId: paymentIntent.id,
18    });
19  } catch (err) {
20    res.status(400).json({ error: err.message });
21  }
22});
23
24// Test with: curl -X POST http://localhost:3000/api/create-payment-intent \
25//   -H 'Content-Type: application/json' \
26//   -d '{"amount": 2500, "orderId": "order_123"}'

1async function handleStripeError(err, res) {
2  switch (err.type) {
3    case 'StripeCardError':
4      // Card was declined
5      res.status(402).json({
6        error: err.message,
7        code: err.code, // e.g., 'card_declined', 'expired_card'
8        decline_code: err.decline_code,
9      });
10      break;
11    case 'StripeRateLimitError':
12      res.status(429).json({ error: 'Too many requests. Please retry.' });
13      break;
14    case 'StripeInvalidRequestError':
15      res.status(400).json({ error: err.message });
16      break;
17    case 'StripeAuthenticationError':
18      console.error('Invalid API key!');
19      res.status(500).json({ error: 'Payment service configuration error.' });
20      break;
21    case 'StripeAPIError':
22      res.status(500).json({ error: 'Payment service temporarily unavailable.' });
23      break;
24    default:
25      res.status(500).json({ error: 'An unexpected error occurred.' });
26  }
27}

1app.post('/webhook',
2  express.raw({ type: 'application/json' }),
3  (req, res) => {
4    const sig = req.headers['stripe-signature'];
5    let event;
6    try {
7      event = stripe.webhooks.constructEvent(
8        req.body,
9        sig,
10        process.env.STRIPE_WEBHOOK_SECRET
11      );
12    } catch (err) {
13      return res.status(400).send(`Webhook Error: ${err.message}`);
14    }
15
16    if (event.type === 'payment_intent.succeeded') {
17      console.log('Payment confirmed:', event.data.object.id);
18    }
19
20    res.json({ received: true });
21  }
22);
23
24app.listen(3000, () => console.log('Stripe server running on port 3000'));