The Product Object

Field

Type

Description

product_id

string

The product identifier in the purchase platform.

type

string

– non_recurring_product
– subscription

currency

string

Three-letter ISO currency code.

price

int

The cost of the item as a nonnegative integer in the currency unit.

For example 100 cents to charge $1.00, or 100 to charge ¥100, Japanese Yen being a zero-decimal currency.

introductory_price

int

Introductory price

introductory_payment_mode

string

See payment modes

introductory_duration

string

Introductory period duration, specified in ISO 8601 format.

subscription

Subscription

Subscription linked to the product.
Exists only for subscription type products.

object

string

The value is product. String representing the object’s type.

Introductory Payment Modes

Name

Description

pay_as_you_go

New subscribers pay an introductory price each billing period for a specific duration (for example, $1.99 per month for 3 months).

pay_up_front

New subscribers pay a one-time introductory price for a specific duration (for example, $1.99 for 2 months).

free_trial

In this introductory offer, new subscribers access content for free for a specified duration.