Stripe Setup for Openclaw

A comprehensive skill for integrating Stripe checkout sessions, subscription billing, and automated webhook handling into Python-based web applications.

ferrentinomj-dev
v1.0.0
Apr 9, 2026
0
691
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install stripe-setup

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install stripe-setup using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Stripe Setup?

The Stripe Setup skill provides a robust framework for adding professional-grade payment processing to any application built by an AI agent. It bridges the gap between raw code and a functional financial system by covering every critical touchpoint: from creating products in the dashboard to handling real-time billing events via webhooks. This Openclaw Skills resource ensures that even developers with no prior fintech experience can implement secure, scalable payment flows.

By following this structured approach, users can deploy features like one-time payments, recurring subscriptions, and a self-service customer portal. The skill focuses on technical best practices, such as webhook signature verification and idempotency, to ensure that payment data remains consistent and secure across the entire application lifecycle.

Stripe Setup Use Cases

  • Launching a SaaS product with monthly or annual recurring subscription plans.
  • Selling digital goods or services through one-time checkout sessions.
  • Automating user access provisioning and revocation based on real-time payment status.
  • Providing a self-service billing area where users can manage cards and cancel plans.
  • Testing complex billing logic safely using Stripe test-mode before going live.

How Stripe Setup Works

  1. Product Definition: The user defines products and price points either through the Stripe Dashboard or programmatically via the API to obtain a Price ID.
  2. Session Initiation: The application generates a secure Stripe-hosted Checkout URL, redirecting the user to a conversion-optimized payment page.
  3. Event Monitoring: A dedicated webhook endpoint listens for asynchronous events from Stripe, such as successful payments or subscription cancellations.
  4. Fulfillment Logic: The backend processes these events to update the local database, granting or removing user access as required.
  5. Self-Service Management: Users are provided with a secure link to the Stripe Billing Portal to manage their own financial data without custom frontend development.

Stripe Setup Setup

First, ensure you have your API keys from the Stripe Dashboard. Install the necessary dependencies:

pip install stripe python-dotenv

Create a .env file in your project root with the following variables:

STRIPE_SECRET_KEY=sk_test_...
STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
STRIPE_PRICE_ID=price_...

Stripe Setup Data Schema & Taxonomy

The skill relies on a mix of environment variables and database fields to track the payment state. Below is the recommended mapping for your user table:

Field Type Description
stripe_customer_id String The unique ID assigned to the user by Stripe.
stripe_sub_id String The ID of the user's active subscription.
is_active Boolean Flag to gate access to premium features.
plan_status String Stores states like active, past_due, or canceled.

Stripe Setup Advanced Features

  • Idempotency Checks: Prevents duplicate fulfillment by tracking and storing processed Stripe event IDs.
  • Multi-Mode Support: Seamlessly transition between test and live environments with a comprehensive pre-flight checklist.
  • Grace Period Handling: Logic to manage past_due status, allowing users a window to update payment methods before revoking access.
  • Stripe CLI Integration: Full support for local webhook forwarding to accelerate development and debugging cycles.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*