To create an inline price, pass in price_data instead of a price.id when you create a one-time payment or subscription. For example, to subscribe a customer to a monthly subscription with an inline price:
This creates a monthly recurring price of 50 USD for the basic service offering. You can’t update or reuse inline prices after you create them. By default, prices created with price_data are effectively archived (they’re marked as active=false). You can also use price_data with Checkout Sessions, Invoice Items, and Subscription Schedules.
Click + Add another price to create a new price. The default currency is the first currency on your Price. All your Prices must have the same default currency.
To add a new currency option to your price, click + Add a price by currency. Search and select from the list of supported currencies.
Stripe suggests an exchange rate based on currency values at 12:00 PM EST, but you can pick your own. For currencies that are subject to larger fluctuations, we recommend adding more of a buffer.
To save the new price, click Next > Update product.
To show your customer the price in their currency, you can retrieve the multi-currency price and view its currency_options.<currency>.unit_amount field. The API response won’t include currency_options by default. To include it in the response, expand the currency_options field:
To improve latency and avoid problems with rate-limiting, cache the price instead of re-fetching it every time a customer visits your site.
Use multi-currency prices
Each purchase uses one of the multi-currency Price’s supported currencies, depending on how you use the Price in your integration.
Checkout automatically determines the customer’s local currency from their IP address, as long as the price supports that currency. If the customer’s local currency isn’t supported, Checkout uses the default currency for the price.
If a Checkout Session uses multiple prices, coupons, promotion codes, or shipping rates, then they must all support the customer’s local currency, or else Checkout uses the default currency. They must all have the same default currency, or else Stripe returns an error when you create the Checkout Session.
Alternatively, you can use the currency parameter to explicitly tell Checkout which currency to use.
Migrate from single-currency prices to multi-currency
If you have an existing single-currency price, you can retroactively add multiple currencies to it in the Dashboard.
If you use Checkout or Payment Links, then multi-currency prices take effect automatically. If Stripe detects that the price supports the customer’s local currency, then it automatically uses that currency. If you use multiple prices, coupons, promotion codes, or shipping rates in a single purchase, then they must all support the customer’s local currency, and they must all have the same default currency.
If you create subscriptions directly, the multi-currency prices don’t take effect until you pass the currency parameter. If you don’t pass the currency parameter, the subscription always uses the default currency for the price.
商品カタログが非常に大きい場合は、Products API を使用して、カタログをプログラムでインポートします。商品カタログを Stripe にインポートする場合、商品管理システムや CSV ファイルなど、任意の開始データソースを使用できます。
Products API を使用して、システム内の各製品に対して Stripe で製品を作成します。システム内の商品を Stripe 内の商品にマッピングするには、インポートする各商品に一意の id を割り当てます。商品ごとに、Prices API を使用して対応する価格を作成します。新しく作成した価格の id を必ず保存してください。この id は、実装で商品と価格を使用するときに渡す必要があります。
