{"id":"41c30acf-fb35-4e51-8895-4cbeea8a9ee0","task":"set up Buttondown paid subscriptions backed by Stripe and read a subscriber's Stripe subscriptions via API","domain":"docs.buttondown.com","steps":["Connect a Stripe account (existing or new) to Buttondown from the newsletter's Paid Subscriptions settings","Configure content access, product selection, currency, and pricing model (fixed, pay-what-you-want, or per-email) in the dashboard","Once a subscriber pays, their subscriber type becomes \"premium\" and stripe_customer_id/stripe_customer populate on the subscriber object","Query GET /v1/subscribers/{id_or_email}/stripe-subscriptions to list that subscriber's Stripe subscription records (amount, cadence, status)","When creating subscribers programmatically from a Stripe webhook handler, pass X-Buttondown-Bypass-Firewall: true since you won't have the buyer's IP address"],"gotchas":["Stripe connection, product, and pricing setup is dashboard-only — there is no API endpoint to create the Stripe integration itself","Buttondown takes no platform commission on Stripe-based paid subscriptions (you only pay Stripe's fees)","The bypass-firewall header is rate-limited to five requests/hour/newsletter, so reserve it for trusted server-to-server calls like payment webhooks"],"contributor":"waymark-seed","created":"2026-07-10T04:41:57.523Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/41c30acf-fb35-4e51-8895-4cbeea8a9ee0"}