無料の注文
無料の広告申込情報の注文を受け付けたり、1 回限りの支払いに 100% 割引を適用したりできます。
無料のラインアイテムを使用した 1 回限りの支払いや、クーポンと顧客向けプロモーションコードを使用した 100% オフの割引による無料注文を処理できます。
注
Checkout Sessions API を使用して無料の注文を処理するには、API バージョン 2023-08-16 以降が必要です。
無料のラインアイテムを含む Checkout セッションを作成する
unit_amount が 0 の Price を作成し、それを Checkout セッションの line items 配列に渡します。価格の作成の詳細については、商品および価格をご覧ください。
line_ 配列の price_data パラメーターを使用して無料の価格を渡すこともできます。
合計金額が 0 の場合、Checkout は顧客から決済手段を収集しません。
customer プロパティが設定されていない場合、 Checkout セッションは新しい Customer オブジェクトを自動的に作成します。これは、ゲスト顧客がサポートされていないことを意味します。
割引を作成する
または、クーポンとプロモーションコードを作成して、顧客が無料で注文を完了できるようにします。
クーポンを作成
Checkout セッションを無料にする Coupon を作成します。たとえば、100% 割引のクーポンを作成できます。
適用された割引でセッションを作成するには、discounts 配列の coupon パラメーターで coupon ID を渡します。
Checkout セッションの合計額以上の金額のクーポンを適用して、無料の Checkout セッションを作成することもできます。
プロモーションコードを作成する
プロモーションコードは、クーポン上に作成される顧客向けのコードです。これらのコードは顧客に共有することができ、顧客が Checkout に入力すると、割引の適用を受けることができます。100% 割引クーポンのプロモーションコードを作成して、顧客が無料で注文を作成できるようにします。
Checkout セッションで allow_promotion_codes パラメーターを使用して、ユーザーが引き換えできるプロモーションコードを有効にします。これにより、Checkout にフィールドが表示され、ユーザーはそこにプロモーションコードを入力できるようになります。
顧客は、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. 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.