Stripe - Create Invoice

Description

This module allows you to create manual invoices for customers. It can add items, configure the collection method, finalize, and send the invoice automatically.

Configuration

Required Credentials

• Secret Key: Stripe secret key

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Stripe credentials
customer_id	string	Yes	Customer ID (cus_xxx)
items	string	No	Invoice items (JSON array)
collection_method	select	No	Collection method
days_until_due	number	No	Days to pay (default: 30)
description	string	No	Invoice description
footer	string	No	Footer text
finalize	boolean	No	Finalize immediately
send_invoice	boolean	No	Send by email
metadata	string	No	Custom metadata (JSON)

Items Format

[
  {
    "amount": 99.99,
    "currency": "usd",
    "description": "Servicio de consultoría"
  },
  {
    "price_id": "price_xxx",
    "quantity": 2
  }
]

Output

{
  "success": true,
  "invoice": {...},
  "invoice_id": "in_1MtHbELkdIwHu7ixl4OzzPMv",
  "number": "INV-0001",
  "status": "open",
  "amount_due": 99.99,
  "hosted_invoice_url": "https://invoice.stripe.com/...",
  "message": "Factura INV-0001 creada (open)"
}

Usage Example

Simple invoice with automatic collection

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "items": "[{\"amount\": 150, \"description\": \"Servicio mensual\"}]",
  "finalize": true
}

Invoice with multiple items

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "items": "[{\"amount\": 100, \"description\": \"Consultoría\"}, {\"amount\": 50, \"description\": \"Soporte adicional\"}]",
  "description": "Servicios de enero 2024",
  "finalize": true,
  "send_invoice": true
}

Invoice with due date

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "items": "[{\"amount\": 500, \"description\": \"Proyecto X\"}]",
  "collection_method": "send_invoice",
  "days_until_due": 15,
  "footer": "Gracias por su preferencia",
  "finalize": true,
  "send_invoice": true
}

API Used

• Endpoint: POST /v1/invoices, POST /v1/invoiceitems
• Documentation: Stripe Create Invoice

Notes

• Items can be one-time amounts or recurring prices
• finalize: true locks the invoice for editing
• send_invoice: true sends an email to the customer
• Non-finalized invoices are editable drafts
• The customer can pay via hosted_invoice_url

Related Nodes

• StripeGetInvoices - Get and search existing invoices
• StripeGetCustomers - Get customer data
• StripeCreateCustomer - Create the customer before invoicing
• StripeGetSubscriptions - Query associated subscriptions