Resend

はじめに

Resend integration は、Dodo Payments のイベント発生時に Resend 経由でトランザクションメールを送信します。これを使用して、支払いの確認、新しいサブスクライバーへのウェルカムメールの送信、支払い失敗時のお客様への通知を、ご自身の送信用ドメインから行えます。

この integration には、Sending access を持つ Resend API key と、Resend で検証済みの送信用ドメインが必要です。また、Dodo Payments ダッシュボードの Developer → Webhooks にアクセスできる必要があります。

始め方

Open the Webhook Section

Dodo Payments ダッシュボードで、Developer → Webhooks に移動し、Add endpoint をクリックします。

Integration ドロップダウンで Resend が選択され、「Resend の接続方法」の手順が表示された Add endpoint ダイアログ

Select Resend

Integration で Resend を選択します。ダッシュボードに Endpoint URL と Resend 用の transformation code が入力され、How to connect Resend パネルにセットアップ手順が表示されます。

Enter API Key

Resend で API Keys を開き、Create API Key をクリックして、キーに Sending access を付与します。Resend に表示されるキー（re_ で始まります）は一度しか表示されません。これを API key に貼り付けます。Dodo Payments は、Resend へのすべてのリクエストの Authorization header に bearer token として送信します。

Select Events

Subscribed events で、transformation が処理するイベントのみを選択します。transformation が変更せずに通過させたイベントは Dodo Payments 形式のまま Resend に到達するため、Resend に拒否されます。

Configure Transformation

Transformation code で handler を編集し、サブスクライブした各イベントが Resend メールになるようにします。examples を参考にしてください。

Test & Create

Test this code でイベントタイプを選択し、Simulate をクリックして Resend へのリクエストをプレビューします。その後、Create endpoint をクリックします。

Done

これで Dodo Payments は、サブスクライブした各イベントについて Resend 経由でメールを送信します。各配信と Resend の response を確認するには、Developer → Webhooks の Logs タブを開きます。

Transformation Code の例

各 handler は webhook.url を Resend の send-email endpoint に設定し、webhook.payload をメールに置き換えます。Dodo Payments の金額は通貨の最小単位で表されるため、例では 100 で割り、通貨コードを表示しています。JPY や KRW などの小数点以下の桁がない通貨では、金額をそのまま使用してください。

支払い確認メール

支払いが成功したときに領収書を送信します（payment.succeeded）：

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.resend.com/emails";
    webhook.payload = {
      from: "payments@yourdomain.com",
      to: [p.customer.email],
      subject: "Payment Confirmation - " + (p.total_amount / 100).toFixed(2) + " " + p.currency,
      html: `
        <h2>Payment Successful!</h2>
        <p>Hi ${p.customer.name},</p>
        <p>Your payment of ${(p.total_amount / 100).toFixed(2)} ${p.currency} has been processed successfully.</p>
        <ul>
          <li><strong>Payment ID:</strong> ${p.payment_id}</li>
          <li><strong>Amount:</strong> ${(p.total_amount / 100).toFixed(2)} ${p.currency}</li>
          <li><strong>Date:</strong> ${new Date(webhook.payload.timestamp).toLocaleDateString()}</li>
          <li><strong>Method:</strong> ${p.payment_method || "Unknown"}</li>
        </ul>
        <p>Thank you for your business!</p>
      `,
      text: `Payment Successful! Your payment of ${(p.total_amount / 100).toFixed(2)} ${p.currency} has been processed. Payment ID: ${p.payment_id}`
    };
  }
  return webhook;
}

サブスクリプションのウェルカムメール

サブスクリプションが有効になったときにお客様を歓迎します（subscription.active）：

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://api.resend.com/emails";
    webhook.payload = {
      from: "welcome@yourdomain.com",
      to: [s.customer.email],
      subject: "Welcome to Your Subscription!",
      html: `
        <h2>Welcome to Your Subscription!</h2>
        <p>Hi ${s.customer.name},</p>
        <p>Your subscription has been activated successfully.</p>
        <ul>
          <li><strong>Subscription ID:</strong> ${s.subscription_id}</li>
          <li><strong>Product:</strong> ${s.product_id}</li>
          <li><strong>Amount:</strong> ${(s.recurring_pre_tax_amount / 100).toFixed(2)} ${s.currency}/${s.payment_frequency_interval}</li>
          <li><strong>Next Billing:</strong> ${new Date(s.next_billing_date).toLocaleDateString()}</li>
        </ul>
        <p>You can manage your subscription anytime from your account dashboard.</p>
      `,
      text: `Welcome! Your subscription is now active. Amount: ${(s.recurring_pre_tax_amount / 100).toFixed(2)} ${s.currency}/${s.payment_frequency_interval}`
    };
  }
  return webhook;
}

支払い失敗通知

支払いが失敗したときに、お客様に支払い方法の更新を依頼します（payment.failed）：

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://api.resend.com/emails";
    webhook.payload = {
      from: "support@yourdomain.com",
      to: [p.customer.email],
      subject: "Payment Failed - Action Required",
      html: `
        <h2>Payment Failed</h2>
        <p>Hi ${p.customer.name},</p>
        <p>We were unable to process your payment of ${(p.total_amount / 100).toFixed(2)} ${p.currency}.</p>
        <ul>
          <li><strong>Payment ID:</strong> ${p.payment_id}</li>
          <li><strong>Amount:</strong> ${(p.total_amount / 100).toFixed(2)} ${p.currency}</li>
          <li><strong>Error:</strong> ${p.error_message || "Payment processing failed"}</li>
        </ul>
        <p>Please update your payment method or contact support for assistance.</p>
        <a href="https://yourdomain.com/update-payment">Update Payment Method</a>
      `,
      text: `Payment Failed: We couldn't process your ${(p.total_amount / 100).toFixed(2)} ${p.currency} payment. Please update your payment method.`
    };
  }
  return webhook;
}

ヒント

Resend で検証済みのドメインから送信すると、到達率が向上します。
各メールに html 版と text 版の両方を含めます。
customer.name など、payload の顧客データを使ってコンテンツをパーソナライズします。
結果または必要なアクションがわかる件名を作成します。
マーケティングコンテンツを含むメールには、配信停止リンクを含めます。
endpoint を作成する前に、Simulate で各テンプレートをプレビューします。
code でイベントをスキップするには、webhook を return する前に webhook.cancel = true を設定します。ログには、スキップされた配信が成功として記録されます。

トラブルシューティング

Emails Not Being Sent

API key が正しく、有効で、Sending access を持っていることを確認します。置き換えるには endpoint を編集し、API key に新しいキーを貼り付けます。
sender domain が Resend で検証済みであることを確認します。
recipient email address が有効であることを確認します。
ご利用のプランにおける Resend の送信制限と quota を確認します。
Developer → Webhooks の Logs タブを開き、失敗した配信に対する Resend の response を確認します。

Transformation Errors

payload が Resend の send-email 形式と一致していることを確認します。Resend では from、to、subject が必要です。
code が処理するすべてのイベントで、必要なフィールドがすべて設定されていることを確認します。
html の値が正しい形式の HTML であることを確認します。
from address が、Resend で検証済みのドメインを使用していることを確認します。

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

はじめに

始め方

Transformation Code の例

支払い確認メール

サブスクリプションのウェルカムメール

支払い失敗通知

ヒント

トラブルシューティング

​はじめに

​始め方

​Transformation Code の例

​支払い確認メール

​サブスクリプションのウェルカムメール

​支払い失敗通知

​ヒント

​トラブルシューティング

はじめに

始め方

Transformation Code の例

支払い確認メール

サブスクリプションのウェルカムメール

支払い失敗通知

ヒント

トラブルシューティング