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

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

Payment Links は「標準の料金体系」 (1 回限りの決済でも継続決済でも単位ごとに同額を請求) と「顧客の選択による価格」 (顧客が価格を指定できるようにする) のみに対応しています。パッケージ料金体系、段階的な料金体系、数量ベースの料金体系などの高度なオプションには対応していません。現在、Swish は継続支払いには対応していません。また、現在「顧客の選択による価格」は継続支払いや寄付には対応していません。

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 はダッシュボードで有効になっている関連のある支払い方法を選択します。対応する支払い方法を追加するには、支払い方法の設定で有効化します。