Stripe, Twilio & SDK Patterns

import Stripe from "stripe";
 
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
  apiVersion: "2024-11-20.acacia",
  timeout: 10_000,
  maxNetworkRetries: 0,
});
 
const intent = await stripe.paymentIntents.create(
  { amount: 2500, currency: "usd", automatic_payment_methods: { enabled: true } },
  { idempotencyKey: req.header("Idempotency-Key") ?? undefined }
);

// src/integrations/payments-service.ts
import Stripe from "stripe";
import twilio from "twilio";
 
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
  apiVersion: "2024-11-20.acacia",
  timeout: 10_000,
  maxNetworkRetries: 0,
});
 
const twilioClient = twilio(process.env.TWILIO_ACCOUNT_SID!, process.env.TWILIO_AUTH_TOKEN!);
 
export async function createPaymentIntent(
  amountCents: number,
  currency: string,
  idempotencyKey: string
) {
  return stripe.paymentIntents.create(
    { amount: amountCents, currency, automatic_payment_methods: { enabled: true } },
    { idempotencyKey }
  );
}
 
export async function sendOtpSms(to: string, code: string) {
  return twilioClient.messages.create({
    to,
    from: process.env.TWILIO_FROM_NUMBER!,
    body: `Your code is ${code}`,
    statusCallback: `${process.env.PUBLIC_API_URL}/webhooks/twilio/sms`,
  });
}
 
// Express route
app.post("/payments/intent", async (req, res, next) => {
  try {
    const key = req.header("Idempotency-Key");
    if (!key) return res.status(400).json({ error: "missing_idempotency_key" });
    const pi = await createPaymentIntent(req.body.amountCents, "usd", key);
    res.status(201).json({ clientSecret: pi.client_secret, id: pi.id });
  } catch (err) {
    next(mapStripeError(err));
  }
});

// Retrieve with expand - use sparingly
const sub = await stripe.subscriptions.retrieve(id, { expand: ["customer", "latest_invoice"] });

// Verify caller on inbound - TwiML webhook
app.post("/voice/inbound", express.urlencoded({ extended: false }), (req, res) => {
  const twiml = new twilio.twiml.VoiceResponse();
  twiml.say("Hello");
  res.type("text/xml").send(twiml.toString());
});

# Stripe test card 4242 4242 4242 4242
STRIPE_SECRET_KEY=sk_test_...
 
# Twilio magic numbers for SMS test