dubinc · steven-tey · Nov 6, 2025 · Oct 30, 2025 · Oct 30, 2025 · Oct 30, 2025
diff --git a/apps/web/app/(ee)/api/cron/payouts/charge-succeeded/queue-external-payouts.ts b/apps/web/app/(ee)/api/cron/payouts/charge-succeeded/queue-external-payouts.ts
@@ -0,0 +1,148 @@
+import { queueBatchEmail } from "@/lib/email/queue-batch-email";
+import { sendWorkspaceWebhook } from "@/lib/webhook/publish";
+import { payoutWebhookEventSchema } from "@/lib/zod/schemas/payouts";
+import type PartnerPayoutConfirmed from "@dub/email/templates/partner-payout-confirmed";
+import { prisma } from "@dub/prisma";
+import { Invoice } from "@dub/prisma/client";
+
+export async function queueExternalPayouts(
+  invoice: Pick<
+    Invoice,
+    "id" | "paymentMethod" | "programId" | "workspaceId" | "payoutMode"
+  >,
+) {
+  // All payouts are processed internally, hence no need to queue external payouts
+  if (invoice.payoutMode === "internal") {
+    console.log(`Invoice ${invoice.id} is paid internally. Skipping...`);
+    return;
+  }
+
+  // should never happen, but just in case
+  if (!invoice.programId) {
+    console.log(`Invoice ${invoice.id} has no program ID. Skipping...`);
+    return;
+  }
+
+  const program = await prisma.program.findUnique({
+    where: {
+      id: invoice.programId,
+    },
+    select: {
+      id: true,
+      name: true,
+      logo: true,
+      supportEmail: true,
+    },
+  });
+
+  // should never happen, but just in case
+  if (!program) {
+    console.log(`Program not found for invoice ${invoice.id}. Skipping...`);
+    return;
+  }
+
+  const externalPayouts = await prisma.payout.findMany({
+    where: {
+      invoiceId: invoice.id,
+      status: "processing",
+      mode: "external",
+    },
+    include: {
+      partner: {
+        include: {
+          programs: {
+            where: {
+              programId: program.id,
+            },
+            select: {
+              tenantId: true,
+              status: true,
+            },
+          },
+        },
+      },
+    },
+  });
+
+  if (externalPayouts.length === 0) {
+    console.log("No external payouts found for invoice", invoice.id);
+    return;
+  }
+
+  const webhooks = await prisma.webhook.findMany({
+    where: {
+      projectId: invoice.workspaceId,
+      disabledAt: null,
+      triggers: {
+        array_contains: ["payout.confirmed"],
+      },
+    },
+    select: {
+      id: true,
+      url: true,
+      secret: true,
+    },
+  });
+
+  if (webhooks.length === 0) {
+    console.log(
+      `No webhooks found for workspace ${invoice.workspaceId} for invoice ${invoice.id}. Skipping...`,
+    );
+    return;
+  }
+
+  for (const payout of externalPayouts) {
+    try {
+      const data = payoutWebhookEventSchema.parse({
+        ...payout,
+        partner: {
+          ...payout.partner,
+          ...payout.partner.programs[0],
+        },
+      });
+
+      await sendWorkspaceWebhook({
+        workspace: {
+          id: invoice.workspaceId,
+          webhookEnabled: true,
+        },
+        webhooks,
+        data,
+        trigger: "payout.confirmed",
+      });
+    } catch (error) {
+      console.error(error.message);
+    }
+  }
+
+  await queueBatchEmail<typeof PartnerPayoutConfirmed>(
+    externalPayouts
+      .filter((payout) => payout.partner.email)
+      .map((payout) => ({
+        to: payout.partner.email!,
+        subject: "You've got money coming your way!",
+        variant: "notifications",
+        replyTo: program.supportEmail || "noreply",
+        templateName: "PartnerPayoutConfirmed",
+        templateProps: {
+          email: payout.partner.email!,
+          program: {
+            id: program.id,
+            name: program.name,
+            logo: program.logo,
+          },
+          payout: {
+            id: payout.id,
+            amount: payout.amount,
+            startDate: payout.periodStart,
+            endDate: payout.periodEnd,
+            mode: "external",
+            paymentMethod: invoice.paymentMethod ?? "ach",
+          },
+        },
+      })),
+    {
+      idempotencyKey: `payout-confirmed-external/${invoice.id}`,
+    },
+  );
+}
diff --git a/apps/web/app/(ee)/api/cron/payouts/charge-succeeded/queue-stripe-payouts.ts b/apps/web/app/(ee)/api/cron/payouts/charge-succeeded/queue-stripe-payouts.ts
@@ -9,8 +9,16 @@ const stripeChargeMetadataSchema = z.object({
 });
 
 export async function queueStripePayouts(
-  invoice: Pick<Invoice, "id" | "paymentMethod" | "stripeChargeMetadata">,
+  invoice: Pick<
+    Invoice,
+    "id" | "paymentMethod" | "stripeChargeMetadata" | "payoutMode"
+  >,
 ) {
+  // All payouts are processed externally, hence no need to queue Stripe payouts
+  if (invoice.payoutMode === "external") {
+    return;
+  }
+
   const { id: invoiceId, paymentMethod, stripeChargeMetadata } = invoice;
 
   // Find the id of the charge that was used to fund the transfer
@@ -36,6 +44,7 @@ export async function queueStripePayouts(
     where: {
       invoiceId,
       status: "processing",
+      mode: "internal",
     },
   });
 
@@ -58,6 +67,7 @@ export async function queueStripePayouts(
         ...(paymentMethod === "card" && { chargeId }),
       },
     });
+
     console.log(
       `Enqueued Stripe payout for invoice ${invoiceId} and partner ${partnerId}: ${response.messageId}`,
     );

diff --git a/apps/web/app/(ee)/api/cron/payouts/charge-succeeded/route.ts b/apps/web/app/(ee)/api/cron/payouts/charge-succeeded/route.ts
@@ -4,6 +4,7 @@ import { prisma } from "@dub/prisma";
 import { log } from "@dub/utils";
 import { z } from "zod";
 import { logAndRespond } from "../../utils";
+import { queueExternalPayouts } from "./queue-external-payouts";
 import { queueStripePayouts } from "./queue-stripe-payouts";
 import { sendPaypalPayouts } from "./send-paypal-payouts";
 
@@ -13,6 +14,7 @@ export const maxDuration = 600; // This function can run for a maximum of 10 min
 const payloadSchema = z.object({
   invoiceId: z.string(),
 });
+
 // POST /api/cron/payouts/charge-succeeded
 // This route is used to process the charge-succeeded event from Stripe.
 // We're intentionally offloading this to a cron job so we can return a 200 to Stripe immediately.
@@ -51,10 +53,12 @@ export async function POST(req: Request) {
     }
 
     await Promise.allSettled([
+      // Queue Stripe payouts
       queueStripePayouts(invoice),
-      sendPaypalPayouts({
-        invoiceId,
-      }),
+      // Send PayPal payouts
+      sendPaypalPayouts(invoice),
+      // Queue external payouts
+      queueExternalPayouts(invoice),
     ]);
 
     return logAndRespond(

diff --git a/apps/web/app/(ee)/api/cron/payouts/charge-succeeded/send-paypal-payouts.ts b/apps/web/app/(ee)/api/cron/payouts/charge-succeeded/send-paypal-payouts.ts
@@ -2,12 +2,14 @@ import { createPayPalBatchPayout } from "@/lib/paypal/create-batch-payout";
 import { sendBatchEmail } from "@dub/email";
 import PartnerPayoutProcessed from "@dub/email/templates/partner-payout-processed";
 import { prisma } from "@dub/prisma";
+import { Invoice } from "@dub/prisma/client";
 
-export async function sendPaypalPayouts({ invoiceId }: { invoiceId: string }) {
+export async function sendPaypalPayouts(invoice: Pick<Invoice, "id">) {
   const payouts = await prisma.payout.findMany({
     where: {
-      invoiceId,
+      invoiceId: invoice.id,
       status: "processing",
+      mode: "internal",
       partner: {
         payoutsEnabledAt: {
           not: null,
@@ -40,7 +42,7 @@ export async function sendPaypalPayouts({ invoiceId }: { invoiceId: string }) {
 
   const batchPayout = await createPayPalBatchPayout({
     payouts,
-    invoiceId,
+    invoiceId: invoice.id,
   });
 
   console.log("PayPal batch payout created", batchPayout);