New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
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

Agentic AI


  • Chargebee Copilot
  • Catalog Setup Assistant
  • MCP Servers

Developer Resources


  • Developer Resources Overview
  • API Explorer
  • Articles and FAQ

Chargebee Apps


  • Chargebee Apps CLI Developer Guide

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


  • Overview
  • Use Cases
  • Setting up Usage Based Billing
  • Usage Alerts
  • Prepaid credits
  • Mid-term Subscription Changes
  • FAQs

Invoices, Credit Notes, and Quotes


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

Taxes


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

E-Invoicing


  • Overview
  • Enabling E-Invoicing

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Mobile SDKs and Wrappers
  • Articles and FAQ

Site Configuration


  • Add Users & Assign Roles
  • Chargebee Notifications
  • 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
  • OAuth Apps
  • 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 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
  • E-Invoicing
  • 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 - Hosted Checkout
  1. Billing
  2. Hosted Capabilities
  3. Articles and FAQ
  4. Checkout - Hosted Checkout

How can I pass prefilled Custom Fields through checkout via Drop-in Script?

Problem Statement

I have a custom field configured at the subscription level. I need to pass the value of the field while triggering checkout via Drop-in Script. How can I achieve this?

Solution

To pass prefilled custom field values through Checkout via the Drop-in script, use the product.data object with the custom field API name as the key. The format is product.data["cf_<api_name>"] = "<value>";, where cf_<api_name> is the API parameter for your custom field.

To find the custom field API name: Settings > Configure Chargebee > Custom Fields > select the custom field > copy the API name.

Refer to this video for Custom Field API name.

Steps to Set It Up

Sample script for sites:

document.addEventListener("DOMContentLoaded", function() {

            var cbInstance = Chargebee.getInstance();

            var planElement = document.querySelector("[data-cb-item-0='100-Monthly-USD-Monthly']");

            var product = cbInstance.getProduct(planElement);

              // adding subscription custom fields

            product.data["cf_ref_code"] = "fbuy_ref_code";

            console.log(product);



            cbInstance.setCheckoutCallbacks(function(product) {

                console.log(product.addons);

                return {

                    loaded: function() {

                        console.log("checkout opened");

                    },

                    close: function() {

                        console.log("checkout closed");

                    },

                    success: function(hostedPageId) {

                      console.log(hostedPageId);

                    },

                    step: function(value) {

                        // value -> which step in checkout

                        console.log(value);

                    }

                }

              });

        });

Replace the plan price point ID and custom field API parameter with your site values. For the complete sample code, see Chargebee Checkout Samples or the sample document.

Related Articles

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?
“Sorry,the URL or the some of the parameters are not valid” error with Hosted Pages API
“Blocked autofocusing on an element in a cross-origin subframe" due to CSP headers
How to customize the Checkout pages in Chargebee?
How to configure return/redirect URLs for one-time payments checkout in Chargebee?
What are the benefits of Chargebee's checkout page?
How to add a unit-based charge on the URL?
Existing customer with plan based URL in Latest Product Catalog - in-app layout checkout
Why do Plans 'Preview' on the Live site show the configurations of the Test site‌?

Show more

Was this article helpful?