Skip to main content

​
Hosted Checkout

When customers need to upgrade to or purchase a paid plan, they’re directed to a hosted checkout page.

​
Supported Payment Providers

  • Stripe - Currently supported
  • More payment providers coming soon

​
Features

FeatureDescription
Secure payment processingPCI-compliant payment handling
Plan selectionDisplay multiple plan options
Purchase typesOne-time and recurring payments
Mobile-responsiveWorks on all devices
Branded experienceYour logo, colors, and fonts

​
How Checkout Works

  1. Customer clicks an upgrade link or uses the upgrade_plan virtual tool
  2. SolvaPay generates a checkout session with available plans
  3. Customer selects a plan and enters payment details
  4. Payment is processed through your connected Stripe account
  5. Purchase is activated immediately
  6. Customer is redirected back to their MCP client

​
Upgrade via Virtual Tools

AI agents can help users upgrade using the built-in virtual tools: 
User: "I need access to the advanced search feature"

Agent: [calls upgrade_plan tool]

Response: "To access advanced search, you'll need the Pro plan. 
Here's your upgrade link: https://..."
The upgrade_plan tool returns:
  • Available plans that include the requested feature
  • Checkout URLs for each plan
  • Plan details (price, features, quotas)

​
Customer Account Portal

Customers can manage their purchases through a self-service portal without contacting support.

​
Portal Capabilities

ActionDescription
View purchasesSee active plans and details
Billing informationView cycle and next payment date
Cancel renewalAccess continues until billing period ends
ReactivateResume cancelled purchases
Transaction historyView past payments

​
Accessing the Portal

Customers can access the portal via:
  1. Direct link - Generate a secure session link programmatically
  2. Virtual tool - The manage_purchase tool returns a portal URL
  3. Email links - Include in billing emails

​
Portal Session Security

Portal sessions are:
  • Time-limited for security
  • Tied to the authenticated user
  • Accessible without re-entering payment details

​
Provider Branding

All customer-facing pages display your brand identity. No SolvaPay branding appears on these pages.

​
Customizable Elements

Configure these in Settings > Pages:
ElementDescription
Brand nameDisplayed in headers and page titles
LogoShown on checkout and login pages
Accent colorUsed for buttons and highlights
Font familyChoose from multiple web fonts
Light mode colorsColor palette for light theme
Dark mode colorsColor palette for dark theme

​
Theme Adaptation

Pages automatically adapt to the user’s system preference:
  • Light mode - Uses your light color palette
  • Dark mode - Uses your dark color palette
Users see a consistent experience that matches their system settings.

​
Logo Requirements

For best results, upload a logo that:
  • Has a transparent background (PNG recommended)
  • Is at least 200px wide
  • Works on both light and dark backgrounds
If your logo doesn’t work on both backgrounds, consider uploading separate versions for light and dark modes.

​
Virtual Tools Reference

MCP Pay injects these tools into every server for purchase management:

​
get_user_info

Returns the current user’s purchase information. Response includes:
  • User ID and email
  • Current plan name and ID
  • Purchase status (active, cancelled, past_due)
  • Quota usage and limits
Use case: Let AI agents check user status before attempting protected operations.

​
upgrade_plan

Returns available upgrade options for the user. Response includes:
  • List of available plans
  • Plan details (name, price, features)
  • Checkout URLs for each plan
Use case: Help users discover and upgrade to plans that include features they need.

​
manage_purchase

Returns a URL to the customer billing portal. Response includes:
  • Secure portal session URL
  • Session expiration time
Use case: Let users manage billing, cancel, or reactivate without leaving their workflow.

​
Integration Examples

​
Handling Paywall Responses

When a user lacks access to a tool, the proxy returns a paywall response. AI agents can use virtual tools to help: 
User: "Export my data to CSV"

Agent: [calls export_to_csv tool]

Proxy: "Access denied - requires Pro plan"

Agent: [calls upgrade_plan tool]

Agent: "The CSV export feature requires a Pro plan ($19/month). 
Would you like to upgrade? Here's the link: [checkout URL]"

​
Proactive Quota Warnings

Agents can check usage before it becomes a problem: 
Agent: [calls get_user_info tool]

Response: { quota_used: 95, quota_limit: 100 }

Agent: "You've used 95 of your 100 monthly API calls. 
Consider upgrading to Pro for 10,000 calls/month."

​
Customization Limits

While branding is fully customizable, the page layouts and flows are managed by SolvaPay for:
  • Security compliance
  • Consistent user experience
  • Automatic updates and improvements
For advanced customization needs beyond branding, consider the SDK integration approach which gives you full control over the user interface.

​
Next Steps