Stripe - Create Customer

Description

This module allows you to register new customers in Stripe with their contact information, address, and optionally an associated payment method.

Configuration

Required Credentials

• Secret Key: Stripe secret key

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Stripe credentials
email	string	No	Customer email
name	string	No	Full name
phone	string	No	Phone number
description	string	No	Internal description
payment_method	string	No	Payment method ID (pm_xxx)
address_line1	string	No	Address line 1
address_city	string	No	City
address_state	string	No	State/Province
address_postal_code	string	No	Postal code
address_country	string	No	Country code (US, MX, ES)
metadata	string	No	JSON with custom metadata

Output

{
  "success": true,
  "customer": {...},
  "customer_id": "cus_NffrFeUfNV2Hib",
  "email": "cliente@email.com",
  "message": "Cliente cus_NffrFeUfNV2Hib creado correctamente"
}

Usage Example

Create basic customer

{
  "email": "juan@email.com",
  "name": "Juan Pérez"
}

Create customer with address

{
  "email": "maria@email.com",
  "name": "María García",
  "phone": "+52 55 1234 5678",
  "address_line1": "Av. Reforma 123",
  "address_city": "Ciudad de México",
  "address_state": "CDMX",
  "address_postal_code": "06600",
  "address_country": "MX"
}

Create customer with metadata

{
  "email": "empresa@cliente.com",
  "name": "Empresa ABC",
  "metadata": "{\"company_id\": \"12345\", \"plan\": \"enterprise\"}"
}

API Used

• Endpoint: POST /v1/customers
• Documentation: Stripe Create Customer

Notes

• Email is not required but recommended for receipts
• Metadata allows storing custom information
• Country codes must be ISO 3166-1 alpha-2

Related Nodes

• StripeGetCustomers - Get and search existing customers
• StripeUpdateCustomer - Update an existing customer’s data
• StripeCreateSubscription - Create subscriptions for the customer
• StripeCreatePaymentIntent - Create payments for the customer
• StripeCreateInvoice - Create invoices for the customer