How to customize invoice branding in Stripe

1require('dotenv').config();
2const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);
3
4async function createBrandedInvoice(customerId, items, options = {}) {
5  // Add invoice items
6  for (const item of items) {
7    await stripe.invoiceItems.create({
8      customer: customerId,
9      amount: item.amount,
10      currency: item.currency || 'usd',
11      description: item.description,
12    });
13  }
14
15  // Create invoice with branding customizations
16  const invoice = await stripe.invoices.create({
17    customer: customerId,
18    collection_method: 'send_invoice',
19    days_until_due: options.daysUntilDue || 30,
20    description: options.memo || '',
21    footer: options.footer || 'Thank you for your business!',
22    custom_fields: options.customFields || [],
23    metadata: options.metadata || {},
24  });
25
26  // Finalize and send
27  await stripe.invoices.finalizeInvoice(invoice.id);
28  const sent = await stripe.invoices.sendInvoice(invoice.id);
29
30  return {
31    id: sent.id,
32    number: sent.number,
33    hosted_url: sent.hosted_invoice_url,
34    pdf_url: sent.invoice_pdf,
35  };
36}
37
38// Example usage
39createBrandedInvoice('cus_abc123', [
40  { amount: 50000, description: 'Consulting — 10 hours @ $50/hr' },
41  { amount: 15000, description: 'Report preparation and delivery' },
42], {
43  memo: 'March 2026 consulting engagement',
44  footer: 'Net 30. Questions? Contact billing@yourcompany.com',
45  customFields: [
46    { name: 'PO Number', value: 'PO-2026-0042' },
47    { name: 'Department', value: 'Engineering' },
48  ],
49  metadata: { engagement_id: 'ENG-2026-03' },
50}).then(console.log).catch(console.error);