Bag DocsAnalytics
How to use Bag's analytics dashboard and integrate analytics data.
Analytics
The Bag dashboard provides real-time analytics for revenue, transactions, and customer behavior. This guide covers how to read the dashboard and integrate analytics data into your own systems.
Dashboard Overview
Navigate to your Bag dashboard to access analytics. The dashboard is organized into three sections:
Revenue
- Gross revenue — Total collected before fees and refunds
- Net revenue — After Bag fees, tax remittance, and refunds
- Revenue by payment method — Stablecoin vs. card breakdown
- Revenue by network — Base, Ethereum, Polygon, Solana
- MRR / ARR — Monthly and annual recurring revenue for subscription plans
Transactions
- Volume and count — Total transaction value and number over time
- Success vs. failure rates — Payment completion percentage
- Average transaction value — Per-transaction averages
- Payment method split — Stablecoin vs. card share
Customers
- Geographic distribution — Where your customers pay from
- Payment method preferences — Stablecoin vs. card adoption rates
- Subscription cohort analysis — Retention and churn by signup cohort
Filtering and Time Ranges
All dashboard views support:
- Time range — Last 7 days, 30 days, 90 days, year-to-date, or custom range
- Payment method — Filter by stablecoin, card, or all
- Network — Filter by specific blockchain network
- Status — Filter by completed, failed, refunded
Integrating Analytics Data
While Bag doesn't expose a dedicated analytics API, you can build your own analytics by combining two data sources:
1. Transaction List API
Use the transactions endpoint to pull raw transaction data:
curl "https://getbags.app/api/transactions?limit=100" \
-H "Authorization: Bearer $BAG_API_KEY"Each transaction includes amount, status, network, payment method, timestamps, and customer info.
2. Webhooks
Subscribe to webhook events to build real-time analytics:
| Event | Analytics use |
|---|---|
payment.completed | Track successful payments, revenue |
payment.failed | Track failure rates, identify issues |
subscription.created | Track new subscribers, MRR growth |
subscription.renewed | Track retention, recurring revenue |
subscription.canceled | Track churn |
subscription.past_due | Track at-risk revenue |
See Handle Webhooks for setup instructions.
3. Settlement Data
Use the settlements endpoint for reconciliation:
curl "https://getbags.app/api/settlements" \
-H "Authorization: Bearer $BAG_API_KEY"Key Metrics to Track
| Metric | Formula | Healthy Range |
|---|---|---|
| Payment success rate | Completed / (Completed + Failed) | > 95% |
| Dispute rate | Disputes / Total transactions | < 1% |
| Churn rate | Canceled subs / Total active subs (monthly) | < 5% |
| Net revenue retention | (MRR - Churn + Expansion) / Starting MRR | > 100% |