Skip to content
Nappai Documentation

Stripe Price

Stripe Price manages the prices of your products in Stripe. A price says how much a product costs and whether it is paid once or periodically, for example 49.00 once or 9.90 a month. One product can have several prices, for example in different currencies or with different billing periods.

The subscriptions of Stripe Subscription need a recurring price.

When to use it

  • You add a new product and want to create its price in the same flow.
  • You want to offer a product with a monthly price and another with a yearly price.
  • You sell in several countries and want one price per currency.
  • You want to look up the prices you have in Stripe to show them on your website or in a catalogue.

Configuration

You need a Stripe API credential with the secret key of your Stripe account. See Credentials.

FieldWhat it does
Credential (required)The Stripe API credential of your account.
Operation (required)The action the component performs. Defaults to Create. See Operations.
ModeOnly in Get. By ID looks up one price; All returns the list of prices. Defaults to By ID.
Price IDThe price’s identifier in Stripe (starts with price_). Required in Get with By ID.
AmountOnly in Create. The unit amount in the smallest unit of the currency, for example cents: 990 is 9.90.
CurrencyOnly in Create, and required there. The price’s currency, such as eur or usd. Defaults to usd.
Product IDOnly in Create, and required there. The Stripe product the price belongs to (starts with prod_).
TypeOnly in Create. one_time for a single payment or recurring for a periodic payment. Defaults to one_time.
Billing IntervalOnly in Create. How often a recurring price is charged: day, week, month or year. Required when Type is recurring.
LimitOnly in Get with All. Maximum number of prices returned, between 1 and 100. Defaults to 100.

Operations

  • Create: creates a price for a product.
  • Get: with By ID returns one price; with All returns the list of prices.

Output

The Data output returns the price that was created or looked up. With Get and All, it returns one item per price. Each item includes the price’s identifier, product, amount, currency and, if it is recurring, its interval.

You can connect it to Stripe Subscription to subscribe customers to that price, or to your catalogue. The component can also be connected to an Agent as a tool, so the agent decides when to use it. See Tool Mode.

Example

A recipe app offers its premium plan with monthly billing.

  1. Create the product “Premium” with Stripe Product.
  2. Add Stripe Price with Operation set to Create and pass the product’s identifier to Product ID.
  3. Set Amount to 499, Currency to eur, Type to recurring and Billing Interval to month.
  4. Keep the price’s identifier: it is the one you will use in Price ID of Stripe Subscription.