What is Payment Management?
Payment Management enables you to:- Configure Stripe Integration: Set up API keys and webhooks per project
- Monitor Subscriptions: Track active, trialing, and cancelled subscriptions
- View Transactions: Audit payment history and identify failed charges
- Test Before Launch: Use Stripe test mode to validate your billing flow
- Enable End-User Billing: Allow your users to subscribe and manage their plans
Enabling Payments for Your Project
Access Payment Settings
Navigate to Console > Payments > Settings or use the “Configure Payments” quick action from your dashboard.
Enter Stripe Credentials
Add your Stripe API keys for test mode first. You’ll need:
- Publishable Key (starts with
pk_test_) - Secret Key (starts with
sk_test_)
Configure Webhooks
Copy the webhook URL from Cloud Admin and add it to your Stripe Dashboard under Developers > Webhooks.Your webhook URLs follow this pattern:
- Test:
https://api.devkit4ai.com/api/v1/payments/stripe/webhooks/{project_id}/test - Live:
https://api.devkit4ai.com/api/v1/payments/stripe/webhooks/{project_id}/live
Test the Integration
Create test subscriptions using Stripe test cards to verify your setup works correctly.
Dashboard Payment Statistics
The Cloud Admin dashboard displays real-time payment metrics:Subscriptions Count
Total active subscriptions across all projects or filtered by project. Includes breakdown by status (active, trialing, past_due).
Transactions Count
Total payment transactions with success/failure breakdown. Helps identify payment issues quickly.
Sidebar Navigation
Access payment features through the console sidebar:- Payments (parent menu)
- Settings: Configure Stripe credentials and webhooks
- Subscriptions: View and filter subscription list
- Transactions: Browse payment transaction history
How End Users Use Billing
Your end users interact with payments through the Starter Kit application:| Feature | Description | Where |
|---|---|---|
| Subscription Checkout | Users select a plan and complete payment | Pricing page → Stripe Checkout |
| Subscription Status | View current plan and billing period | User dashboard |
| Change Plan | Upgrade or downgrade subscription | Customer portal |
| Update Payment Method | Change credit card or billing info | Customer portal |
| Cancel Subscription | Self-service cancellation with optional feedback | Customer portal |
| View Invoices | Download past invoices and receipts | Customer portal |
Billing Capabilities
The payment module supports comprehensive billing scenarios:Subscription Features
- Multiple Pricing Plans: Support tiered pricing (Free, Pro, Enterprise)
- Trial Periods: Offer free trials before charging
- Proration: Automatic credit/charge when changing plans mid-cycle
- Cancellation Handling: Grace period with access until period end
- Renewal Management: Automatic renewals with failure handling
Payment Features
- Secure Processing: PCI-compliant via Stripe
- Multiple Payment Methods: Credit cards, bank transfers (via Stripe)
- Invoice Generation: Automatic invoices for each payment
- Refund Support: Process refunds through Stripe Dashboard
- Tax Handling: Stripe Tax integration ready
Developer Features
- Per-Project Isolation: Each project has independent credentials
- Test/Live Separation: Separate keys prevent accidental production charges
- Webhook Reliability: Automatic retry with event deduplication
- Audit Trail: Complete transaction history for compliance
Quick Actions
From the console dashboard, use these quick actions for common payment tasks:Configure Payments
Set up or update Stripe credentials for your project
View Subscriptions
Monitor active subscriptions and their status
Transaction History
Review payment history and identify issues