メインコンテンツへスキップ
Dodo Paymentsは、トランザクション、サブスクリプション、返金、紛争、ライセンスキー管理に関連する重要なイベントについてリアルタイムのWebhook通知を提供します。以下は、これらのイベントの詳細ガイドであり、明確さのためにカテゴリ分けされており、実装のヒントと考慮事項が含まれています。

支払いイベント

イベント名イベントタイプ説明
支払い成功payment.succeeded支払いが正常に処理されたときにトリガーされます。
支払い失敗payment.failedエラー、拒否されたカード、またはその他の問題により支払いの試行が失敗したときに発生します。
支払い処理中payment.processing支払いが現在処理中であることを示します。
支払いキャンセルpayment.cancelled支払いが完了前にキャンセルされたときにトリガーされます。

返金イベント

イベント名イベントタイプ説明
返金成功refund.succeeded返金が正常に処理されたときにトリガーされます。
返金失敗refund.failed処理エラーやその他の問題により返金の試行が失敗したときに発生します。

紛争イベント

イベント名イベントタイプ説明
紛争開始dispute.opened顧客が紛争を開始したときにトリガーされます。
紛争期限切れdispute.expired解決されることなく紛争が期限切れになったことを示します。
紛争受理dispute.acceptedマーチャントが紛争を受理したときにトリガーされます。
紛争キャンセルdispute.cancelled顧客またはシステムによって紛争がキャンセルされたときに発生します。
紛争挑戦dispute.challengedマーチャントが紛争に挑戦したときにトリガーされます。
紛争勝利dispute.wonマーチャントが紛争に成功裏に勝利したことを示します。
紛争敗北dispute.lostマーチャントが紛争に敗北したときに発生します。

サブスクリプションイベント

イベント名イベントタイプ説明
サブスクリプションアクティブsubscription.activeサブスクリプションがアクティブになり、定期的な請求が予定されていることを示します。
サブスクリプション更新subscription.updatedサブスクリプションの任意のフィールドが更新されたときにトリガーされます(ポーリングなしのリアルタイム同期)。
サブスクリプション保留中subscription.on_hold更新の失敗によりサブスクリプションが一時的に保留されたときにトリガーされます。
サブスクリプション更新subscription.renewedサブスクリプションが正常に更新されたときに発生します。
サブスクリプションプラン変更subscription.plan_changedサブスクリプションがアップグレード、ダウングレード、または異なるアドオンで変更されたときにトリガーされます。
サブスクリプションキャンセルsubscription.cancelledマーチャントまたは顧客によってサブスクリプションがキャンセルされたときにトリガーされます。
サブスクリプション失敗subscription.failedサブスクリプションが失敗したことを示します。これは、私たちが権限を作成できなかったことを意味します。
サブスクリプション期限切れsubscription.expiredサブスクリプションがその期間の終わりに達し、期限切れになったときにトリガーされます。

ライセンスキーイベント

イベント名イベントタイプ説明
ライセンスキー作成license_key.created製品のために新しいライセンスキーが作成されたときにトリガーされます。
これらのWebhookイベントは、マーチャントが運営を効果的に管理するための重要な更新を提供するように設計されています。Webhook統合において、各関連イベントのために堅牢なハンドラーを実装して、スムーズで信頼性の高い機能を確保してください。