コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成サインイン
導入方法
決済管理
売上管理
プラットフォームとマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

PayTo 支払いの事前設定

PayTo 支払いを事前設定する方法をご紹介します。

PayTo を使用すると、オーストラリアの顧客は、バンキングアプリで 1 回限りの決済と継続課金の PayTo 同意書を認証できます。 顧客 は、保留中の同意書リクエストについての通知を受け取り、同意書規約を承認してからアプリに戻ります。

将来の決済に備えて PayTo 同意書を設定することで、将来の決済の収集に向けて現時点で顧客の承認を得ることができます。顧客はバンキングアプリで PayTo の同意書を表示、管理、一時停止、取り消すことができます。

注意

Stripe は、顧客による PayTo 同意書の変更や一時停止に対応していません。顧客が同意書を一時停止または変更しようとした場合、同意書をキャンセルし、mandate.updated Webhook] を送信します。Webhook を受信すると、顧客に連絡して、顧客が同意書を調整した理由を確認し、新しい同意書を設定できます。

支払いを設定する

メモ

このガイドは、決済導入の基本的な今後の支払いの設定に基づいています。

Payto を支払い方法として有効にするには、新しい Checkout セッション を作成してください。

  1. モードを setup に設定します。
  2. 決済手段オプションを使用して顧客に同意させる同意書の規約を指定します。
  3. payto を payment_method_types のリストに追加します。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d customer=
"{{CUSTOMER_ID}}"
\ -d mode=setup \ -d "payment_method_options[payto][mandate_options][amount_type]"=maximum \ -d "payment_method_options[payto][mandate_options][payment_schedule]"=annual \ -d "payment_method_options[payto][mandate_options][amount]"=150000 \ -d "payment_method_options[payto][mandate_options][payments_per_period]"=13 \ -d "payment_method_options[payto][mandate_options][start_date]"=2026-12-25 \ -d "payment_method_options[payto][mandate_options][end_date]"=2036-12-25 \ -d "payment_method_options[payto][mandate_options][purpose]"=mortgage \ -d "payment_method_types[]"=card \ -d "payment_method_types[]"=payto \ --data-urlencode success_url="https://example.com/success"

Stripe はさまざまな種類の同意書に対応し、同意書の金額、期間、頻度、目的を管理できます。できる限り要件に一致する同意書規約を指定してください。これらの詳細な条件は承認時に顧客に表示されるため、正確にすることで購入率を向上できます。

Stripe は、 加盟店カテゴリーコード (MCC) に基づいて、デフォルトの purpose を推定します。デフォルト値が同意書の目的を正確に表していない場合は、有効な値のいずれかを使用してこのフィールドを上書きできます。purposeを指定しない場合のデフォルト値は、Mandate オブジェクトで確認できます。

PayTo PaymentMethod に後で請求する

顧客に支払いを行う前に、Checkout Session から同意書 ID、顧客 ID、支払い方法 ID を使用して SetupIntent を取得し、同意書 ID、顧客 ID、支払い方法 ID を確認します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/setup_intents/
{{SETUP_INTENT_ID}}
\ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

以下のレスポンスで必要な ID を確認してください。

{ // ... "customer": "cus_PW6rQWRGAaBD7z", // <---- Here is the customer "mandate": "mandate_1Ok6ZrA8DuEjWaGw2nrO9xeS", // <---- Here is the mandate "metadata": {}, "next_action": null, "on_behalf_of": null, "payment_method": "pm_1Ok4l9A8DuEjWaGwhB4SGrWh", // <---- Here is the payment method "payment_method_configuration_details": null, "payment_method_options": { "payto": { "mandate_options": { "amount": 150000, "amount_type": "maximum", "start_date": "2026-12-25", "end_date": "2036-12-25", "payment_schedule": "annual", "payments_per_period": 13, "purpose": "mortgage", } } }, "payment_method_types": [ "payto" ], "single_use_mandate": null, "status": "succeeded", "usage": "off_session" // ... }

PaymentMethod、同意書、顧客 ID を使用して PaymentIntent を作成します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "payment_method_types[]"=payto \ -d amount=1099 \ -d currency=aud \ -d customer=
"{{CUSTOMER_ID}}"
\ -d payment_method=
"{{PAYMENT_METHOD_ID}}"
\ -d mandate=
"{{MANDATE_ID}}"
\ -d confirm=true

注文のフルフィルメント

決済受け付け後に、注文のフルフィルメントを実行する方法を説明します。

実装内容をテストする

以下のさまざまなテスト用 PayID と銀行口座情報を使用して、テスト API キーで PayTo の実装内容をテストします。各セットによって、本番環境でシステムが直面する各種シナリオが再現されています。

PayID説明
{any_prefix}+succeed@{any_domain}PaymentIntent のステータスは、requires_action から 10 秒後に processing に移行し、さらに 5 秒後に succeeded に移行します。同意書は active 状態になります。
{any_prefix}+decline@{any_domain}PaymentIntent のステータスは、requires_action から 10 秒後に requires_payment_method に移行します。Stripe は payment_method_provider_decline エラーコードと invalid_authorization 拒否コードを返します。同意書は inactive 状態になります。
{any_prefix}+expire@{any_domain}PaymentIntent のステータスは、requires_action から 10 秒後に requires_payment_method に移行します。Stripe は payment_method_provider_decline エラーコードと generic_decline 拒否コードを返します。同意書は inactive 状態になります。
{any_prefix}+insufficient_funds@{any_domain}PaymentIntent のステータスは、10 秒後に requires_action から processing に移行し、さらに 5 秒後に requires_payment_method に移行します。Stripe は、 payment_method_provider_decline エラーコードと insufficient_funds 拒否コードを返します。同意書のステータスは inactive になります。
{any_prefix}+revoke@{any_domain}PaymentIntent のステータスは、requires_action から 10 秒後に processing に移行し、さらに 5 秒後に succeeded に移行します。同意書は active 状態で開始し、1 分後に inactive 状態に移行します。
{any_prefix}+agreement_type_not_supported@{any_domain}PaymentIntent のステータスは、10 秒後に requires_action から requires_payment_method に移行します。Stripe は、payment_method_provider_decline エラーコードを返します。同意書のステータスは inactive になります。
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc