コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つける
決済ページを構築
支払い方法
Payment interfaces
Payment scenarios
対面支払い
Other Stripe products

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

無料の注文

無料のラインアイテムの注文を受け付け、支払いモードで 100% 割引を適用します。

Checkout では、1 回限りの支払いで無料の注文を処理できます。これには無料のラインアイテムや 100% の割引を使用します。合計金額が 0 の場合、Checkout は顧客から支払い方法を収集しません。

注

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

無料のラインアイテムを指定して Checkout セッションを作成する

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

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

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 https://api.stripe.com/v1/coupons \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d percent_off=100 \
  -d duration=once

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

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d coupon={{COUPON_ID}} \
  -d code=FREECODE

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

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 セッションの合計額以上の金額のクーポンを適用して、無料で購入することもできます。割引を適用する他の方法については、割引を追加をご覧ください。

完了した注文を処理する

After the Checkout Session completes, you can make a request for the finalized line items and their quantities. If your customer removes a line item, it also removes it from the line items response. See the Fulfillment guide to learn how to create an event handler to handle completed Checkout Sessions.

よくある間違い

To fulfill no-cost orders, make sure to handle the checkout.session.completed event rather than PaymentIntent events. Completed Checkout Sessions that are free won’t have an associated PaymentIntent.

You can see your completed no-cost orders in the Dashboard. The no-cost orders tab only appears if you have at least one completed no-cost order.

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
Stripe の製品変更ログを確認してください。
ご不明な点がございましたら、お問い合わせください。
Powered by Markdoc
このページの内容
無料のラインアイテムを指定して Checkout セッションを作成する
割引を作成する
クーポンを作成
プロモーションコードを作成する
完了した注文を処理する
使用製品
Checkout
Payments