Analytics

The Bags 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 Bags dashboard to access analytics. The dashboard is organized into three sections:

Revenue

• Gross revenue — Total collected before fees and refunds
• Net revenue — After Bags fees, tax remittance, and refunds
• Revenue by network — Base, Ethereum, Polygon, Solana

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 — USDC by network (card metrics coming soon)

Customers

• Geographic distribution — Where your customers pay from

Filtering and Time Ranges

All dashboard views support:

• Time range — Last 7 days, 30 days, 90 days, year-to-date, or custom range
• Network — Filter by blockchain
• Status — Filter by completed, failed, refunded

Integrating Analytics Data

While Bags 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://www.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:

Subscription webhook events (subscription.*) are coming soon — do not build MRR dashboards on them yet.

See Handle Webhooks for setup instructions.

3. Settlement Data

Use the settlements endpoint for reconciliation:

curl "https://www.getbags.app/api/settlements" \
  -H "Authorization: Bearer $BAG_API_KEY"

Key Metrics to Track

What's next