Stripe Issuing と Stripe Treasury の Webhook
Stripe Issuing と Stripe Treasury の Webhook イベントと、このイベントが発生する状況についてご紹介します。
Stripe uses webhooks to notify your application when an event happens in your account. Use webhooks to handle asynchronous events such as the creation of an Issuing authorization or an ACH transfer. To view the Financial Accounts for platforms-related webhook events, log in to your Stripe account with Financial Accounts for platforms enabled.
Issuing の Webhook イベント
以下の表は、Issuing に関するウェブフックイベントを一覧にしたものです。
注
Connect webhooks are for activity on any connected account. All events on the connected account are sent to the Connect webhooks. This includes the events generated by Financial Accounts for platforms and Issuing integrations. For more information see 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 残高を反映します |
Financial Accounts for platforms webhook events
The following table lists the webhook events for Financial Accounts for platforms and when they occur.
| イベント | 説明 |
|---|---|
| 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 のベストプラクティスをご覧ください。