API を使用して決済用の URL リンクを作成して管理する

Payment Links は、Product (商品) と Price (価格) を使用して、ビジネスの販売対象をモデル化します。Payment Links の使用を開始するには、商品を作成してから、その商品を使用して価格を作成します。

Payment Links は、定額、段階制、パッケージ、顧客選択型 (顧客が料金を指定可能) の料金に対応しています。現在、_顧客選択型の料金_は継続支払いや寄付に対応していません。

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=1000 \
  -d product=
{{PRODUCT_ID}}

決済用の URL リンクを作成するには、line_items を渡します。各ラインアイテムには price と quantity が含まれます。決済用の URL リンクに含めることができるラインアイテムは、標準の料金体系を使用する場合は最大 20 個、「顧客の選択による価格」を使用する場合は 1 個です。

curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1

決済用のリンクのそれぞれに url があります。それをメール、ソーシャルメディア、ウェブサイトのリンク、アプリ、その他のチャネルを通じて顧客に伝えることができます。

顧客が決済用の URL リンクを使用して支払いを完了すると、フルフィルメントと消し込みに使用できる checkout.session.completed Webhook が Stripe から送信されます。

口座引き落としや店舗支払いのように、決済確定までに 2 ～ 14 日かかる支払い方法を有効化した場合は、追加の Webhook をリッスンするようにしてください。詳細については、顧客の決済後に注文のフルフィルメントを実行するためのガイドをご覧ください。

顧客が購入を完了したら、決済用の URL リンクで after_completion を設定して、URL にリダイレクトするか、カスタムメッセージを表示できます。

curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "after_completion[type]"=redirect \
  --data-urlencode "after_completion[redirect][url]"="https://example.com"

決済用の URL リンクは、一度作成すると削除できません。active 属性に false を設定し、無効にすることはできます。

リンクを無効にすると、以降顧客はそのリンクを使用して購入を確定できなくなり、有効期限ページにリダイレクトされます。無効にした決済用の URL リンクを再利用するには、active 属性を true に設定して、再度有効にします。

デフォルトで、Stripe はダッシュボードで有効になっている関連のある支払い方法を選択します。対応する支払い方法を追加するには、支払い方法の設定で有効化します。