Agent skill
autumn-add-payments
Skill for adding Stripe checkout and payment flows using Autumn.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/autumn-add-payments
SKILL.md
Autumn Payments
Always consult docs.useautumn.com for code examples and latest API.
Autumn handles Stripe checkout, upgrades, downgrades, and cancellations automatically.
Quick Reference
Payment Flow
checkout- Returns Stripe URL (new) or preview data (returning customer)attach- Confirms purchase when card already on file
Checkout Result
| Field | Description |
|---|---|
url |
Stripe checkout URL (null if card on file) |
product |
Target product with scenario |
current_product |
Customer's current product |
lines |
Invoice line items |
total |
Amount in major currency units |
currency |
Currency code |
Product Scenarios
| Scenario | Meaning | Action |
|---|---|---|
new |
Not subscribed | Subscribe |
active |
Current plan | Current Plan |
scheduled |
Scheduled | Already Scheduled |
upgrade |
Higher tier | Upgrade |
downgrade |
Lower tier | Downgrade |
renew |
Cancelled | Renew |
React Implementation
tsx
import { useCustomer, usePricingTable } from "autumn-js/react";
const { checkout, attach } = useCustomer();
const { products } = usePricingTable();
// Checkout flow
const data = await checkout({ productId: "pro" });
if (data.url) {
window.location.href = data.url; // New customer
} else {
// Show confirmation dialog, then:
await attach({ productId: "pro" });
}
// Cancel
const { cancel } = useCustomer();
await cancel({ productId: "pro" });
// Or downgrade to free:
await attach({ productId: "free" });
Backend Implementation
typescript
import { Autumn } from "autumn-js";
const autumn = new Autumn({ secretKey: process.env.AUTUMN_SECRET_KEY });
// Checkout
const { data } = await autumn.checkout({ customer_id, product_id: "pro" });
if (data.url) return redirect(data.url);
// Attach (after user confirms)
await autumn.attach({ customer_id, product_id: "pro" });
// Get products with scenarios
const { data: productsData } = await autumn.products.list({ customer_id });
Prepaid Pricing
For seat-based or prepaid products, pass quantities:
typescript
await autumn.checkout({
customer_id,
product_id: "credits_pack",
options: [{ feature_id: "credits", quantity: 500 }],
});
Button Text Pattern
typescript
function getButtonText(product: Product): string {
const { scenario, properties } = product;
if (properties?.has_trial) return "Start Trial";
if (scenario === "active") return "Current Plan";
const text = { upgrade: "Upgrade", downgrade: "Downgrade", new: "Subscribe" };
return text[scenario] ?? "Enable";
}
Common Gotchas
- URL field - It's
data.url, notdata.checkout_url - Don't build custom logic - Use
products.listfor scenarios - Proration automatic - Autumn handles upgrade/downgrade proration
- Cancel via free - Prefer attaching free plan over hard cancel
- Success URL - Pass
success_urlto redirect after Stripe checkout
Resources
Didn't find tool you were looking for?