Getting Started

Building Blocks

Custom Fields

Subscription Features




Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages


Reports and Analytics


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 in the v1 version of the Hosted Pages.

  • 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.

Enabling PO Number in the Hosted Checkout Page

If you would like the PO number to be shown in the Hosted Checkout Page and the Customer Portal, it can be enabled in the Additional Information section, under SettingsHosted Page SettingsField Configurations.

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

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?