stripe

Stripe Plugin

Full Stripe billing integration, subscriptions, webhooks, and customer portal. Pro plugin.

Requires: Basic license tier or higher. nself license set nself_pro_...

Install

nself license set nself_pro_xxxxx...
nself plugin install stripe

What It Does

Syncs your complete Stripe account state into Postgres in real time: customers, subscriptions, invoices, payment intents, products, prices, refunds, and disputes. Handles Stripe webhooks to keep data current. Exposes a customer portal API for self-service subscription management. With 24 synced tables, you can query all billing data directly via Hasura GraphQL without hitting the Stripe API.

Configuration

Env Var	Default	Description
STRIPE_PORT	3070	Stripe plugin port
STRIPE_SECRET_KEY	none	Stripe secret key (sk_live_… or sk_test_…)
STRIPE_WEBHOOK_SECRET	none	Webhook endpoint signing secret
STRIPE_PORTAL_RETURN_URL	none	Customer portal return URL

Ports

Port	Purpose
3070	Stripe integration REST API

Database Tables

24 tables added to your Postgres database, including:

• np_stripe_customers: customer records
• np_stripe_subscriptions: subscription state
• np_stripe_invoices: invoice history
• np_stripe_payment_intents: payment records
• np_stripe_products: product catalog
• np_stripe_prices: pricing tiers
• np_stripe_refunds: refund records
• np_stripe_disputes: dispute/chargeback records
• And 16 more for coupons, trials, tax rates, etc.

Nginx Routes

Route	Target
/stripe/webhook	Stripe event webhook receiver
/stripe/portal	Customer portal session API

API

POST /stripe/webhook: Stripe webhook receiver
POST /portal/session: Create customer portal session
POST /checkout/session: Create checkout session
GET  /subscriptions/{customer_id}: Get customer subscription state