software-payments
Installation
SKILL.md
Payments & Billing Engineering
Use this skill to design, implement, and debug production payment integrations: checkout flows, subscription lifecycle handling, billing portals, entitlement gating, webhooks, regional pricing, and payment-testing strategy.
Quick Reference
| Need | Default | Deviation | Reference |
|---|---|---|---|
| Standard SaaS subscription checkout | Stripe Checkout or Payment Links | Use Payment Element plus Express Checkout Element when branded custom UI is a hard requirement | references/stripe-patterns.md |
| Merchant of record (managed tax/seller-of-record) | Paddle or LemonSqueezy | Evaluate Stripe Managed Payments after checking seller location, product tax codes, account eligibility and supported surfaces at its eligibility page | references/platform-comparison.md |
| High-volume or enterprise multi-method processing | Adyen | — | references/platform-comparison.md |
| UK or EU bank debit and local methods | GoCardless, Mollie, or open-banking providers | Repo-dependent: no bundle source differentiates the three by situation; keep whichever the existing integration already uses | references/uk-eu-payments-guide.md |
| Usage-based metering or token billing | Stripe Billing Meters or Lago | — | references/subscription-lifecycle.md |
| Complex contract, seat, or revenue-recognition billing | Chargebee or Recurly on top of the processor | — | references/subscription-lifecycle.md |
| Webhook reliability | verified signatures plus idempotent processing | — | references/webhook-reliability-patterns.md |
| Entitlement and feature gating | registry plus API enforcement plus UI paywall | — | references/feature-gating-patterns.md |
| Native iOS in-app purchase | StoreKit 2 with backend JWS verification | Add RevenueCat only when multi-platform entitlement sync materially justifies it | references/storekit2-native-patterns.md |
| Checkout and webhook testing | Stripe CLI plus E2E automation | — | references/testing-patterns.md |
| AI agents initiating purchases | Scoped, limited-use payment credential plus seller-side approval | Human confirmation for high-risk actions | references/agentic-commerce.md |