dubinc · steven-tey · Jul 8, 2025 · Jul 7, 2025 · Jul 7, 2025 · Jul 7, 2025
diff --git a/apps/web/app/(ee)/api/cron/payouts/reminders/program-owners/route.ts b/apps/web/app/(ee)/api/cron/payouts/reminders/program-owners/route.ts
@@ -1,7 +1,6 @@
 import { handleAndReturnErrorResponse } from "@/lib/api/errors";
 import { limiter } from "@/lib/cron/limiter";
 import { verifyVercelSignature } from "@/lib/cron/verify-vercel";
-import { DUB_MIN_PAYOUT_AMOUNT_CENTS } from "@/lib/partners/constants";
 import { sendEmail } from "@dub/email";
 import ProgramPayoutReminder from "@dub/email/templates/program-payout-reminder";
 import { prisma } from "@dub/prisma";
@@ -31,7 +30,7 @@ export async function GET(req: Request) {
     const programsWithCustomMinPayouts = await prisma.program.findMany({
       where: {
         minPayoutAmount: {
-          gt: DUB_MIN_PAYOUT_AMOUNT_CENTS,
+          gt: 0,
         },
       },
     });
@@ -41,7 +40,7 @@ export async function GET(req: Request) {
       where: {
         status: "pending",
         amount: {
-          gte: DUB_MIN_PAYOUT_AMOUNT_CENTS,
+          gt: 0,
         },
         programId: {
           notIn: programsWithCustomMinPayouts.map((p) => p.id),

diff --git a/apps/web/app/(ee)/api/stripe/connect/webhook/balance-available.ts b/apps/web/app/(ee)/api/stripe/connect/webhook/balance-available.ts
@@ -0,0 +1,156 @@
+import { ZERO_DECIMAL_CURRENCIES } from "@/lib/analytics/convert-currency";
+import {
+  BELOW_MIN_WITHDRAWAL_FEE_CENTS,
+  MIN_WITHDRAWAL_AMOUNT_CENTS,
+} from "@/lib/partners/constants";
+import { stripe } from "@/lib/stripe";
+import { redis } from "@/lib/upstash";
+import { prisma } from "@dub/prisma";
+import { currencyFormatter, log } from "@dub/utils";
+import Stripe from "stripe";
+
+export async function balanceAvailable(event: Stripe.Event) {
+  const stripeAccount = event.account;
+
+  if (!stripeAccount) {
+    console.error("Stripe account not found. Skipping...");
+    return;
+  }
+
+  const partner = await prisma.partner.findUnique({
+    where: {
+      stripeConnectId: stripeAccount,
+    },
+  });
+
+  if (!partner) {
+    console.error(
+      `Partner not found with stripeConnectId ${stripeAccount}. Skipping...`,
+    );
+    return;
+  }
+
+  // Get the partner's current balance
+  const balance = await stripe.balance.retrieve({
+    stripeAccount,
+  });
+
+  // Check if there's any available balance
+  if (balance.available.length === 0 || balance.available[0].amount === 0) {
+    console.log(
+      `No available balance found for partner ${partner.email} (${stripeAccount}). Skipping...`,
+    );
+    return;
+  }
+
+  const { amount, currency } = balance.available[0];
+
+  let availableBalance = amount;
+  let convertedUsdAmount = amount;
+
+  if (currency !== "usd") {
+    const fxRates = await redis.hget("fxRates:usd", currency.toUpperCase());
+
+    if (!fxRates) {
+      console.error(
+        `Failed to get exchange rate from Redis for ${currency}. Skipping...`,
+      );
+      return;
+    }
+
+    convertedUsdAmount = availableBalance / Number(fxRates);
+
+    const isZeroDecimalCurrency = ZERO_DECIMAL_CURRENCIES.includes(
+      currency.toUpperCase(),
+    );
+
+    if (isZeroDecimalCurrency) {
+      convertedUsdAmount = convertedUsdAmount * 100;
+    }
+  }
+
+  // Check minimum withdrawal amount
+  if (convertedUsdAmount < partner.minWithdrawalAmount) {
+    console.log(
+      `The available balance (${currencyFormatter(convertedUsdAmount / 100, { maximumFractionDigits: 2 })}) for partner ${partner.email} (${stripeAccount}) is less than their minimum withdrawal amount (${currencyFormatter(partner.minWithdrawalAmount / 100, { maximumFractionDigits: 2 })})`,
+    );
+    return;
+  }
+
+  let withdrawalFee = 0;
+
+  // Decide if we need to charge a withdrawal fee for the partner
+  if (partner.minWithdrawalAmount < MIN_WITHDRAWAL_AMOUNT_CENTS) {
+    withdrawalFee = BELOW_MIN_WITHDRAWAL_FEE_CENTS;
+
+    const transfers = await stripe.transfers.list({
+      destination: stripeAccount,
+    });
+
+    if (transfers.data.length === 0) {
+      console.error(
+        `No transfers found for partner ${partner.email} (${stripeAccount}). Skipping...`,
+      );
+      return;
+    }
+
+    // Find the latest transfer that's large enough to cover the withdrawal fee
+    const suitableTransfer = transfers.data
+      .filter((transfer) => transfer.amount >= withdrawalFee)
+      .sort((a, b) => b.created - a.created)[0];
+
+    // This should never happen, but just in case
+    if (!suitableTransfer) {
+      const errorMessage = `Error processing withdrawal for partner ${partner.email} (${stripeAccount}): No transfer found with amount >= withdrawal fee (${currencyFormatter(withdrawalFee / 100)}). Available transfers: ${transfers.data
+        .map((t) => currencyFormatter(t.amount / 100))
+        .join(", ")}. Skipping...`;
+      console.error(errorMessage);
+      await log({
+        message: errorMessage,
+        type: "errors",
+        mention: true,
+      });
+      return;
+    }
+
+    // Charge the withdrawal fee to the partner's account
+    await stripe.transfers.createReversal(suitableTransfer.id, {
+      amount: withdrawalFee,
+      description: "Dub Partners withdrawal fee",
+    });
+
+    // If the withdrawal fee was charged, we need to fetch the partner's updated balance
+    const updatedBalance = await stripe.balance.retrieve({
+      stripeAccount,
+    });
+
+    if (
+      updatedBalance.available.length === 0 ||
+      updatedBalance.available[0].amount === 0
+    ) {
+      // this should never happen, but just in case
+      console.log(
+        `No available balance found after withdrawal fee for partner ${partner.email} (${stripeAccount}). Skipping...`,
+      );
+      return;
+    }
+
+    availableBalance = updatedBalance.available[0].amount;
+  }
+
+  const payout = await stripe.payouts.create(
+    {
+      amount: availableBalance,
+      currency,
+      description: "Dub Partners payout",
+      method: "standard",
+    },
+    {
+      stripeAccount,
+    },
+  );
+
+  console.log(
+    `Stripe payout created for partner ${partner.email} (${stripeAccount}): ${payout.id} (${currencyFormatter(payout.amount / 100, { maximumFractionDigits: 2 })})`,
+  );
+}
diff --git a/apps/web/app/(ee)/api/stripe/connect/webhook/route.ts b/apps/web/app/(ee)/api/stripe/connect/webhook/route.ts
@@ -3,15 +3,17 @@ import { log } from "@dub/utils";
 import { NextResponse } from "next/server";
 import Stripe from "stripe";
 import { accountUpdated } from "./account-updated";
+import { balanceAvailable } from "./balance-available";
 
-const relevantEvents = new Set(["account.updated"]);
+const relevantEvents = new Set(["account.updated", "balance.available"]);
 
 // POST /api/stripe/connect/webhook – listen to Stripe Connect webhooks (for connected accounts)
 export const POST = async (req: Request) => {
   const buf = await req.text();
-  const sig = req.headers.get("Stripe-Signature") as string;
+  const sig = req.headers.get("Stripe-Signature");
   const webhookSecret = process.env.STRIPE_CONNECT_WEBHOOK_SECRET;
   let event: Stripe.Event;
+
   try {
     if (!sig || !webhookSecret) return;
     event = stripe.webhooks.constructEvent(buf, sig, webhookSecret);
@@ -28,17 +30,22 @@ export const POST = async (req: Request) => {
       status: 200,
     });
   }
+
   try {
     switch (event.type) {
       case "account.updated":
         await accountUpdated(event);
         break;
+      case "balance.available":
+        await balanceAvailable(event);
+        break;
     }
   } catch (error) {
     await log({
       message: `Stripe webhook failed. Error: ${error.message}`,
       type: "errors",
     });
+
     return new Response('Webhook error: "Webhook handler failed. View logs."', {
       status: 400,
     });

diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/payouts/payout-details-sheet.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/payouts/payout-details-sheet.tsx
@@ -184,7 +184,7 @@ function PayoutDetailsSheetContent({ payout }: PayoutDetailsSheetProps) {
 
   return (
     <div>
-      <div className="flex items-center justify-between border-b border-neutral-200 px-6 py-4 h-16">
+      <div className="flex h-16 items-center justify-between border-b border-neutral-200 px-6 py-4">
         <Sheet.Title className="text-lg font-semibold">
           Payout details
         </Sheet.Title>

diff --git a/...partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-table.tsx b/...partners.dub.co/(dashboard)/programs/[programSlug]/(enrolled)/earnings/earnings-table.tsx
@@ -216,7 +216,7 @@ export function EarningsTablePartner({ limit }: { limit?: number }) {
                 holdingPeriodDays:
                   programEnrollment?.program.holdingPeriodDays ?? 0,
                 minPayoutAmount:
-                  programEnrollment?.program.minPayoutAmount ?? 10000,
+                  programEnrollment?.program.minPayoutAmount ?? 0,
                 supportEmail:
                   programEnrollment?.program.supportEmail ?? "[email protected]",
               })}

diff --git a/.../web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/commissions/create-clawback-sheet.tsx b/.../web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/commissions/create-clawback-sheet.tsx
@@ -77,7 +77,7 @@ function CreateClawbackSheetContent(
   return (
     <form onSubmit={handleSubmit(onSubmit)} className="flex h-full flex-col">
       <div className="sticky top-0 z-10 border-b border-neutral-200 bg-white">
-        <div className="flex items-center justify-between px-6 py-4 h-16">
+        <div className="flex h-16 items-center justify-between px-6 py-4">
           <Sheet.Title className="text-lg font-semibold">
             Create clawback
           </Sheet.Title>

diff --git a/...eb/app/app.dub.co/(dashboard)/[slug]/(ee)/program/commissions/create-commission-sheet.tsx b/...eb/app/app.dub.co/(dashboard)/[slug]/(ee)/program/commissions/create-commission-sheet.tsx
@@ -176,7 +176,7 @@ function CreateCommissionSheetContent(props: CreateCommissionSheetProps) {
   return (
     <form onSubmit={handleSubmit(onSubmit)} className="flex h-full flex-col">
       <div className="sticky top-0 z-10 border-b border-neutral-200 bg-white">
-        <div className="flex items-center justify-between px-6 py-4 h-16">
+        <div className="flex h-16 items-center justify-between px-6 py-4">
           <Sheet.Title className="text-lg font-semibold">
             Create commission
           </Sheet.Title>

diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/partners/invite-partner-sheet.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/partners/invite-partner-sheet.tsx
@@ -119,7 +119,7 @@ function InvitePartnerSheetContent({ setIsOpen }: InvitePartnerSheetProps) {
   return (
     <form onSubmit={handleSubmit(onSubmit)} className="flex h-full flex-col">
       <div className="sticky top-0 z-10 border-b border-neutral-200 bg-white">
-        <div className="flex items-center justify-between px-6 py-4 h-16">
+        <div className="flex h-16 items-center justify-between px-6 py-4">
           <Sheet.Title className="text-lg font-semibold">
             Invite partner
           </Sheet.Title>

diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/payouts/page.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/payouts/page.tsx
@@ -1,6 +1,7 @@
 import { PageContent } from "@/ui/layout/page-content";
 import { PageWidthWrapper } from "@/ui/layout/page-width-wrapper";
 import { ProgramPayoutsPageClient } from "./page-client";
+import { ProgramPayoutSettingsButton } from "./program-payout-settings-button";
 
 export default function ProgramPayoutsPage() {
   return (
@@ -11,6 +12,7 @@ export default function ProgramPayoutsPage() {
           "Learn more about how you can send payouts to your affiliate partners globally with Dub.",
         href: "https://dub.co/help/article/partner-payouts",
       }}
+      controls={<ProgramPayoutSettingsButton />}
     >
       <PageWidthWrapper>
         <ProgramPayoutsPageClient />

diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/payouts/payout-details-sheet.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/payouts/payout-details-sheet.tsx
@@ -207,7 +207,7 @@ function PayoutDetailsSheetContent({ payout }: PayoutDetailsSheetProps) {
 
   return (
     <div className="flex h-full flex-col">
-      <div className="sticky top-0 z-10 flex items-center justify-between border-b border-neutral-200 bg-white px-6 py-4 h-16">
+      <div className="sticky top-0 z-10 flex h-16 items-center justify-between border-b border-neutral-200 bg-white px-6 py-4">
         <Sheet.Title className="text-lg font-semibold">
           {capitalize(payout.status)} payout
         </Sheet.Title>

diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/payouts/payout-table.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/payouts/payout-table.tsx
@@ -1,6 +1,5 @@
 "use client";
 
-import { DUB_MIN_PAYOUT_AMOUNT_CENTS } from "@/lib/partners/constants";
 import usePayoutsCount from "@/lib/swr/use-payouts-count";
 import useProgram from "@/lib/swr/use-program";
 import useWorkspace from "@/lib/swr/use-workspace";
@@ -315,8 +314,7 @@ function AmountRowItem({
     maximumFractionDigits: 2,
   });
 
-  const minPayoutAmount =
-    program?.minPayoutAmount || DUB_MIN_PAYOUT_AMOUNT_CENTS;
+  const minPayoutAmount = program?.minPayoutAmount || 0;
 
   if (status === PayoutStatus.pending) {
     if (amount < minPayoutAmount) {

diff --git a/...app/app.dub.co/(dashboard)/[slug]/(ee)/program/payouts/program-payout-settings-button.tsx b/...app/app.dub.co/(dashboard)/[slug]/(ee)/program/payouts/program-payout-settings-button.tsx
@@ -0,0 +1,21 @@
+"use client";
+
+import { Button } from "@dub/ui";
+import { useProgramPayoutSettingsModal } from "./program-payout-settings-modal";
+
+export function ProgramPayoutSettingsButton() {
+  const { ProgramPayoutSettingsModal, setShowProgramPayoutSettingsModal } =
+    useProgramPayoutSettingsModal();
+
+  return (
+    <>
+      <ProgramPayoutSettingsModal />
+      <Button
+        type="button"
+        text="Payout settings"
+        variant="secondary"
+        onClick={() => setShowProgramPayoutSettingsModal(true)}
+      />
+    </>
+  );
+}