Getting Started

Building Blocks

Custom Fields

Subscription Features




Order Management

Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Revenue Recovery

Hosted Pages


Reports and Analytics

Data Privacy & Security

Fraud Management


Open Source Resources

Other Features

API Integration

Third Party Integrations

Purchase Order Number 

A Purchase Order (PO) is a document generated by the buyer in order to authorize a purchase transaction. A PO Number uniquely identifies a purchase order and is generally defined by the buyer. The buyer will match the PO number in the invoice to the Purchase Order.

When the buyer purchases a subscription and provides the PO number, it is associated with that subscription and is displayed in all the invoices associated with that subscription.

Adding/Updating PO Number in Chargebee 

In Chargebee, you can add or update the PO Number while
a) Creating a subscription, or
b) Changing a subscription.

Additionally, your customers can add or update the PO Number via

a) Web Interface (Invoice Details Page)
b) The Hosted Checkout page during sign up, or
c) The Customer Portal during change of subscription.

  • PO number is not supported by Hosted Pages v1.

  • If you modify the PO number at the Subscription level, it will not be updated in the existing invoices. You can use the Update PO Number option to update it in the invoice level.

Enable PO Number in the Hosted Checkout Page

Enabling PO Number in your Hosted Checkout depends on the Hosted Checkout version you have enabled in your Chargebee site.

Hosted Page v2: PO Number can be enabled in the Additional Information section, under Settings > Configure Chargebee > Checkout & Portal > Field Configurations.

Checkout Pages v3: PO Number can be enabled in the Settings > Configure Chargebee > Checkout & Portal > Configuration > Advanced Settings

If you would like to change the text for the same, this can be done under SettingsHosted Page SettingsText Configurations.

The PO number can be viewed in:

  • The Subscription's details page (in the web interface).
  • The Invoices associated with the subscription.
  • The Customer Portal under Subscriptions.

Export and Mail Merge Fields:

The PO Number details are included in the Invoice and Subscription export files.
The PO Number can also be added as part of the email notification sent to the customer using Mail Merge Fields.

Updating PO Number via API 

The PO number can be added/updated using the following APIs:

One-Off Invoice

One-off invoice is the invoice generated consisting of no-recurring items alone.

Currently, you can add PO number to one-off invoices only via API. PO number can be added to one-off invoices using the following APIs:

Was this article helpful?