WorqHat
Utility

Stripe Customer

Category
Utility
Node Type
Stripe Integration

Overview

The Stripe Customer node manages customer records in Stripe. Use it to create, update, or retrieve customer details as part of your workflow, enabling seamless billing and subscription management.

Description

Manage Stripe customers.

This node connects to Stripe to perform customer-related operations.

Create

Add a new customer to Stripe.

Update

Modify existing customer details.

Retrieve

Fetch customer data by ID.

Input Parameters

Configure the customer operation.

operationTypestringRequired
'create', 'update', or 'retrieve'.
Example
"create"
customerIdstringOptional
Required for 'update' and 'retrieve'.
Example
"cus_12345"
namestringOptional
Customer full name.
Example
"Jane Doe"
emailstringOptional
Customer email address.
Example
"jane@example.com"
phonestringOptional
Phone number.
metadatastringOptional
JSON-encoded key-value pairs.
Example
"{\"segment\":\"pro\"}"

Output Parameters

The node returns the Stripe customer object.

idstringOptional
Stripe Customer ID.
emailstringOptional
Customer email.
namestringOptional
Customer name.
creatednumberOptional
Creation timestamp.
[address_fields]stringOptional
City, country, line1, etc.

Output Type

Output Type: JSON

Returns the full customer object from Stripe.

Example Usage

Example 1: Create Customer

Register a new user in Stripe.

{  "operationType": "create",  "name": "Jane Doe",  "email": "jane@example.com",  "metadata": "{\"segment\":\"pro\"}"}
{  "id": "cus_12345",  "email": "jane@example.com",  "name": "Jane Doe",  "created": 1698576000}

How to Use in a No-Code Workflow

1

Add the Node

Place the Stripe Customer node in your workflow.

2

Select Operation

Choose create, update, or retrieve.

3

Map Inputs

Provide email, name, or customerId based on the operation.

4

Use ID

Save the returned id to your database for future reference.

Best Practices

  • Store the Stripe Customer ID in your own database.
  • Use metadata to link Stripe customers to your internal user IDs.

Do / Don’t

Do
  • ✔️ Validate email addresses before creating customers.
  • ✔️ Update customer details when they change in your app.
Don’t
  • ❌ Don’t create duplicate customers for the same user.
  • ❌ Don’t store raw credit card info (let Stripe handle it).

Common Errors

Missing customerIdErrorOptional
Required for update/retrieve operations.
Invalid address JSONErrorOptional
Address or metadata JSON string is malformed.

Example Workflow Integration

Use Case: New Subscriber Registration

Create a Stripe customer when a user signs up.

  1. Signup Form: User submits details.
  2. Stripe Customer: Create new customer with email.
  3. Database Update: Save the Stripe Customer ID.

Workflow Data Flow:

{{form.email}} → {{stripeCustomer.email}}
{{stripeCustomer.id}} → {{db.user.stripeId}}