Stripe - Crear Cliente

Descripcion

Este módulo permite registrar nuevos clientes en Stripe con sus datos de contacto, dirección y opcionalmente un método de pago asociado.

Configuración

Credenciales Requeridas

• Secret Key: Clave secreta de Stripe

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Stripe
email	string	No	Email del cliente
name	string	No	Nombre completo
phone	string	No	Teléfono
description	string	No	Descripción interna
payment_method	string	No	ID del método de pago (pm_xxx)
address_line1	string	No	Dirección línea 1
address_city	string	No	Ciudad
address_state	string	No	Estado/Provincia
address_postal_code	string	No	Código postal
address_country	string	No	Código de país (US, MX, ES)
metadata	string	No	JSON con metadatos personalizados

Salida

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

Ejemplo de Uso

Crear cliente básico

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

Crear cliente con dirección

{
  "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"
}

Crear cliente con metadatos

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

API Utilizada

• Endpoint: POST /v1/customers
• Documentación: Stripe Create Customer

Notas

• El email no es obligatorio pero se recomienda para recibos
• Los metadatos permiten almacenar información personalizada
• Los codigos de pais deben ser ISO 3166-1 alfa-2

Nodos relacionados

• StripeGetCustomers - Obtener y buscar clientes existentes
• StripeUpdateCustomer - Actualizar datos de un cliente existente
• StripeCreateSubscription - Crear suscripciones para el cliente
• StripeCreatePaymentIntent - Crear pagos para el cliente
• StripeCreateInvoice - Crear facturas para el cliente