Payments test mode #858

BilalG1 · 2025-08-21T18:49:21Z

https://www.loom.com/share/7f61024ffa354850a70779ac7a20c138?sid=b523394b-b243-4bd2-819c-e36ebab1ab92

Important

Introduce test mode for payment subscriptions, including database schema updates, new API routes, client-side handling, and comprehensive test coverage.

Database:
- Add creationSource column to Subscription model in schema.prisma and migration.sql.
- Enum SubscriptionCreationSource added with values PURCHASE_PAGE and TEST_MODE.
API:
- New route test-mode-purchase-session in route.tsx for handling test mode purchases.
- Modify purchase-session and validate-code routes to support test mode.
Client:
- Update page-client.tsx to handle test mode bypass and display relevant UI elements.
- Add handleBypass function to simulate test mode purchases.
Testing:
- Add tests in purchase-session.test.ts and validate-code.test.ts for test mode scenarios.
Misc:
- Update admin-interface.ts and admin-app.ts to include testModePurchase function.
- Minor updates to tailwind.config.ts for animations.

^{This description was created by}^{for fd52134. You can customize this summary. It will automatically update as commits are pushed.}

vercel · 2025-08-21T18:49:28Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
stack-backend	Ready	Preview	Comment	Aug 25, 2025 5:34pm
stack-dashboard	Ready	Preview	Comment	Aug 25, 2025 5:34pm
stack-demo	Ready	Preview	Comment	Aug 25, 2025 5:34pm
stack-docs	Ready	Preview	Comment	Aug 25, 2025 5:34pm

coderabbitai · 2025-08-21T18:49:31Z

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing Touches

🧪 Generate unit tests

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch payments-test-mode

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

Review comments: Directly reply to a review comment made by CodeRabbit. Example:
- I pushed a fix in commit <commit_id>, please review it.
- Open a follow-up GitHub issue for this discussion.
Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
- @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
- @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (`.coderabbit.yaml`)

You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
Please see the configuration documentation for more information.
If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

Visit our Status Page to check the current availability of CodeRabbit.
Visit our Documentation for detailed information on how to use CodeRabbit.
Join our Discord Community to get help, request features, and share feedback.
Follow us on X/Twitter for updates and announcements.

greptile-apps

Greptile Summary

This PR implements test mode functionality for the payments system, allowing developers and administrators to simulate payment flows without processing real transactions through Stripe. The implementation includes several key components:

Backend Infrastructure: A new database migration adds a SubscriptionCreationSource enum with PURCHASE_PAGE and TEST_MODE values, and makes the stripeSubscriptionId field nullable to support test subscriptions that don't have real Stripe subscription IDs. A new API route (/internal/payments/test-mode-purchase-session) handles test mode purchases by creating subscriptions directly in the database with calculated period dates, bypassing Stripe entirely.

Admin Interface: The StackAdminInterface gains a new testModePurchase method that allows admin users to simulate purchases using a price ID and validation code. This method is exposed through the admin app implementation with proper parameter mapping from camelCase to snake_case.

Dashboard UI: The purchase flow is enhanced with bypass functionality for project owners. When authenticated as a project owner, users see a "Test mode bypass" card that allows skipping payment processing. The purchase return page handles bypass scenarios by showing test mode success messages instead of validating Stripe payment intents.

Schema Updates: The offer schema now requires a customerType field (previously optional) to ensure proper categorization, and the default customer type in organization configs is changed from undefined to "user" for better data consistency.

UI Enhancements: A new fadeIn animation is added to Tailwind configuration to support smooth transitions in the payment interface, and JSON parsing is improved using a safer utility function for better error handling.

Testing: New E2E tests validate both the security aspects (tenancy validation) and functionality (subscription creation with item allocation) of the test mode feature.

Confidence score: 1/5

This PR has a critical database migration issue that will prevent deployment to production environments with existing subscription data
Score reflects a migration that adds a required column without a default value, which will cause immediate failure on non-empty tables
Pay close attention to the database migration file 20250821175509_test_mode_subscriptions/migration.sql and the new API route security implementation

_{17 files reviewed, 2 comments}

_{Edit Code Review Bot Settings | Greptile}

apps/backend/src/app/api/latest/internal/payments/test-mode-purchase-session/route.tsx

apps/e2e/tests/backend/endpoints/api/v1/payments/purchase-session.test.ts

packages/stack-shared/src/interface/admin-interface.ts

recurseml · 2025-08-21T18:50:54Z

Review by RecurseML

🔍 Review performed on c22bf3c..03c06a2

Severity	Location	Issue
	apps/e2e/tests/backend/endpoints/api/v1/payments/purchase-session.test.ts:219	Using camelCase for REST API parameter instead of required snake_case
	packages/stack-shared/src/interface/admin-interface.ts:502	REST API parameters not using snake_case convention

✅ Files analyzed, no issues (3)

• apps/backend/src/app/api/latest/internal/payments/test-mode-purchase-session/route.tsx
• apps/dashboard/src/app/(main)/purchase/[code]/page-client.tsx
• apps/backend/src/app/api/latest/payments/purchases/validate-code/route.ts

⏭️ Files skipped (low suspicion) (12)

• apps/backend/prisma/migrations/20250821175509_test_mode_subscriptions/migration.sql
• apps/backend/prisma/schema.prisma
• apps/backend/src/lib/stripe.tsx
• apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/payments/page-client.tsx
• apps/dashboard/src/app/(main)/purchase/return/page-client.tsx
• apps/dashboard/src/app/(main)/purchase/return/page.tsx
• apps/dashboard/src/lib/utils.tsx
• apps/dashboard/tailwind.config.ts
• packages/stack-shared/src/config/schema.ts
• packages/stack-shared/src/schema-fields.ts
• packages/template/src/lib/stack-app/apps/implementations/admin-app-impl.ts
• packages/template/src/lib/stack-app/apps/interfaces/admin-app.ts

apps/backend/src/app/api/latest/payments/purchases/validate-code/route.ts

apps/dashboard/src/lib/utils.tsx

apps/e2e/tests/backend/endpoints/api/v1/payments/purchase-session.test.ts

ellipsis-dev · 2025-08-25T17:29:14Z

apps/e2e/tests/backend/endpoints/api/v1/payments/purchase-session.test.ts

+  expect(response).toMatchInlineSnapshot(`
+    NiceResponse {
+      "status": 400,
+      "body": "Price not found on offer associated with this purchase code",


Ensure the error response shapes are consistent across endpoints. Here, the invalid price_id error returns a plain string while other errors return an object—standardizing this can improve client handling.

Suggested change

"body": "Price not found on offer associated with this purchase code",

"body": { "code": "PRICE_NOT_FOUND", "error": "Price not found on offer associated with this purchase code" },

BilalG1 added 2 commits August 20, 2025 17:11

fix copy

2b19be0

payments test mode

03c06a2

github-actions bot assigned BilalG1 Aug 21, 2025

greptile-apps bot reviewed Aug 21, 2025

View reviewed changes

apps/backend/src/app/api/latest/internal/payments/test-mode-purchase-session/route.tsx Outdated Show resolved Hide resolved

apps/backend/src/app/api/latest/internal/payments/test-mode-purchase-session/route.tsx Outdated Show resolved Hide resolved

recurseml bot reviewed Aug 21, 2025

View reviewed changes

apps/e2e/tests/backend/endpoints/api/v1/payments/purchase-session.test.ts Show resolved Hide resolved

recurseml bot reviewed Aug 21, 2025

View reviewed changes

packages/stack-shared/src/interface/admin-interface.ts Show resolved Hide resolved

ellipsis-dev bot reviewed Aug 21, 2025

View reviewed changes

apps/backend/src/app/api/latest/payments/purchases/validate-code/route.ts Show resolved Hide resolved

BilalG1 added 2 commits August 21, 2025 12:12

revoke codes

19d1d52

fix test

582f876

BilalG1 assigned N2D4 and unassigned BilalG1 Aug 21, 2025

N2D4 approved these changes Aug 22, 2025

View reviewed changes

apps/dashboard/src/lib/utils.tsx Show resolved Hide resolved

N2D4 approved these changes Aug 22, 2025

View reviewed changes

apps/e2e/tests/backend/endpoints/api/v1/payments/purchase-session.test.ts Show resolved Hide resolved

N2D4 assigned BilalG1 and unassigned N2D4 Aug 22, 2025

add tests, fix freestyle-mock

fd52134

ellipsis-dev bot reviewed Aug 25, 2025

View reviewed changes

BilalG1 merged commit 68c66d5 into payments-ui-fixes Aug 25, 2025
20 checks passed

BilalG1 deleted the payments-test-mode branch August 25, 2025 17:50

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Payments test mode #858

Payments test mode #858

Uh oh!

BilalG1 commented Aug 21, 2025 •

edited by ellipsis-dev bot

Loading

Uh oh!

vercel bot commented Aug 21, 2025 •

edited

Loading

Uh oh!

coderabbitai bot commented Aug 21, 2025 •

edited

Loading

Other AI code review bot(s) detected

Review skipped

Chat

Support

CodeRabbit Commands (Invoked using PR/Issue comments)

Other keywords and placeholders

CodeRabbit Configuration File (`.coderabbit.yaml`)

Status, Documentation and Community

Uh oh!

greptile-apps bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

recurseml bot commented Aug 21, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ellipsis-dev bot Aug 25, 2025

Uh oh!

Uh oh!

Uh oh!

	"body": "Price not found on offer associated with this purchase code",
	"body": { "code": "PRICE_NOT_FOUND", "error": "Price not found on offer associated with this purchase code" },

Payments test mode #858

Payments test mode #858

Uh oh!

Conversation

BilalG1 commented Aug 21, 2025 • edited by ellipsis-dev bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel bot commented Aug 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot commented Aug 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Other AI code review bot(s) detected

Review skipped

Chat

Support

CodeRabbit Commands (Invoked using PR/Issue comments)

Other keywords and placeholders

CodeRabbit Configuration File (.coderabbit.yaml)

Status, Documentation and Community

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

Greptile Summary

Confidence score: 1/5

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

recurseml bot commented Aug 21, 2025

Review by RecurseML

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ellipsis-dev bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

BilalG1 commented Aug 21, 2025 •

edited by ellipsis-dev bot

Loading

vercel bot commented Aug 21, 2025 •

edited

Loading

coderabbitai bot commented Aug 21, 2025 •

edited

Loading

CodeRabbit Configuration File (`.coderabbit.yaml`)