Billing and Reviews

CodePeel uses a review-based billing model. Review runs and AI assistance can use your plan allowance; balance checks are free. Plans are managed through Polar, our payment provider.

---

Plans

*Personal Max has no monthly allowance cap. Team Max has a shared limit of 5,000 units per seat and a 5,000-unit limit per member. Hourly limits still apply. The 50% discount applies via the Founder Launch Pass (LAUNCHPEEL50) and locks in forever for early adopters across all billed cycles (both monthly and annual).

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: Quotas reset at the end of each billing cycle (monthly). Free accounts receive 30 reviews/month; Pro accounts receive 500 reviews/month.

---

Review usage

See Review usage and limits for size-based deductions, personal and team allowances, failed requests, and balance checks.

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. Team reviews also check the member and shared team allowance

Rate Limits & Burst Protection

Rate limits are enforced per plan tier to maintain infrastructure stability and prevent abuse:

• Free Tier: 3 reviews / hour
• Pro & Team Pro: 6 reviews / hour (500 reviews / month total)
• Max & Team Max: 12 reviews / hour (unlimited total)

Rate limits use a rolling 1-hour window. If a PR is submitted while your hourly limit is reached, CodePeel posts an informational comment on the PR indicating when your next review slot becomes available and halts the review without consuming any of your monthly quota. Once the window clears, simply push a new commit or re-trigger to proceed.

Quota Reset

Usage counters reset at your billing cycle end date (from Polar). Personal Max has no monthly allowance cap. See usage and limits for team limits.

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

Promotional Passes & Discounts (Peel Passes)

CodePeel offers promotional discounts via Peel Passes:

• Founder Launch Pass: Provides 50% off lifetime across Pro, Max, and Team subscriptions.
• Claiming your pass: After signup, scratch your digital ticket in the welcome modal or visit the Promo Code tab in Settings.
• Checkout application: When you click Upgrade with an active Peel Pass, the discount code (LAUNCHPEEL50) is automatically applied at Polar checkout. You can also manually enter the coupon code directly into Polar's discount box.

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/month."
• Pro: "No reviews remaining this period. Reviews reset at start of next billing cycle."
• Team Max: Check both the member limit and shared team balance.

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. In Team Pro, members draw from a pooled organizational quota (500 reviews/month × seat count), protected by an individual safeguard limit of up to 500 reviews/month per member to prevent a single user from exhausting the team's entire balance. Team Max provides unlimited pooled reviews across the team (with a 5,000 reviews/seat/month fair-use buffer).

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
• Personal Max has no monthly allowance cap; Team Max limits are described in usage and limits.
• 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 monthly quota remaining but reach the hourly burst limit during rapid commits. Check the countdown posted on your PR comment and push a new commit once the window has elapsed to trigger the review.

---

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, 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? Annual plans are billed upfront ($99.99/yr for Pro, reg. $199.99/yr; $249.99/yr for Max, reg. $499.99/yr with the 50% Founder Launch Pass). This delivers an effective monthly rate of $8.33/mo (Pro) and $20.83/mo (Max). Monthly review quota resets each billing cycle (500/month Pro, unlimited Max).

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

---

Related Documentation

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