billing

Integrate Stripe payments with webhook signature verification and idempotent event processing.

4|2|Updated Sep 17, 2025
One-click install
npx skills add https://github.com/SylphxAI/flow --skill billing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: billing
Source: https://github.com/SylphxAI/flow/tree/main/.claude/skills/billing
Command: npx skills add https://github.com/SylphxAI/flow --skill billing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Billing is the backbone of trusted financial flows in modern apps. This skill provides a robust blueprint for integrating Stripe payments, validating webhook signatures, and ensuring idempotent event handling to prevent duplicate charges.

Core Features & Use Cases

  • Stripe integration: Set up secure payment flows for subscriptions and one-time charges.
  • Webhook verification: Validate Stripe webhook signatures to prevent spoofed events.
  • Idempotent processing: Use Stripe event IDs to avoid duplicate charges across retries.
  • Operational resilience: Handle out-of-order events and reconcile state with Stripe to ensure server-truth.

Quick Start

Configure a Stripe-based billing workflow with webhook signature verification and idempotent processing.

Frequently Asked Questions about billing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Stripe webhook signatures to prevent spoofed payments?

Webhook signature verification confirms that incoming Stripe events are authentic by validating a cryptographic signature included in each request. This prevents malicious actors from forging fake payment events. The Skill implements signature validation using Stripe's provided signing secret and verification methods to ensure only legitimate Stripe webhooks trigger billing logic.

Why do I need idempotent processing for billing webhooks?

Stripe webhooks can be retried if delivery fails, meaning the same event may arrive multiple times. Idempotent processing uses Stripe event IDs to detect and skip duplicate events, preventing accidental duplicate charges. This ensures your billing system processes each payment exactly once regardless of how many times the webhook is received.

How do I handle out-of-order Stripe events in my billing system?

Out-of-order events occur when webhooks arrive in a different sequence than they were sent, potentially causing state inconsistencies. This Skill handles out-of-order delivery by reconciling your server state with Stripe's source-of-truth data, ensuring your billing records stay accurate even when events arrive out of sequence.

Can I use webhooks to automate both subscriptions and one-time charges?

Yes, Stripe webhooks support both subscription and one-time charge workflows. This Skill provides a unified webhook integration that orchestrates secure, reliable billing for both payment types, validating signatures and ensuring idempotent processing across subscription renewals and individual transactions.

What's the best way to set up secure payment flows with Stripe?

Secure Stripe integration requires webhook signature verification, idempotent event handling, and reconciliation with Stripe's server truth to prevent duplicate or lost charges. This Skill provides a complete blueprint combining all three mechanisms to create a resilient billing orchestration that maintains financial accuracy across subscriptions and one-time payments.