Stripe Issuing およびプラットフォーム向け金融口座の Webhooks
Stripe Issuing およびプラットフォーム向け金融口座の Webhook イベントとその発生理由について説明します。
Stripe アカウントで イベント が発生すると、Webhook を使って申し込みに通知します。Issuing オーソリの作成 や ACH 送金などの非同期 イベント を処理するには、Webhook を使用します。Financial Accounts for platforms 関連の Webhook イベントを表示するには、Financial Accounts for platforms を有効にして Stripe アカウントにログインしてください。
Issuing の Webhook イベント
以下の表は、Issuing に関するウェブフックイベントを一覧にしたものです。
メモ
Connect Webhooks は、任意の連結アカウントのアクティビティ用です。連結アカウント上のすべてのイベントは Connect Webhooks に送信されます。これには、プラットフォーム向け金融口座と Issuing 導入によって生成されたイベントが含まれます。詳細については、Connect Webhooks をご覧ください。
| イベントタイプ | 説明 | 注 |
|---|---|---|
| issuing_authorization.created | オーソリが作成されるたびに発生します。 | |
| issuing_authorization.request | オーソリの同期リクエストを表します。実装を使用してオーソリリクエストを処理する方法をご覧ください。アクセスするには、このイベントタイプに明示的に登録する Webhook エンドポイントを作成する必要があります。すべてのイベントに登録された Webhook エンドポイントには、このイベントタイプは含まれません。 | |
| issuing_authorization.updated | オーソリが更新されるたびに発生します。 | |
| issuing_card.created | カードが作成されるたびに発生します。 | |
| issuing_card.updated | カードが更新されるたびに発生します。 | |
| issuing_cardholder.created | カード保有者が作成されるたびに発生します。 | |
| issuing_cardholder.updated | カード保有者が更新されるたびに発生します。 | |
| issuing_dispute.closed | 不審請求の申請で主張が認められた、主張が認められなかった、または有効期限が切れたときに発生します。 | |
| issuing_dispute.created | 不審請求の申請が作成されるたびに発生します。 | |
| issuing_dispute.funds_reinstated | 資金が Issuing 残高に送金されるたびに発生します (通常は、主張が認められた不審請求の申請のステータスに関連付けられます)。 | |
| issuing_dispute.submitted | 不審請求の申請が提出されるたびに発生します。 | |
| issuing_dispute.updated | 不審請求の申請が更新されるたびに発生します。 | |
| issuing_transaction.created | Isuing 取引が作成されるたびに発生します。 | |
| issuing_transaction.updated | Issuing 取引が更新されるたびに発生します。 | |
| topup.created | トップアップ (資金の追加) が作成されるたびに発生します。 | Issuing 専用の実装にのみ関連しています。 |
| topup.canceled | トップアップ (資金の追加) がキャンセルされるたびに発生します。 | |
| topup.failed | トップアップ (資金の追加) が失敗するたびに発生します。 | |
| topup.reversed | トップアップが差戻しされるたびに発生します。 | |
| topup.succeeded | トップアップが行われるたびに発生します。 | |
| balance_transfer.created | 新しい残高送金 API: アクワイアリングから Issuing に資金を送金します | |
| balance.available | 残高送金の後で更新された新しい Stripe 残高と Issuing 残高を反映します |
プラットフォーム向け金融口座の Webhook イベント
以下の表は、プラットフォーム向け金融口座の Webhook イベントとその発生時期の一覧です。
| イベント | 説明 |
|---|---|
| treasury.credit_reversal.created | CreditReversal が作成されるたびに発生します。 |
| treasury.credit_reversal.posted | CreditReversal が転記されるたびに発生します。 |
| treasury.debit_reversal.completed | DebitReversal が完了するたびに発生します。 |
| treasury.debit_reversal.created | DebitReversal が作成されるたびに発生します。 |
| treasury.debit_reversal.initial_credit_granted | DebitReversal で初期クレジットが付与されるたびに発生します。 |
| treasury.financial_account.closed | FinancialAccount のステータスが closed になるたびに発生します。 |
| treasury.financial_account.created | 新しい FinancialAccount が作成されるたびに発生します。 |
| treasury.financial_account.features_status_updated | 既存の FinancialAccount の機能のステータスが更新されるたびに発生します。 |
| treasury.inbound_transfer.canceled | InboundTransfer がキャンセルされるたびに発生します。 |
| treasury.inbound_transfer.created | InboundTransfer が作成されるたびに発生します。 |
| treasury.inbound_transfer.failed | InboundTransfer が失敗するたびに発生します。 |
| treasury.inbound_transfer.succeeded | InboundTransfer が成功するたびに発生します。 |
| treasury.outbound_payment.canceled | OutboundPayment がキャンセルされるたびに発生します。 |
| treasury.outbound_payment.created | 新しい OutboundPayment が正常に作成されるたびに発生します。 |
| treasury.outbound_payment.expected_arrival_date_updated | OutboundPayment の入金予定日が更新されるたびに発生します。 |
| treasury.outbound_payment.failed | OutboundPayment が失敗するたびに発生します。 |
| treasury.outbound_payment.posted | OutboundPayment が転記されるたびに発生します。 |
| treasury.outbound_payment.returned | OutboundPayment が返されるたびに発生します。 |
| treasury.outbound_payment.tracking_details_updated | OutboundPayment の tracking_details が更新されるたびに発生します。 |
| treasury.outbound_transfer.canceled | OutboundTransfer がキャンセルされるたびに発生します。 |
| treasury.outbound_transfer.created | OutboundTransfer が作成されるたびに発生します。 |
| treasury.outbound_transfer.expected_arrival_date_updated | OutboundTransfer の入金予定日が更新されるたびに発生します。 |
| treasury.outbound_transfer.failed | OutboundTransfer が失敗するたびに発生します。 |
| treasury.outbound_transfer.posted | OutboundTransfer が転記されるたびに発生します。 |
| treasury.outbound_transfer.returned | OutboundTransfer が返されるたびに発生します。 |
| treasury.outbound_transfer.tracking_details_updated | OutboundTransfer の tracking_details が更新されるたびに発生します。 |
| treasury.received_credit.created | 別のアカウントによって資金が送金された結果として received_credit が作成されるたびに発生します。 |
| treasury.received_credit.failed | received_credit は、失敗状態になるたびに表示されます。これは、小切手の受け付けにのみ適用されます。 |
| treasury.received_credit.succeeded | received_credit は、成功状態になるたびに表示されます。これは、小切手の受け付けにのみ適用されます。 |
| treasury.received_debit.created | 別のアカウントによって資金が引き出された結果として received_debit が作成されるたびに発生します。 |
Connect アカウント登録の Webhook イベント
以下の Webhook イベントは、Connect アカウント登録時に発生することがあります。
- Account.updated
- Persons.updated
- Capability.updated
詳細については、連結アカウントに対する API コールの実行を参照してください。
Financial Connections Webhook イベント
Financial Connections Webhook を参照してください。これらの Webhook は、連結アカウントが Financial Connections を使用して、外部銀行口座を即座に確認し InboundTransfers を有効にする場合に関連します。
Webhook イベントのベストプラクティス
Webhook のベストプラクティスの詳細については、Webhook のベストプラクティスをご覧ください。