New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now

Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Hosted Capabilities
  3. Articles and FAQ
  4. Checkout V3 - Pop Up
  1. Billing
  2. Hosted Capabilities
  3. Articles and FAQ
  4. Checkout V3 - Pop Up

"Sorry, the URL or some of the parameters are not valid" error with Hosted Pages API

Problem Statement

You receive the error "Sorry, the URL or some of the parameters are not valid" when using the Hosted Pages API.

Solution

Check the following common causes:

1. Parameter order

For APIs such as "Checkout existing for items", the plan's item price ID must be passed before the add-on's. Example:

subscription_items[item_price_id][0]=Basic-Test-USD-Monthly
subscription_items[item_price_id][1]=cbdemo_analytics-additional-users-USD-Monthly

The same order applies when creating a Hosted page URL.

2. Multiple plans

The API does not support checking out more than one plan at a time. Ensure you are not passing item price IDs for multiple plans.

3. API syntax

Verify the request matches the syntax in the Hosted Page API docs. If the error persists, contact support.

Additional Information

In Product Catalog 2.0, each plan's price point page has a dynamic payment URL. Go to Product Catalog > Plans > Plan details > Customer-Facing Info > Get Payment Link. See how to create an item-specific checkout URL.

image

Related Articles

Configuring Single Page checkout - Hosted pages V2
How do I remove autofill of address fields in Checkout or portal?
How can I add or remove ‘Go to App’ from the self-service portal?
What is the hosted pages/checkout pages of Chargebee?
How to edit the Addon quantity from the portal?
How to differentiate between Addon and Charges in Portal?
How can I add an allowed domain on single page checkout Hpv2?
How can I pass prefilled Custom Fields through checkout via Drop-in Script?
How to customize the V3 (In-app) checkout - hosted pages?
“Blocked autofocusing on a element in a cross-origin subframe” due to CSP headers
How to customize the In-app checkout pages (HPv3) in Chargebee?
How to configure return/redirect URLs for one-time payments checkout in Chargebee?
What are the benefits of Chargebee's checkout page?
'Error: New checkout is not enabled on your test site.'
How to add a unit-based charge on the URL?
Existing customer with plan based URL in Latest Product Catalog - V3 checkout
Why do Plans 'Preview' on the Live site show the configurations of the Test site‌?

Show more

Was this article helpful?