商品および価格の仕組み

商品および価格は、多くの Stripe 組み込みのコアリソースです。商品は、物品やサービスなど、ビジネスで提供するものを定義します。価格は、商品に対する請求額と請求頻度を定義します。

商品と料金は、Stripe で作成するか、API を使用して Stripe にインポートすることができます。商品と料金を作成すると、Checkout Session (Checkout セッション)、Payment Links、請求書、見積もり、またはカスタムの導入で サブスクリプション を作成することができます。

商品

商品は、顧客に提供する具体的な物品やサービスを記述します。

• 衣料品を販売する E コマースストアでは、商品の 1 つにラージサイズの白色の T シャツがある場合があります。Stripe では、サイズと色の組み合わせごとに別々の商品を作成できます。
• SaaS プラットフォームの場合、基本とプレミアムの料金階層が使用されることがあります。その場合、基本とプレミアムは通常は固有の属性または機能を提供するため、それぞれが個別の商品になります。
• さまざまな目的の寄付を受け付ける寄付プラットフォームの場合、目的のそれぞれが個別の商品になります。

各商品には一意の ID が設定されます。大半の Stripe リソースとは異なり、商品の ID は各自で選択できます。使用する他のシステムに Stripe に簡単に組み込める ID を選択することをお勧めします。たとえば、物品を販売する場合は、自社システムの内部 ID を使用できます。

Stripe で商品を作成するときは、名前を指定する必要があります。必要に応じて、説明または画像などのその他の属性を追加することができます。Stripe Tax を使用している場合は、ペットトリマー、電子書籍、SaaS など、各商品に税コードを定義することもできます。Stripe Tax では、税コードを使用して購入時に消費税を自動で計算、徴収します。

価格

Stripe の Price オブジェクトは、単なる支払い金額ではありません。Price には、税金処理、数量ベースの段階、サブスクリプションの継続期間などの追加情報が含まれています。購入ごとに新しい価格を作成する必要はありません。価格が 1 種類しかない商品を販売する場合、作成が必要な価格は 1 つだけです。この価格を商品のデフォルトの価格に設定することもできます。

料金は、1 回限りの場合も、継続の場合もあります。サブスクリプションでは、継続料金を使用して、顧客に一定の間隔 (「月に 1 回」など) で請求します。同じサービスを多様なサブスクリプション期間で販売する場合は、同じ商品に対して複数の継続料金を作成することをお勧めします。詳細については、料金体系モデルをご覧ください。

1 つの Price で複数の通貨に対応できます。たとえば、ある商品をアメリカでは 10 USD、ヨーロッパでは 9 EUR、日本では 1,300 円で販売する場合、同じ Price オブジェクトで 3 つの通貨すべてに対応できます。各購入では、お客様のシステムでの Price の使用方法に応じて、Price が対応している通貨のいずれかが使用されます。詳しくは、多通貨の Price をご覧ください。

1 つの商品に複数の価格が関連付けられることがあるため、Checkout セッション、Payment Links、請求書、見積もり、サブスクリプションの作成時に、使用する価格を指定する必要があります。

大半の料金では定額の unit_amount が定義されますが、さまざまな段階制や使用量ベースのモデルで機能するように料金を設定することもできます。詳細については、段階制料金および使用量ベースの料金をご覧ください。

Stripe Tax を使用している場合、料金に tax_behavior を指定して、税金がすでに金額に含まれているか、加算する必要があるかを決定できます。詳細については、税金処理をご覧ください。

商品および価格を使用する

商品および価格を作成またはインポートする

商品および価格の使用を開始する最も簡単な方法は、Stripe ダッシュボードで作成することです。

スプレッドシートなどのソフトウェアを使用して管理する大きな商品カタログがある場合は、Product (商品) API と Price (価格) API を使用して商品カタログのインポートをプログラムできます。詳細については、商品および価格のインポートをご覧ください。

取引ごとに異なる金額 (たとえば、ユーザーが選択した寄付の金額) を請求する必要がある場合、商品を作成することはできますが、価格は作成できません。その代わりに、Checkout セッションまたはサブスクリプションを作成するときに price_data パラメーターを使用して、固有の価格を設定することができます。

商品および価格を使用する

既存の商品および価格を管理する

ダッシュボードまたは API を使用して商品の詳細を更新できます。たとえば、商品の説明を変更したり、Checkout ページで使用する新しい商品の画像を追加したりすることができます。

商品の販売を終了する場合は、ダッシュボードを使用してアーカイブボタンをクリックするか、API を使用して active を false に設定することで、その商品と価格をアーカイブすることができます。アーカイブされた商品と価格の情報は、過去の取引の記録を保持するために無期限に保管されます。

一般に、商品または価格を削除することはできず、アーカイブのみを行えます。場合によっては、ダッシュボードで、使用されたことがない価格の削除や、価格が未設定の商品を削除することはできます。

商品の価格を変更するには、新しい金額で新しい価格を作成し、active を false に設定して既存の価格をアーカイブします。過去の取引の変更不可能な記録として既存の価格を保持するために、既存の価格の unit_amount を変更するのではなく、新しい価格を作成する必要があります。

商品にデフォルトの価格を設定して、顧客に提示する最も標準な価格を指定することができます。商品の価格を高くする場合など、後でデフォルトの価格を別の価格に変更することができます。

商品および価格の互換性を理解する

商品と価格のすべての機能がすべての Stripe API と互換性があるわけではありません。互換性についは、次の表をご覧ください。

制限事項について

Stripe アカウントで作成可能な顧客やクーポン、商品、価格、その他の大半のオブジェクトの数に制限はありません。

サブスクリプションで継続的な価格を使用する場合、以下を考慮してください。

• Subscription のすべての料金に同じ recurring.interval と recurring.interval_count を設定する必要があります
• 価格の最大期間は 3 年です