payments-billing-integration

Integrate payment providers and subscription billing with idempotent financial state transitions.

9|3|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/Sir-chawakorn/sanook-cli --skill payments-billing-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: payments-billing-integration
Source: https://github.com/Sir-chawakorn/sanook-cli/tree/main/skills/payments-billing-integration
Command: npx skills add https://github.com/Sir-chawakorn/sanook-cli --skill payments-billing-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the complexity of managing financial transactions and subscription lifecycles by providing a standardized, idempotent, and audit-ready framework that prevents double-charges and state synchronization errors.

Core Features & Use Cases

  • Idempotent Transactions: Ensures that charges, refunds, and subscription updates are safe to retry without risk of duplication.
  • Webhook Reconciliation: Provides a reliable mechanism to sync local database state with provider events, handling out-of-order delivery and retries.
  • Subscription Lifecycle Management: Automates complex billing scenarios including trials, upgrades, proration, and dunning processes.

Quick Start

Use the payments-billing-integration skill to implement a secure Stripe checkout flow with idempotency keys for all money-mutating operations.

Frequently Asked Questions about payments-billing-integration

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

FAQPage Schema
How do I prevent double-charges when retrying failed Stripe payments?

Webhook reconciliation syncs your local database state with provider events by handling out-of-order delivery and retries. It provides a reliable mechanism to process Stripe or Adyen events sequentially, ensuring your subscription billing system matches the actual payment provider state without synchronization errors.

What is the best way to handle subscription proration and dunning processes?

Handling subscription proration and dunning requires automating the subscription lifecycle to manage trials, upgrades, and failed payment retries. By standardizing these complex billing scenarios into an idempotent framework, the system safely prorates invoices and triggers dunning workflows without state corruption.

Does this payment integration approach work with Adyen and similar platforms?

Yes, this payment integration approach works with Adyen and similar platforms by standardizing the provider integration logic. It requires strict adherence to PCI-offloaded checkout patterns, ensuring sensitive card data never touches your backend while still accurately recording immutable ledger entries for all monetary events.

How do I implement a secure PCI-offloaded checkout flow for subscriptions?

To implement a secure PCI-offloaded checkout flow, you offload the payment form to your provider and use idempotency keys for all backend money-mutating operations. This prevents double-charges and state synchronization errors while ensuring every monetary event is recorded in an immutable ledger.