WorqHat
Utility

Stripe Payments

Category
Utility
Node Type
Stripe Integration

Overview

The Stripe Payments node creates checkout sessions and manages payments. Use it to accept payments, generate checkout URLs, and capture payment metadata for e-commerce or subscription flows.

Description

Accept payments via Stripe.

This node communicates with Stripe to create a checkout session.

One-Time Payment

Sell products or services.

Subscription

Start recurring billing plans.

It supports customer references, success/cancel URLs, payment mode, and line items.

Input Parameters

Configure the checkout session.

customerIdTypestringRequired
'id' or 'email'.
Example
"email"
customerIdstringOptional
Stripe Customer ID (if type is 'id').
customerEmailstringOptional
Customer Email (if type is 'email').
paymentModestringRequired
'payment', 'subscription', or 'setup'.
Example
"payment"
lineItemsstringRequired
JSON-encoded array of items (price, quantity).
Example
"[{\"price\":\"price_123\",\"quantity\":1}]"
successUrlstringRequired
Redirect URL after success.
Example
"https://example.com/success"
cancelUrlstringRequired
Redirect URL after cancellation.
Example
"https://example.com/cancel"

Output Parameters

The node returns the session details.

checkout_session_urlstringOptional
URL to redirect the user to.
idstringOptional
Session ID.
payment_statusstringOptional
'paid', 'unpaid', or 'no_payment_required'.
amount_totalnumberOptional
Total amount in smallest currency unit.

Output Type

Output Type: JSON

Returns the checkout session object.

Example Usage

Example 1: Create Checkout Session

Generate a payment link for a product.

{  "customerIdType": "email",  "customerEmail": "jane@example.com",  "paymentMode": "payment",  "successUrl": "https://example.com/success",  "cancelUrl": "https://example.com/cancel",  "lineItems": "[{\"price\":\"price_123\",\"quantity\":1}]"}
{  "checkout_session_url": "https://checkout.stripe.com/c/session_abc",  "id": "cs_test_123",  "status": "open",  "payment_status": "unpaid"}

How to Use in a No-Code Workflow

1

Add the Node

Place the Stripe Payments node in your workflow.

2

Configure Customer

Choose email or id and provide the value.

3

Add Items

Provide lineItems as a JSON string (e.g., [{"price": "...", "quantity": 1}]).

4

Redirect

Use the checkout_session_url output to redirect the user to the payment page.

Best Practices

  • Use HTTPS URLs for success and cancel pages.
  • Use metadata to track order IDs from your system.

Do / Don’t

Do
  • ✔️ Handle webhooks to confirm payment completion (async).
  • ✔️ Test with Stripe's test card numbers.
Don’t
  • ❌ Don’t assume payment is successful just because the session was created.
  • ❌ Don’t hardcode prices if they change frequently (use dynamic inputs).

Common Errors

Missing lineItemsErrorOptional
Line items array is empty or invalid JSON.
Invalid customer referenceErrorOptional
Customer ID or Email is missing/incorrect.

Example Workflow Integration

Use Case: Premium Subscription Checkout

Direct user to payment page for a subscription.

  1. User Selects Plan: User clicks "Upgrade".
  2. Stripe Payments: Create session with mode: subscription.
  3. Redirect: Send user to the returned checkout_session_url.

Workflow Data Flow:

{{plan.priceId}} → {{stripePayment.lineItems}}
{{stripePayment.checkout_session_url}} → {{redirect.url}}