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

支払いイベント

Event NameEvent TypeDescription
Payment Succeededpayment.succeeded支払いが正常に処理されたときにトリガーされます。
Payment Failedpayment.failedエラー、カードの拒否、その他の理由で支払い試行が失敗したときに発生します。
Payment Processingpayment.processing支払いが現在処理されていることを示します。
Payment Cancelledpayment.cancelled支払いが完了する前にキャンセルされたときにトリガーされます。

返金イベント

Event NameEvent TypeDescription
Refund Succeededrefund.succeeded払い戻しが正常に処理されたときにトリガーされます。
Refund Failedrefund.failed処理エラーやその他の理由で払い戻し試行が失敗したときに発生します。

紛争イベント

Event NameEvent TypeDescription
Dispute Openeddispute.opened顧客が異議を申し立てたときにトリガーされます。
Dispute Expireddispute.expired解決されないまま異議の期限が切れたことを示します。
Dispute Accepteddispute.accepted出品者が異議を受け入れたときにトリガーされます。
Dispute Cancelleddispute.cancelled顧客またはシステムによって異議がキャンセルされたときに発生します。
Dispute Challengeddispute.challenged出品者が異議に異議を唱えたときにトリガーされます。
Dispute Wondispute.won出品者が異議を勝利したことを示します。
Dispute Lostdispute.lost出品者が異議に敗北したときに発生します。

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

Event NameEvent TypeDescription
Subscription Activesubscription.activeサブスクリプションがアクティブになり、定期請求が予定されていることを示します。
Subscription Updatedsubscription.updatedサブスクリプションの任意のフィールドが更新されたときにトリガーされます(ポーリング不要のリアルタイム同期)。
Subscription On Holdsubscription.on_hold更新の失敗によりサブスクリプションが一時的に保留になったときにトリガーされます。
Subscription Renewedsubscription.renewedサブスクリプションが正常に更新されたときに発生します。
Subscription Plan Changedsubscription.plan_changedサブスクリプションがアップグレード、ダウングレード、または異なるアドオンで変更されたときにトリガーされます。
Subscription Cancelledsubscription.cancelled出品者または顧客によってサブスクリプションがキャンセルされたときにトリガーされます。
Subscription Failedsubscription.failedサブスクリプションの作成に失敗したことを示します。マンダートの作成ができなかったことを意味します。
Subscription Expiredsubscription.expiredサブスクリプションが契約期間の終了に達し、期限切れになったときにトリガーされます。

ライセンスキーイベント

Event NameEvent TypeDescription
License Key Createdlicense_key.created製品の新しいライセンスキーが作成されたときにトリガーされます。

Credit Events

Event NameEvent TypeDescription
Credit Addedcredit.addedサブスクリプション、一括、アドオン、または API 経由で顧客にクレジットが付与されたときにトリガーされます。
Credit Deductedcredit.deducted使用または手動のデビットによりクレジットが消費されたときに発生します。
Credit Expiredcredit.expired設定された有効期限経過後に未使用のクレジットが失効したときにトリガーされます。
Credit Rolled Overcredit.rolled_overサイクル終了時に未使用のクレジットが新しい付与に繰り越されたときに発生します。
Rollover Forfeitedcredit.rollover_forfeited最大繰り越し回数に到達したためクレジットが没収されたときにトリガーされます。
Overage Chargedcredit.overage_chargedゼロ残高を超える使用に対して追加料金が課されたときに発生します。
Manual Adjustmentcredit.manual_adjustment手動でクレジットまたはデビットの調整が行われたときにトリガーされます。
Balance Lowcredit.balance_low設定されたしきい値を下回ってクレジット残高が低下したときにトリガーされます。
これらの webhook イベントは、マーチャントが業務を効果的に管理するための重要な更新を提供するよう設計されています。関連する各イベントについて堅牢なハンドラを webhook 統合に実装し、スムーズで信頼性の高い機能を確保してください。