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
Next Steps
Configure Stripe
Set up API keys and webhooks for your project
Test Payments
Learn how to test your integration before going live
Payment Setup Guide
Complete Stripe configuration walkthrough
Implement Billing UI
Add checkout and billing to your application