Billing and Reviews

CodePeel uses a review-based billing model. Every PR review, IDE review, MCP tool call, and chat interaction consumes reviews from your quota. Plans are managed through Polar, our payment provider.

---

Plans

*Max and Team Max tiers have an abuse protection cap of 5,000 reviews/month (far beyond normal usage).

Team Pro and Team Max are per-seat subscriptions tied to a GitHub App installation. The owner pays for all seats; individual members don't need their own plans. See Teams documentation for setup details.

All plans include: inline PR comments, walkthrough summaries, health score, secret scanning, SAST analysis, architecture review, sequence diagrams, VS Code extension, MCP server, chat commands, pre-merge checks.

Note: Pro and Team Pro quotas reset daily (UTC midnight), not monthly. The "500" figure represents reviews available per day.

---

How Review Deductions Work

Reviews are consumed when a PR is analyzed. The cost depends on the total diff size (additions + deletions across all files):

This tiered model ensures small, focused PRs are inexpensive while large PRs requiring more analysis are priced proportionally.

What Counts as a Review

All review sources draw from the same monthly pool.

Model Credit Costs

All supported models cost 0 credits per review — switching models does not change cost. Premium model tiers may be introduced later for Max subscribers.

Failed Review Refunds

GitHub PR reviews: If a review fails due to AI error, timeout, or service unavailability, the deduction is automatically refunded.

IDE / MCP reviews: These do not refund on failure. Quota is deducted before the AI call is made.

---

How It Works

Subscription Lifecycle

1. Select a plan from the billing page
2. Redirected to Polar checkout
3. Polar processes payment
4. CodePeel updates your account: tier, quota, subscription status
5. Usage counter resets to 0 on upgrade
6. Usage counters reset at your billing cycle end date (from Polar)

Quota Enforcement

When a review is triggered:

1. System checks your tier and reviews used against your quota
2. If reviews remain, the review proceeds
3. If quota exhausted, the review is blocked with a comment on the PR
4. Max tier checks against the 5,000 abuse-protection cap

Per-minute Rate Limiting

Reviews are limited to 20 per minute. When the limit is reached, subsequent reviews are queued until a slot opens.

• All tiers: 20 requests/minute for review/fixes/summarize, 15/minute for chat

Rate limits degrade gracefully — if a rate-limit check fails, the review proceeds rather than blocking.

Quota Reset

Usage counters reset at your billing cycle end date (from Polar). Max-tier users are skipped (unlimited, but capped at the 5,000 abuse-protection limit).

These limits are independent of the per-minute rate limits above.

---

Checking Your Usage

Navigate to Billing in the dashboard sidebar. Two primary cards:

Current Plan — active tier, monthly price, next payment date. Warning if scheduled for cancellation.

Usage Summary — reviews consumed / total quota with progress bar:

• Blue: under 70% usage
• Yellow: 70–89% usage
• Red: 90%+ or quota exhausted

Max tier shows total reviews consumed without a cap indicator.

Programmatic Access

Use the MCP check_credits tool to check your plan tier, used reviews, and remaining balance from an AI agent.

---

Upgrading Your Plan

1. Go to Billing in sidebar
2. Click Upgrade (to Pro or Max)
3. Complete payment on Polar checkout
4. Redirected back with new plan active immediately
5. Usage counter resets to 0 on upgrade

See Teams documentation for details on team subscriptions.

---

Switching Plans

1. Cancel current plan from billing page
2. Current plan stays active until period ends
3. Subscribe to new plan

Usage counter resets on switch. No access loss during transition.

When you switch between plans, your tier, quota, and billing interval update automatically.

---

Cancelling Your Plan

1. Go to Billing → Manage Plan → Cancel Plan
2. Confirm cancellation

After cancellation:

• Plan stays active until period end
• "Cancels at period end" indicator shown
• After period ends: account downgrades to Free
• All review history, settings, learnings, configuration preserved
• Quota reverts to 30 reviews/month

Uncancelling: Resubscribe before the period ends. Active status is restored automatically.

---

Payment Provider

CodePeel uses Polar for checkout, subscriptions, invoicing, payment methods, and refunds.

Customer Portal

Paid subscribers can access Polar portal to:

• Update payment method
• View/download invoices
• See payment history
• Manage subscription directly

Click Manage in Payment Method section or Polar Portal in plan management panel.

Supported Payment Methods

Credit/debit cards via Polar. CodePeel stores no payment card information.

Invoices & Receipts

Available through Polar customer portal. Downloadable as PDF for expense reporting.

---

Billing History

Billing page shows transaction history from CodePeel records and Polar API.

Status badges: Active (current), Paid (previous cycle), Canceled, Refunded, Partial Refund, Failed (declined), Pending.

Paginated and refreshable from the latest stored billing state.

---

When Reviews Run Out

GitHub PR Reviews

• Review not processed
• Comment posted: "CodePeel is paused — monthly quota exceeded"
• Link to upgrade
• Resumes automatically at your billing cycle end date

IDE / MCP Reviews

• 402 HTTP response indicating no reviews remaining
• Free: "No reviews remaining. Upgrade to Pro for 500 reviews/day."
• Pro: "No reviews remaining this period. Reviews reset at start of next billing cycle."
• Max: "Monthly review cap reached (5000). Contact support if you need more."

Payment Failures

If payment declined, subscription enters past_due:

• Warning banner on billing page
• Reviews blocked: "Payment failed. Update payment method at codepeel.com/app/billing"
• Update card → charge succeeds → reviews resume

---

Private Repositories

All repositories (public and private) are available on all tiers. There is no repository limit or private repo restriction on any plan.

---

Team Billing

Team Pro and Team Max are per-seat subscriptions tied to a GitHub App installation. The installation owner pays for all seats, and all members share a pooled review quota (Team Pro: 500/day × seat count, Team Max: unlimited).

See Teams documentation for setup details.

---

Subscription Sync

If you've subscribed but your plan isn't active yet, go to Billing in the dashboard and click the refresh option. This reconciles your subscription with our payment provider.

---

Troubleshooting

"No reviews remaining" but I just subscribed

1. Click Refresh on billing page
2. Wait 10 seconds, reload
3. Use the billing repair action if the webhook delivery was missed

Payment failed banner won't go away

1. Click Update Card on banner or Manage in Payment Method
2. Update payment method in Polar portal
3. Retry charge succeeds → banner clears

Reviews not resetting at billing cycle end

• Usage resets at your billing cycle end date from Polar, not the 1st of the month
• Max tier is skipped by the reset (unlimited, capped at 5,000)
• If the reset did not run, contact support for a manual reset

Checkout redirects but plan not active

• Click Refresh on the billing page
• If that doesn't work, contact support with your user ID

Rate limited but quota shows reviews remaining Rate limits and quotas are independent. You can have quota remaining but be rate-limited in the moment. Wait for indicated time — review proceeds automatically.

---

FAQ

Do unused reviews roll over? No. Quota resets to 0 at your billing cycle end date. No rollover.

Does VS Code extension use separate quota? No. All sources (GitHub PRs, VS Code, MCP, chat) draw from same monthly pool.

What happens if I downgrade to Free? All history, settings, learnings, configuration preserved. Quota reverts to 30/month. Lose Pro/Max features (auto-fix, auto-test, custom rules).

Can I get a refund? Refunds handled through Polar. Appears in billing history as "Refunded" or "Partial Refund". Contact support if charged incorrectly.

How is annual plan billed? Full year upfront ($99.99 Pro, $249.99 Max). Daily quota resets at UTC midnight (500/day Pro, unlimited Max). Annual price = 16.6% discount vs monthly.

Who gets charged on shared repos? PR author's CodePeel account. External contributors → owner fallback. See Team Billing.

---

Related Documentation

• Configuration — .codepeel.yml settings including custom rules (Pro/Max only)
• MCP Server — Programmatic access to reviews, fixes, and chat
• Pre-merge Checks — Quality gates that block merges