コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
決済にとどまらない機能

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

API で決済用の URL リンクを作成し、管理します。

Payment Links API を使用して、顧客と共有できる決済用の URL リンクを作成します。Stripe は、このリンクを開いた顧客を、Stripe がオンラインで提供する決済ページにリダイレクトします。

商品カタログを設定する

Payment Links は、Product (商品) と Price (価格) を使用して、ビジネスの販売対象をモデル化します。Payment Links の使用を開始するには、商品を作成してから、その商品を使用して価格を作成します。または、単発の価格または 1 回限りの商品をその場で作成する場合は、この手順を飛ばして手順 2 の price_data を使用できます。

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

固定額の商品またはサブスクリプションを作成するには、_定額料金_を使用してください。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 (または price_data) と quantity が含まれます。決済用の URL リンクに含めることができる項目は、定額料金を使用する場合は最大 20 個、「顧客の選択による価格」を使用する場合は 1 個です。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 にリダイレクトするか、カスタムメッセージを表示できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 はダッシュボードで有効になっている関連のある支払い方法を選択します。対応する支払い方法を追加するには、支払い方法の設定で有効化します。

オプションクーポンとプロモーションコードの使用を許可する

決済用の URL リンク用のクーポンとプロモーションコードは、ダッシュボードまたは Promotion Code API (プロモーションコード API) で作成できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 allow_promotion_codes=true

オプション決済用リンクで税金を徴収する

Payment Links は Stripe Tax と連携して支払いに関する税金を計算し、徴収します。Stripe Tax は、税率やルールを定義しなくても取引の税金を自動的に計算する有料プロダクトです。

開始するには、ダッシュボードで Stripe Tax の本番環境利用を申請します。Stripe Tax を設定したら、新しい決済用の URL リンクでこれを有効にできます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 "automatic_tax[enabled]"=true

商品カタログを Stripe Tax と連携させるための設定方法については、商品税コードと税金処理を指定するで詳細をご覧ください。

オプション請求先住所と配送先住所を収集する

決済用の URL リンクは、購入の完了に必要な場合に顧客の請求先住所を自動的に収集します。また、billing_address_collection を指定して、常に請求先住所を収集するように決済用の URL リンクを更新することもできます。あるいは、shipping_address_collection を使用してサポート対象の国を指定することで、顧客の配送先住所を収集することもできます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US

配送先住所を収集している場合は、shipping_options の配列を渡すことで、決済用のリンクに配送料金を追加することもできます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d "shipping_options[0][shipping_rate]"=
"{{SHIPPING_RATE_ID}}"

オプション数量の調整を許可する

購入する商品の数量を顧客が更新できるようにするには、ラインアイテムに adjustable_quantity を指定します。顧客が購入できる最小数量と最大数量を設定することもできます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 "line_items[0][adjustable_quantity][enabled]"=true \
  -d "line_items[0][adjustable_quantity][minimum]"=1 \
  -d "line_items[0][adjustable_quantity][maximum]"=10

オプションサブスクリプションを作成する

決済用の URL リンクを使用してサブスクリプションを作成するには、line_items に type=recurring を設定して価格を指定します。subscription_data を使用して、決済用の URL リンクから作成されるサブスクリプション (トライアルを含む) の設定を指定できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 "subscription_data[trial_period_days]"=7

オプション受け付ける支払い方法を指定する

決済用の URL リンクの作成時に payment_method_types パラメーターを設定して、別の支払い方法のセットを指定します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=klarna

口座引き落としや店舗支払いなどの一部の支払い方法では、決済確定までに 2 ～ 14 日かかる場合があります。Webhook を設定することで、決済完了後に通知を受け取り、フルフィルメントを開始できるようになります。

顧客がこれらの方法をデバイスで有効にしていた場合、Apple Pay または Google Pay オプションが表示されます。顧客に表示される支払い方法は、顧客が使用しているブラウザーによっても異なります。

オプション利用規約への同意を収集する

consent_collection.terms_of_service を required に設定することで、顧客から利用規約への同意を収集できます。これにより利用規約への顧客の同意を収集するチェックボックスと、Stripe ダッシュボードの公開情報に設定された利用規約への URL に顧客を移動するリンクが表示されます。

consent_collection.terms_of_service を none に設定すると、Checkout ではチェックボックスが表示されず、顧客は利用規約の承認を求められません。

規約への同意を求める前に、ビジネスの公開情報で利用規約の URL を設定してください。プライバシーポリシーの URL の設定はオプションです。プライバシーポリシーの URL が公開情報に設定されている場合、Checkout はプライバシーポリシーにもリンクされます。

Command Line
curl
Ruby
Python
PHP
Node.js
No results
curl https://api.stripe.com/v1/payment_links \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[0]"=card \
  -d "line_items[0][price]"=
'{{PRICE_ID}}'
 \
  -d "line_items[0][quantity]"=2 \
  -d "consent_collection[terms_of_service]"="required"

オプションカスタムフィールドを追加する

注意

カスタムフィールドは、保護対象のデータ、機密データ、法律によって制限されている情報の収集には使用しないでください。

カスタムフィールドの配列を指定する際に、決済用リンクを作成します。各フィールドには、導入時にフィールドの照合に使用する一意の key が必要です。また、顧客に表示するフィールドのラベルも指定してください。カスタムフィールドのラベルは翻訳されませんが、locale URL パラメーターを使用して、決済用リンクの言語をラベルの言語に一致させることができます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 "custom_fields[0][key]"=engraving \
  -d "custom_fields[0][label][type]"=custom \
  -d "custom_fields[0][label][custom]"="Personalized engraving" \
  -d "custom_fields[0][type]"=text

顧客が Checkout セッションを完了すると、ダッシュボードの決済詳細ページでフィールドが使用可能になり、また完了したカスタムフィールドを取得できます。

オプションConnect を使用してプラットフォーム手数料を回収する

決済用のリンクで行われたすべての支払いにおいてプラットフォーム手数料を回収できます。Payment Links API でプラットフォーム手数料を回収する方法については、ガイドをご覧ください。

オプション支払い後の請求書を送信する

1 回限りの支払いを成功させるために、Payment Links で詳細な請求書を顧客に送信するように設定できます。Payment Links での 1 回限りの支払いの請求書の作成は、Invoicing の機能であり、別途料金が請求されます。

注

サブスクリプションの Payment Links では請求書が自動作成されるため、追加の設定は必要ありません。

Payment Links で請求書を作成できるようにするには、invoice_creation[enabled] を true に設定します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 "invoice_creation[enabled]"=true

請求書をカスタマイズするには、invoice_creation 内で invoice_data ハッシュを使用します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 "invoice_creation[enabled]"=true \
  -d "invoice_creation[invoice_data][description]"="Invoice for Product X" \
  -d "invoice_creation[invoice_data][metadata][order]"=order-xyz \
  -d "invoice_creation[invoice_data][account_tax_ids][0]"=DE123456789 \
  -d "invoice_creation[invoice_data][custom_fields][0][name]"="Purchase Order" \
  -d "invoice_creation[invoice_data][custom_fields][0][value]"=PO-XYZ \
  -d "invoice_creation[invoice_data][rendering_options][amount_tax_display]"=include_inclusive_tax \
  -d "invoice_creation[invoice_data][footer]"="B2B Inc."

セッション後、Stripe は顧客が決済時に指定したメールアドレスに請求書のサマリーを送信します。請求書のサマリーには請求書の PDF とその請求書の領収書をダウンロードできるリンクが記載されています。

テスト API キーを使用して作成された支払いの領収書は自動送信されません。ダッシュボードを使用して領収書を表示したり、手動で送信します。

顧客が請求書のサマリーメールからダウンロードできる、請求書 PDF のスクリーンショット

顧客が請求書 PDF をダウンロードできるようにする

顧客が請求書のサマリーメールからダウンロードできる、請求書に対する領収書のスクリーンショット

顧客が請求書の領収書をダウンロードできるようにする

Stripe が送信する請求書サマリーメールのスクリーンショット

請求書 PDF または領収書をダウンロードするためのリンクをメールで送信する

このページはお役に立ちましたか。
はいいいえ