Stripe · Create an invoice — An invoice with items, sent to the customer to pay — makes an invoice in Stripe, adds each item, and sends it. Stripe emails the customer a link to pay it.

Who can do this

Workspace Admins and Editors, on every plan. Viewers see the step's settings but cannot change them.

Before you start

Steps

  1. Select +. In the step picker, open Apps, select Stripe, then Create an invoice.
  2. In Connection, choose your Stripe connection.
  3. In Customer, the customer's id — The customer's id — from Find a customer or Create a customer. For example {{ steps.find_a_customer.id }}.
  4. Under Items, select Add a field for each item — its name on the left, its amount on the right — Each item and its amount, in the currency's main unit. For example Consulting, October and 1499.00.
  5. In Currency, leave ₹ Indian rupee or choose another.
  6. Optional: Description, shown on the invoice.
  7. Send it is on by default. Switch it off to leave the invoice a draft — Off: it stays a draft in Stripe.
  8. In Days to pay, how long the customer has — 15 by default.
  9. Select Run this step.

Output

Field What it is
id Stripe's id for the invoice — starts in_.
status open once sent; draft when Send it is off.
number The invoice number, once it is sent.
hostedUrl The page where the customer pays it, once it is sent.
amountDue, amountDueMain, amountDueText The total — 149900, 1499, ₹ 1,499.00.
currency inr, as Stripe writes it.

What happens next

  • With Send it on, Stripe finalises the invoice and emails it to the customer's email in Stripe. Stripe does not move money; the customer pays by the link.
  • When it is paid, Stripe sends Invoice paid — see Start a workflow from Stripe payment events.
  • A draft stays in Stripe for you to check and send from the Stripe Dashboard.

Good to know

  • Item names must differ. Two items with the same name become one — the last. A name cannot contain a colon.
  • Each item is one line with its own amount, quantity one.
  • The customer needs an email in Stripe for Stripe to send the invoice.
  • Runs once per item that reaches it. Ten items make ten invoices.

If something goes wrong

What you see Why What to do
Customer is empty when the step ran — … Customer reads a value that came out empty — perhaps Find a customer found nobody. Check found first, or create the customer.
Items is empty — add each item and its amount. No item has a name. Add at least one item.
The amount for Consulting, October “…” is not an amount — write it in rupees, like 1499.00. An item's amount has no number in it. Type a number for that item.
Stripe refused: … Stripe would not make or send it, in its own words — no such customer, a customer with no email, a currency the customer cannot be billed in. Fix what it names.