Invoice Portal Configs
Invoice Portal Configuration Options
Last updated
Invoice Portal Configuration Options
Last updated
Type
Required
Description
String
Yes OR customer_id
The customer's email address. This will automatically populate checkout, or be used to identify current subscribers. Can alternatively use customer_id.
Type
Required
Description
String
Yes OR email
The customer's Stripe Customer ID. This will be used to identify existing subscribers or subscribe new customers. You must have already created the Stripe Customer object to use this.
Type
Required
Description
String
Yes
An HMAC string used for authenticating the user loading the embed more securely. This is required in order to go to 'Live Mode' in Billflow (connected to 'Live Mode' in Stripe). The hash is generated with your Billflow Secret and the customer's email or Stripe Customer ID, whichever you are using to identify users.
Type
Required
Description
String
No
The Stripe subscription ID. Pass if you want a user to only see and manage a single subscription. Used if your customers have multiple subscriptions and you only want them to view one.
Type
Required
Description
Function
No
Function that is called when users signup, change plan (upgrade/downgrade), resubscribe, or update Credit Card. Used to update user data, do redirects, or provide notifications. Payload contains an event name and a response object. Learn More.
Type
Required
Description
Object
No
Use to set the quantity of a subscription during creation. Can get an integer or an object of key-value pairs. The quantity will apply to products with the unit_label defined. If an integer is passed, it will apply the quantity to all products on the tier, if an object is passed with the unit_labels as keys, it will assign that quantity to the respective unit_label.
Eg: 5
OR
Eg: {product_unit_label1 : 10, unit_label2: 20}