無料の注文
無料の広告申込情報の注文を受け付けたり、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 セッションの合計額以上の金額のクーポンを適用して、無料で購入することもできます。割引を適用する他の方法については、割引を追加をご覧ください。
完了した注文を処理する
Checkout セッションが完了したら、確定済みの項目とその数量に対するリクエストを作成できます。顧客が項目を削除した場合、項目のレスポンスからも削除されます。完了済みの Checkout セッションを処理するイベントハンドラの作成方法については、フルフィルメントガイドをご覧ください。
よくある間違い
無料注文のフルフィルメントを行うには、PaymentIntent イベントではなく、checkout.
イベントを処理してください。支払いのない完了済みの Checkout セッションでは、PaymentIntent の関連付けが行われません。
完了済みの無料注文は、ダッシュボードで確認できます。無料注文タブは、無料注文が 1 件以上完了している場合にのみ表示されます。