Stripe - Crear Payment Intent

↩ Parte de la integración Stripe.

Descripción

Este módulo crea un Payment Intent, el objeto central de Stripe para manejar pagos. Permite configurar el monto, moneda, cliente, método de pago y opciones de captura.

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
amount	number	Sí	Monto en unidades de moneda (ej: 99.99)
currency	string	No	Código de moneda (default: usd)
customer_id	string	No	ID del cliente
payment_method	string	No	ID del método de pago
confirm	boolean	No	Confirmar inmediatamente
payment_method_types	string	No	Tipos permitidos (default: card)
description	string	No	Descripción del pago
receipt_email	string	No	Email para enviar recibo
statement_descriptor	string	No	Texto en estado de cuenta (max 22 chars)
capture_method	select	No	automatic o manual
metadata	string	No	Metadatos personalizados (JSON)

Salida

{
  "success": true,
  "payment_intent": {...},
  "payment_intent_id": "pi_3MtwBwLkdIwHu7ix28a3tqPa",
  "client_secret": "pi_3MtwBw..._secret_YrKJUK...",
  "status": "requires_payment_method",
  "amount": 99.99,
  "currency": "usd",
  "message": "PaymentIntent pi_3MtwBw... creado (requires_payment_method)"
}

Estados del Payment Intent

• requires_payment_method: Necesita método de pago
• requires_confirmation: Necesita confirmación
• requires_action: Requiere acción del cliente (3DS)
• processing: Procesando
• succeeded: Exitoso
• canceled: Cancelado

Ejemplo de Uso

Crear pago simple

{
  "amount": 99.99,
  "currency": "usd"
}

Crear pago para cliente existente

{
  "amount": 150.00,
  "currency": "mxn",
  "customer_id": "cus_NffrFeUfNV2Hib",
  "payment_method": "pm_1234567890",
  "confirm": true
}

Pago con captura manual

{
  "amount": 500.00,
  "currency": "eur",
  "customer_id": "cus_NffrFeUfNV2Hib",
  "capture_method": "manual",
  "description": "Reserva de hotel",
  "metadata": "{\"booking_id\": \"HTL-12345\"}"
}

API Utilizada

• Endpoint: POST /v1/payment_intents
• Documentación: Stripe Payment Intents

Notas

• El monto se convierte automáticamente a centavos
• Para pagos 3D Secure, el cliente necesita completar la autenticación
• client_secret se usa en el frontend para confirmar el pago
• La captura manual permite autorizar primero y capturar después

Nodos relacionados

• StripeGetPaymentIntents - Obtener y buscar Payment Intents existentes
• StripeCreateRefund - Crear reembolsos para pagos realizados
• StripeGetCustomers - Obtener datos del cliente del pago
• StripeCreateCustomer - Crear el cliente antes de cobrar