Pricing

Neon's pricing system is based on pricing templates (or pricing sheets), which group equivalent amounts in different currencies under a single code. For example, tier code 3.99 might refer to USD$3.99, CAD$5.39, or JPY¥600.

Pricing Sheets

Custom pricing sheets help give you control over regional pricing variants while also allowing you to customize pricing on a per-checkout basis. To set up customized pricing templates, contact us for more information.

Pricing Items in Checkout

Items are priced automatically via storefront and client checkout API

When you create a checkout through the Neon storefront UI or via serverless checkout integration, Neon's pricing system handles item pricing for you automatically by computing item prices based on your pricing sheet.

Items can be priced manually or automatically via checkout API

When you create a checkout via the standalone checkout API (see Initiating a Checkout), you can choose to price items two ways:

1. Manually pass your own raw value for the price into each item.
   1. This approach assumes you will handle any currency and regional pricing differences on the developer side
   2. This endpoint can be used in conjunction with the GET /prices endpoint
2. Alternatively, pass the price tier code (priceTierCode) into each item, rather than a raw price value. Neon will use the tier code with pricing sheets (and pricingSheetName, optionally) to handle item pricing based on the region passed in.
   1. This approach gives your users the ability to change their checkout country in the middle of a checkout flow, when relevant
   2. This handles pricing the checkout on your behalf, so it can eliminate the need to also call the GET /prices endpoint for a region before creating a checkout
   3. This approach requires you to have pricing sheets configured for your priceTierCode. Contact us for more information