Skip to content
Nappai Documentation

Stripe Customer

Stripe Customer manages the customers in your Stripe account. A Stripe customer stores the contact details of a person or a company and is the starting point for their cards, invoices and subscriptions. From a flow you can create them, look them up, change their details or delete them.

When to use it

  • Someone signs up on your website or buys for the first time and you want to create them as a customer in Stripe.
  • You receive an email from a customer and want to find them in Stripe by their email address.
  • A customer changes their phone or name in your CRM and you want to update it in Stripe too.
  • You want to delete from Stripe the customers who asked to leave.

Configuration

You need a Stripe API credential with the secret key of your Stripe account. See Credentials.

FieldWhat it does
Credential (required)The Stripe API credential of your account.
Operation (required)The action the component performs. Defaults to Create. See Operations.
Get ModeOnly in Get. By ID looks up one customer; All returns the list of customers. Defaults to By ID.
Customer IDThe customer’s identifier in Stripe (starts with cus_). Required in Get with By ID, Update and Delete.
NameThe customer’s full name. In Create and Update.
EmailThe customer’s email address. In Create and Update. In Get with All, returns only the customers with that email.
PhoneThe customer’s phone number. In Create and Update.
DescriptionFree text saved with the customer, for example where they came from. In Create and Update.
LimitOnly in Get with All. Maximum number of customers returned, between 1 and 100. Defaults to 100.

In Update only the fields you fill in are changed; empty ones stay as they were.

Operations

  • Create: creates a new customer with the details you fill in.
  • Delete: deletes a customer from Stripe.
  • Get: with By ID returns one customer; with All returns the list of customers, filtered by email if you give one.
  • Update: changes the details of an existing customer.

Output

The Data output returns the customer that was created, looked up, updated or deleted. With Get and All, it returns one item per customer. Each item includes the customer’s identifier, which you will need in the other Stripe components to charge, invoice or subscribe them.

You can connect it to Stripe Subscription, Stripe Invoice or to your CRM to store the identifier. The component can also be connected to an Agent as a tool, so the agent decides when to use it. See Tool Mode.

Example

A gym creates a Stripe customer for every member who signs up on its website.

  1. The sign-up form reaches the flow with the member’s name, email and phone.
  2. Add Stripe Customer with Operation set to Create and pass those values to Name, Email and Phone.
  3. In Description, write “Web sign-up”.
  4. Connect the Data output to Stripe Subscription to subscribe the member to the monthly fee.

Good practices

  • Before creating a customer, look them up with Get in All mode and their email so you do not create duplicates.
  • Store the Stripe identifier in your CRM or customer sheet: you will need it for any later operation.