カスタム決済手段に対する対応を追加

新機能

カスタム決済手段を作成し、Stripe 外で処理される決済手段を使用するように決済導入を拡張できるようになりました。Stripe が直接サポートする決済手段タイプの一覧については、決済手段の概要ページをご覧ください。

stripe でカスタム決済手段を作成して、サードパーティーの決済代行業者によって処理された決済手段を表すことができるようになりました。stripe の外部でカスタム決済手段の取引を処理する場合、カスタム決済手段と決済記録を使用して、取引の詳細を stripe アカウントに記録できます。

カスタム決済手段タイプを作成するには:

ダッシュボードでカスタム決済手段ページを開きます。
作成をクリックします。
コピーする既存のタイプを選択するか、Provide a Custom name and icon (カスタムの名前とアイコンを指定) をクリックします。
カスタムの名前とアイコンを指定する場合は、表示名を入力し、ロゴアイコンをアップロードします。
規約を読んで同意し、作成をクリックします。タイプのリストで、カスタム決済手段タイプの ID (cpmt_ で始まる) を書き留めます。カスタムタイプの決済手段を作成するには、その タイプ を カスタム に、Custom.type をカスタムタイプの ID に設定します。

カスタムの決済手段は、Payment Intents または Setup Intents と互換性がありません。

カスタム決済手段の作成の詳細については、決済手段 API の作成を参照してください。

カスタムの決済手段にサードパーティーの決済代行業者を利用するには、サードパーティーの決済代行業者と連携するをご覧ください。

カスタムの決済手段で決済履歴を利用するには、payment_method_details で決済の試行を報告します。

パラメーター	変更する	リソースまたはエンドポイント
custom	追加済み	PaymentMethod PaymentMethod#create
値	変更する	列挙値
custom	追加済み	ConfirmationToken.payment_method_preview PaymentMethod
custom	追加済み	Customer#list_payment_methods PaymentMethod#list PaymentMethod#create

Workbench で現在の API バージョンを表示します。
SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
- SDK を使用していない場合は、Stripe-Version: 2025-10-29.clover を含めるように API リクエストを更新してください。
Webhook エンドポイントに使用する API バージョンをアップグレードします。
新しいバージョンに対して、実装内容をテストします。
Connect を使用する場合は、Connect の実装内容をテストします。
Workbench でアップグレードを実行します。バージョンをロールバックできるのは 72 時間以内です。

Stripe API のアップグレードについて、詳細をご確認ください。