Stripe - Create Payment Intent

Description

This module creates a Payment Intent, Stripe’s central object for handling payments. It allows you to configure the amount, currency, customer, payment method, and capture options.

Configuration

Required Credentials

• Secret Key: Stripe secret key

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Stripe credentials
amount	number	Yes	Amount in currency units (e.g.: 99.99)
currency	string	No	Currency code (default: usd)
customer_id	string	No	Customer ID
payment_method	string	No	Payment method ID
confirm	boolean	No	Confirm immediately
payment_method_types	string	No	Allowed types (default: card)
description	string	No	Payment description
receipt_email	string	No	Email to send receipt
statement_descriptor	string	No	Statement descriptor text (max 22 chars)
capture_method	select	No	automatic or manual
metadata	string	No	Custom metadata (JSON)

Output

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

Payment Intent Statuses

• requires_payment_method: Needs a payment method
• requires_confirmation: Needs confirmation
• requires_action: Requires customer action (3DS)
• processing: Processing
• succeeded: Successful
• canceled: Canceled

Usage Example

Create simple payment

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

Create payment for existing customer

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

Payment with manual capture

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

API Used

• Endpoint: POST /v1/payment_intents
• Documentation: Stripe Payment Intents

Notes

• The amount is automatically converted to cents
• For 3D Secure payments, the customer needs to complete authentication
• client_secret is used on the frontend to confirm the payment
• Manual capture allows authorizing first and capturing later

Related Nodes

• StripeGetPaymentIntents - Get and search existing Payment Intents
• StripeCreateRefund - Create refunds for completed payments
• StripeGetCustomers - Get payment customer data
• StripeCreateCustomer - Create the customer before charging