Stripe - Obtener Clientes

Descripcion

Este módulo permite consultar los clientes registrados en Stripe. Puede obtener un cliente específico por ID o listar clientes con filtros de email y fechas.

Configuración

Credenciales Requeridas

• Secret Key: Clave secreta de Stripe (sk_live_… o sk_test_…)

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Stripe
customer_id	string	No	ID del cliente (cus_xxx)
email	string	No	Filtrar por email exacto
created_gte	string	No	Creado después de (timestamp Unix)
created_lte	string	No	Creado antes de (timestamp Unix)
limit	number	No	Límite de resultados (default: 10, max: 100)
starting_after	string	No	ID del último objeto para paginación

Salida

{
  "success": true,
  "customers": [...],
  "count": 10,
  "has_more": true,
  "message": "10 clientes obtenidos"
}

Campos de Cliente

• id: ID del cliente (cus_xxx)
• email: Email
• name: Nombre
• phone: Teléfono
• description: Descripción
• created: Fecha de creación (timestamp)
• default_source: Fuente de pago por defecto
• invoice_settings: Configuración de facturas
• metadata: Metadatos personalizados

Ejemplo de Uso

Obtener cliente por ID

{
  "customer_id": "cus_NffrFeUfNV2Hib"
}

Buscar por email

{
  "email": "cliente@email.com"
}

Clientes del último mes

{
  "created_gte": "1704067200",
  "limit": 50
}

API Utilizada

• Endpoint: GET /v1/customers y GET /v1/customers/{id}
• Documentación: Stripe Customers API

Notas

• Los timestamps deben estar en formato Unix (segundos desde epoch)
• La paginación usa cursor-based con starting_after
• El limite maximo por pagina es 100 clientes

Nodos relacionados

• StripeCreateCustomer - Crear nuevos clientes
• StripeUpdateCustomer - Actualizar datos de un cliente existente
• StripeCreateSubscription - Crear suscripciones para el cliente
• StripeCreatePaymentIntent - Crear pagos para el cliente
• StripeGetInvoices - Obtener facturas del cliente