Hosted Pages

​

Hosted Checkout

​

Supported Payment Providers

• Stripe - Currently supported
• More payment providers coming soon

​

Features

​

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. The success screen appears once the payment is confirmed
6. Customer is redirected back to their MCP client

​

Credit top-ups

• Change amount — after continuing to payment, customers can go back with the ← Change amount link to pick a different amount. The entered amount is preserved.
• Business purchases — customers buying as a business can enter their company name, country, and tax identifier (VAT number or EIN) directly on the top-up page. Stripe Tax calculates the correct tax — including reverse charge for eligible EU cross-border B2B purchases — and the final amount updates before the customer confirms. Business details are saved on the customer, so returning buyers don’t re-enter them.
• Confirmed success — like checkout, the top-up success screen waits for the payment confirmation before showing, and credits are minted when the charge succeeds.

​

Upgrade via 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://..."

• Available plans that include the requested feature
• Checkout URLs for each plan
• Plan details (price, features, quotas)

​

Customer Account Portal

​

Portal Capabilities

​

Accessing the Portal

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

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

​

Provider Branding

​

Customizable Elements

​

Theme Adaptation

• Light mode - Uses your light color palette
• Dark mode - Uses your dark color palette

​

Logo Requirements

• Has a transparent background (PNG recommended)
• Is at least 200px wide
• Works on both light and dark backgrounds

​

Virtual Tools Reference

​

get_user_info

• User ID and email
• Current plan name and ID
• Purchase status (active, cancelled, past_due)
• Quota usage and limits

​

upgrade_plan

• List of available plans
• Plan details (name, price, features)
• Checkout URLs for each plan

​

manage_purchase

• Secure portal session URL
• Session expiration time

​

Integration Examples

​

Handling Paywall Responses

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

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

• Security compliance
• Consistent user experience
• Automatic updates and improvements

​

Next Steps

• Best Practices - Plan configuration and quota strategies
• Authentication - Learn about OAuth and user sessions