はじめに
支払いイベントが発生したときに、ウィンドミルでカスタムワークフローとスクリプトを実行します。データベース操作を実行し、通知を送信し、データを処理し、ウィンドミルの強力なワークフローエンジンを使用して複雑なビジネスロジックを自動化します。
この統合には、ワークフロー設定からのウィンドミルのWebhook URLが必要です。
はじめに
Webhookセクションを開く
Dodo Paymentsのダッシュボードで、Webhooks → + エンドポイントを追加に移動し、統合のドロップダウンを展開します。 ウィンドミルを選択
ウィンドミル統合カードを選択します。
ウィンドミルワークフローを作成
ウィンドミルで新しいワークフローを作成し、トリガー設定からWebhook URLをコピーします。
Webhook URLを貼り付け
エンドポイント設定にウィンドミルのWebhook URLを貼り付けます。
変換を設定
イベントをウィンドミルワークフロー用にフォーマットするために変換コードを編集します。
テストと作成
サンプルペイロードでテストし、作成をクリックして統合を有効にします。
完了！
🎉 支払いイベントが自動的にウィンドミルのワークフローをトリガーします。
変換コードの例
基本ワークフローペイロード
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.payload = {
event_type: webhook.eventType,
payment_id: p.payment_id,
amount: (p.total_amount / 100).toFixed(2),
currency: p.currency || "USD",
customer_email: p.customer.email,
customer_name: p.customer.name,
payment_method: p.payment_method || "unknown",
timestamp: webhook.payload.timestamp,
metadata: {
business_id: p.business_id,
product_id: p.product_id
}
};
}
return webhook;
}
サブスクリプションワークフロー処理
function handler(webhook) {
const s = webhook.payload.data;
switch (webhook.eventType) {
case "subscription.active":
webhook.payload = {
event_type: "subscription_started",
subscription_id: s.subscription_id,
customer_email: s.customer.email,
customer_name: s.customer.name,
product_id: s.product_id,
amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
frequency: s.payment_frequency_interval,
next_billing: s.next_billing_date,
customer_id: s.customer.customer_id,
timestamp: webhook.payload.timestamp
};
break;
case "subscription.cancelled":
webhook.payload = {
event_type: "subscription_cancelled",
subscription_id: s.subscription_id,
customer_email: s.customer.email,
cancelled_at: s.cancelled_at,
cancel_at_next_billing: s.cancel_at_next_billing_date,
customer_id: s.customer.customer_id,
timestamp: webhook.payload.timestamp
};
break;
}
return webhook;
}
争議ワークフロー処理
function handler(webhook) {
if (webhook.eventType.startsWith("dispute.")) {
const d = webhook.payload.data;
webhook.payload = {
event_type: webhook.eventType,
dispute_id: d.dispute_id,
payment_id: d.payment_id,
amount: (d.amount / 100).toFixed(2),
status: d.dispute_status,
stage: d.dispute_stage,
remarks: d.remarks || "",
urgent: webhook.eventType === "dispute.opened",
business_id: d.business_id,
timestamp: webhook.payload.timestamp
};
}
return webhook;
}
一般的なウィンドミルのユースケース
- PostgreSQL/MySQLで顧客レコードを更新
- データウェアハウスに支払いイベントを記録
- 外部システムにデータを同期
- 在庫レベルを更新
- 分析指標を追跡
- 収益指標を計算
- 返金と調整を処理
- サブスクリプションライフサイクルを管理
- レポートとエクスポートを生成
- 支払いデータを検証
- 分析プラットフォームにデータを送信
- CRMシステムを更新
- メールキャンペーンをトリガー
- カレンダーイベントを作成
- SMS通知を送信
ヒント
- ワークフロー処理を容易にするためにペイロードデータを構造化
- ビジネスロジックに関連するすべてのメタデータを含める
- イベント間で一貫したフィールド名を使用
- ワークフローのタイミングのためにタイムスタンプを含める
- ウィンドミルの組み込みエラーハンドリングを活用
トラブルシューティング
- Webhook URLが正しくアクティブであることを確認
- ウィンドミルワークフローが公開されてアクティブであることを確認
- ペイロード構造がワークフローの期待に一致していることを確認
- エラーのためにウィンドミルの実行ログを確認
- ワークフロー入力パラメータのマッピングを確認
- データ型が期待されるフォーマットと一致していることを確認
- サンプルデータでワークフローをテスト
- ウィンドミルのスクリプト実行ログを確認
