payments

name: payments description: > Payment and subscription patterns for The Boring JavaScript Stack — sails-pay hook with Lemon Squeezy, checkout flows, subscription management, webhooks, and customer portal. Use this skill when implementing billing, subscriptions, or payment processing in a Sails.js application. metadata: author: sailscastshq version: '1.0.0' tags: payments, billing, subscriptions, lemon-squeezy, sails-pay, checkout, webhooks, boring-stack

The Boring JavaScript Stack uses sails-pay with Lemon Squeezy as the payment provider. The Ascent templates include a complete billing system with plan-based subscriptions, checkout flows, webhook handling, and customer portal integration.

When to Use

Use this skill when:

Configuring sails-pay in config/pay.js (provider, plans, variants)
Implementing checkout flows with sails.pay.checkout()
Managing subscriptions (Subscription model, status lifecycle)
Handling Lemon Squeezy webhooks (signature verification, event processing)
Building billing settings pages with plan information
Checking subscription status with the checkPlan helper
Integrating Lemon Squeezy's hosted customer portal

Rules

Read individual rule files for detailed explanations and code examples:

rules/getting-started.md - sails-pay hook, config/pay.js, Lemon Squeezy setup, Subscription model
rules/checkout.md - Checkout flow, sails.pay.checkout(), variant selection, custom data
rules/subscriptions.md - Subscription model, status management, checkPlan helper, billing page
rules/webhooks.md - Webhook controller, signature verification, event handling, idempotency
rules/customer-portal.md - Lemon Squeezy hosted portal, subscription management URLs