コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース
概要
Stripe Payments について
構築済みのシステムをアップグレード
支払いの分析
オンライン決済
概要ユースケースを見つけるManaged Payments
Payment Links を使用する
決済ページを構築
    概要
    クイックスタート
    デザインをカスタマイズする
    追加情報を収集する
    税金を徴収する
    決済フローを動的に更新
    商品カタログを管理する
    サブスクリプション
    決済手段を管理
    顧客が現地通貨で支払いできるようにする
    割引、アップセル、オプション品目を追加する
      割引を追加する
      サブスクリプションアップセルを設定
      クロスセルの設定
      オプションアイテムを設定
      顧客が無料で注文できるようにします
      年間価格を月次で表示
    将来の支払いを設定する
    支払い中に支払い詳細を保存する
    サーバーで支払いを手動で承認する
    支払い後
    Elements with Checkout Sessions API ベータ版の変更ログ
    従来の Checkout からの移行
    Checkout を移行して Prices を使用
高度なシステムを構築
アプリ内実装を構築
決済手段
決済手段を追加
決済手段を管理
Link による購入の迅速化
支払いインターフェイス
Payment Links
Checkout
Web Elements
アプリ内 Elements
決済シナリオ
複数の通貨を扱う
カスタムの決済フロー
柔軟なアクワイアリング
オーケストレーション
店頭支払い
端末
決済にとどまらない機能
会社を設立する
仮想通貨
Financial Connections
Climate
ホーム支払いBuild a checkout pageAdd discounts, upsells, and optional items

無料の注文

無料の広告申込情報の注文を受け付けたり、1 回限りの支払いに 100% 割引を適用したりできます。

無料のラインアイテムを使用した 1 回限りの支払いや、クーポンと顧客向けプロモーションコードを使用した 100% オフの割引による無料注文を処理できます。

注

Checkout Sessions API を使用して無料の注文を処理するには、API バージョン 2023-08-16 以降が必要です。

無料のラインアイテムを含む Checkout セッションを作成する

unit_amount が 0 の Price を作成し、それを Checkout セッションの line items 配列に渡します。価格の作成の詳細については、商品および価格をご覧ください。

line_items 配列の price_data パラメーターを使用して無料の価格を渡すこともできます。

合計金額が 0 の場合、Checkout は顧客から決済手段を収集しません。

Command Line
cURL
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price_data][unit_amount]"=0 \ -d "line_items[0][price_data][product_data][name]"="Free t-shirt" \ -d "line_items[0][price_data][currency]"=usd \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" \ --data-urlencode cancel_url="https://example.com/cancel"

customer プロパティが設定されていない場合、 Checkout セッションは新しい Customer オブジェクトを自動的に作成します。これは、ゲスト顧客がサポートされていないことを意味します。

割引を作成する

または、クーポンとプロモーションコードを作成して、顧客が無料で注文を完了できるようにします。

クーポンを作成

Checkout セッションを無料にする Coupon を作成します。たとえば、100% 割引のクーポンを作成できます。

Command Line
cURL
curl https://api.stripe.com/v1/coupons \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d percent_off=100 \ -d duration=once

適用された割引でセッションを作成するには、discounts 配列の coupon パラメーターで coupon ID を渡します。

Command Line
cURL
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price_data][unit_amount]"=2000 \ -d "line_items[0][price_data][product_data][name]"=T-shirt \ -d "line_items[0][price_data][currency]"=usd \ -d "line_items[0][quantity]"=1 \ -d "discounts[0][coupon]"=
{{COUPON_ID}}
\ -d mode=payment \ --data-urlencode success_url="https://example.com/success" \ --data-urlencode cancel_url="https://example.com/cancel"

Checkout セッションの合計額以上の金額のクーポンを適用して、無料の Checkout セッションを作成することもできます。

プロモーションコードを作成する

プロモーションコードは、クーポン上に作成される顧客向けのコードです。これらのコードは顧客に共有することができ、顧客が Checkout に入力すると、割引の適用を受けることができます。100% 割引クーポンのプロモーションコードを作成して、顧客が無料で注文を作成できるようにします。

Command Line
cURL
curl https://api.stripe.com/v1/promotion_codes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d coupon=
{{COUPON_ID}}
\ -d code=FREECODE

Checkout セッションで allow_promotion_codes パラメーターを使用して、ユーザーが引き換えできるプロモーションコードを有効にします。これにより、Checkout にフィールドが表示され、ユーザーはそこにプロモーションコードを入力できるようになります。

Command Line
cURL
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price_data][unit_amount]"=2000 \ -d "line_items[0][price_data][product_data][name]"=T-shirt \ -d "line_items[0][price_data][currency]"=usd \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ -d allow_promotion_codes=true \ --data-urlencode success_url="https://example.com/success" \ --data-urlencode cancel_url="https://example.com/cancel"

顧客は、Checkout セッションの合計額以上の金額のクーポンを適用して、無料で購入することもできます。割引を適用する他の方法については、割引を追加をご覧ください。

完了した注文を処理する

Checkout セッションが完了したら、確定済みの項目とその数量に対するリクエストを作成できます。顧客が項目を削除した場合、項目のレスポンスからも削除されます。完了済みの Checkout セッションを処理するイベントハンドラの作成方法については、フルフィルメントガイドをご覧ください。

よくある間違い

無料注文のフルフィルメントを行うには、PaymentIntent イベントではなく、checkout.session.completed イベントを処理してください。支払いのない完了済みの Checkout セッションでは、PaymentIntent の関連付けが行われません。

完了済みの無料注文は、ダッシュボードで確認できます。無料注文タブは、無料注文が 1 件以上完了している場合にのみ表示されます。

オプション決済用の URL リンクと料金表

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか?llms.txt を読んでください。
Powered by Markdoc