Skip to content

armgit / dub

Public Imported from GitHub
0

The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.

Show partner's defaultPayoutMethod (#3570)

Steven Teybad60cad7944
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/partners/[partnerId]/links/page.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/partners/[partnerId]/links/page.tsx
index 57b8aeb620..202f788a9b 100644
--- a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/partners/[partnerId]/links/page.tsx
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/partners/[partnerId]/links/page.tsx
@@ -1,8 +1,10 @@
"use client";
import useDiscountCodes from "@/lib/swr/use-discount-codes";
+import useGroup from "@/lib/swr/use-group";
import usePartner from "@/lib/swr/use-partner";
import useWorkspace from "@/lib/swr/use-workspace";
+import { constructPartnerLink } from "@/lib/partners/construct-partner-link";
import { DiscountCodeProps, EnrolledPartnerProps } from "@/lib/types";
import { useAddDiscountCodeModal } from "@/ui/modals/add-discount-code-modal";
import { useAddPartnerLinkModal } from "@/ui/modals/add-partner-link-modal";
@@ -48,6 +50,10 @@ export default function ProgramPartnerLinksPage() {
const PartnerLinks = ({ partner }: { partner: EnrolledPartnerProps }) => {
const { slug } = useWorkspace();
+ const { group } = useGroup({
+ groupIdOrSlug: partner.groupId ?? undefined,
+ });
+
const { AddPartnerLinkModal, setShowAddPartnerLinkModal } =
useAddPartnerLinkModal({
partner,
@@ -59,18 +65,24 @@ const PartnerLinks = ({ partner }: { partner: EnrolledPartnerProps }) => {
{
id: "shortLink",
header: "Link",
- cell: ({ row }) => (
- <div className="flex items-center gap-3">
- <Link
- href={`/${slug}/links/${row.original.domain}/${row.original.key}`}
- target="_blank"
- className="cursor-alias font-medium text-black decoration-dotted hover:underline"
- >
- {getPrettyUrl(row.original.shortLink)}
- </Link>
- <CopyButton value={row.original.shortLink} className="p-0.5" />
- </div>
- ),
+ cell: ({ row }) => {
+ const partnerLink = constructPartnerLink({
+ group: group ?? undefined,
+ link: row.original,
+ });
+ return (
+ <div className="flex items-center gap-3">
+ <Link
+ href={`/${slug}/links/${row.original.domain}/${row.original.key}`}
+ target="_blank"
+ className="cursor-alias font-medium text-black decoration-dotted hover:underline"
+ >
+ {getPrettyUrl(partnerLink)}
+ </Link>
+ <CopyButton value={partnerLink} className="p-0.5" />
+ </div>
+ );
+ },
},
{
header: "Clicks",
diff --git a/apps/web/lib/partners/construct-partner-link.ts b/apps/web/lib/partners/construct-partner-link.ts
index 8477458512..cb1420f23e 100644
--- a/apps/web/lib/partners/construct-partner-link.ts
+++ b/apps/web/lib/partners/construct-partner-link.ts
@@ -17,7 +17,9 @@ export function constructPartnerLink({
const urlObj = link?.url ? getUrlObjFromString(link.url) : null;
if (linkStructure === "query" && urlObj) {
- return `https://${urlObj.hostname}?via=${link.key}`;
+ return urlObj.hostname
+ ? `https://${urlObj.hostname}?via=${link.key}`
+ : `${link.url}?via=${link.key}`;
}
// if (linkStructure === "path" && urlObj) {
diff --git a/apps/web/lib/webhook/sample-events/partner-enrolled.json b/apps/web/lib/webhook/sample-events/partner-enrolled.json
index 245fc839cd..5bf408a1d8 100644
--- a/apps/web/lib/webhook/sample-events/partner-enrolled.json
+++ b/apps/web/lib/webhook/sample-events/partner-enrolled.json
@@ -11,6 +11,7 @@
"partnerId": "pn_1K9BZE1K285BSTX4W6MPKXJFZ",
"groupId": "grp_1KEC01MXCWZW95SMYMV85NBYM",
"status": "approved",
+ "defaultPayoutMethod": null,
"paypalEmail": null,
"stripeConnectId": null,
"payoutsEnabledAt": null,
diff --git a/apps/web/lib/zod/schemas/partners.ts b/apps/web/lib/zod/schemas/partners.ts
index 91333a4500..5f815fffcf 100644
--- a/apps/web/lib/zod/schemas/partners.ts
+++ b/apps/web/lib/zod/schemas/partners.ts
@@ -3,6 +3,7 @@ import {
IndustryInterest,
MonthlyTraffic,
PartnerBannedReason,
+ PartnerPayoutMethod,
PartnerProfileType,
PlatformType,
PreferredEarningStructure,
@@ -307,6 +308,12 @@ export const PartnerSchema = z
.string()
.nullable()
.describe("The partner's country (required for tax purposes)."),
+ defaultPayoutMethod: z
+ .enum(PartnerPayoutMethod)
+ .nullable()
+ .describe(
+ "The partner's default payout method. Connect: Bank account payouts via Stripe Connect; Stablecoin: USDC payouts directly to a crypto wallet; PayPal: Payouts via PayPal",
+ ),
stripeConnectId: z
.string()
.nullable()
@@ -380,6 +387,7 @@ export const EnrolledPartnerSchema = PartnerSchema.pick({
image: true,
description: true,
country: true,
+ defaultPayoutMethod: true,
paypalEmail: true,
stripeConnectId: true,
payoutsEnabledAt: true,
diff --git a/apps/web/ui/partners/partner-info-cards.tsx b/apps/web/ui/partners/partner-info-cards.tsx
index e161c3074a..b880ef4f6a 100644
--- a/apps/web/ui/partners/partner-info-cards.tsx
+++ b/apps/web/ui/partners/partner-info-cards.tsx
@@ -1,4 +1,5 @@
import useGroup from "@/lib/swr/use-group";
+import useProgram from "@/lib/swr/use-program";
import useWorkspace from "@/lib/swr/use-workspace";
import {
BountyListProps,
@@ -17,6 +18,7 @@ import {
Globe,
Heart,
OfficeBuilding,
+ TimestampTooltip,
Trophy,
} from "@dub/ui";
import {
@@ -25,6 +27,7 @@ import {
capitalize,
fetcher,
formatDate,
+ formatDateTimeSmart,
timeAgo,
} from "@dub/utils";
import Link from "next/link";
@@ -41,6 +44,10 @@ import { PartnerInfoGroup } from "./partner-info-group";
import { ConversionScoreTooltip } from "./partner-network/conversion-score-tooltip";
import { PartnerStarButton } from "./partner-star-button";
import { PartnerStatusBadgeWithTooltip } from "./partner-status-badge-with-tooltip";
+import {
+ getPayoutMethodIconConfig,
+ getPayoutMethodLabel,
+} from "./payouts/payout-method-config";
import { ProgramRewardList } from "./program-reward-list";
import { TrustedPartnerBadge } from "./trusted-partner-badge";
@@ -79,9 +86,17 @@ export function PartnerInfoCards({
}: PartnerInfoCardsProps) {
const { id: workspaceId, slug: workspaceSlug } = useWorkspace();
+ const { program } = useProgram();
+
const isEnrolled = type === "enrolled" || type === undefined;
const isNetwork = type === "network";
+ const showPayoutMethodField =
+ isEnrolled &&
+ program?.payoutMode !== "external" &&
+ partner?.payoutsEnabledAt != null &&
+ partner?.defaultPayoutMethod != null;
+
const {
partnerGroupHistorySheet,
setIsOpen: setGroupHistoryOpen,
@@ -154,6 +169,35 @@ export function PartnerInfoCards({
? `${partner.status === "approved" ? "Partner since" : "Applied"} ${formatDate(partner.createdAt)}`
: undefined,
},
+ ...(showPayoutMethodField && partner
+ ? (() => {
+ const { Icon: PayoutMethodIcon } = getPayoutMethodIconConfig(
+ partner.defaultPayoutMethod!,
+ );
+ const payoutTimestamp = partner.payoutsEnabledAt!;
+ const PayoutTimestampWrapper = ({
+ children,
+ }: {
+ children: React.ReactNode;
+ }) => (
+ <TimestampTooltip
+ timestamp={payoutTimestamp}
+ rows={["local", "utc", "unix"]}
+ side="left"
+ >
+ {children}
+ </TimestampTooltip>
+ );
+ return [
+ {
+ id: "payoutMethod" as const,
+ icon: <PayoutMethodIcon className="size-3.5 shrink-0" />,
+ text: `${getPayoutMethodLabel(partner.defaultPayoutMethod!)} connected ${formatDateTimeSmart(partner.payoutsEnabledAt!)}`,
+ wrapper: PayoutTimestampWrapper,
+ },
+ ];
+ })()
+ : []),
]);
}
diff --git a/apps/web/ui/partners/partner-row-item.tsx b/apps/web/ui/partners/partner-row-item.tsx
index 9662bb9159..a60b35e6d4 100644
--- a/apps/web/ui/partners/partner-row-item.tsx
+++ b/apps/web/ui/partners/partner-row-item.tsx
@@ -1,11 +1,13 @@
import useProgram from "@/lib/swr/use-program";
+import { PartnerPayoutMethod } from "@dub/prisma/client";
import { CircleArrowRight, DynamicTooltipWrapper, GreekTemple } from "@dub/ui";
-import { cn } from "@dub/utils";
+import { cn, formatDateTimeSmart } from "@dub/utils";
import { OG_AVATAR_URL } from "@dub/utils/src/constants";
import { CircleMinus } from "lucide-react";
import Link from "next/link";
import { useParams } from "next/navigation";
import { PartnerFraudIndicator } from "./fraud-risks/partner-fraud-indicator";
+import { getPayoutMethodLabel } from "./payouts/payout-method-config";
interface PartnerRowItemProps {
showPermalink?: boolean;
@@ -14,6 +16,7 @@ interface PartnerRowItemProps {
id: string;
name: string;
image?: string | null;
+ defaultPayoutMethod?: PartnerPayoutMethod | null;
payoutsEnabledAt?: Date | null;
};
}
@@ -45,7 +48,7 @@ const PAYOUT_STATUS_CONFIG = {
enabled: {
title: "Payouts enabled",
description:
- "This partner has payouts enabled, which means they will be able to receive payouts from this program.",
+ "This partner has connected a payout method, which means they will be able to receive payouts.",
icon: GreekTemple,
iconClassName: "border-green-300 bg-green-200 text-green-800",
indicatorColor: "bg-green-500",
@@ -53,7 +56,7 @@ const PAYOUT_STATUS_CONFIG = {
disabled: {
title: "Payouts disabled",
description:
- "This partner has not connected a bank account to receive payouts yet, which means they won't be able to receive payouts from your program.",
+ "This partner has not connected a payout method yet, which means they won't be able to receive payouts.",
icon: CircleMinus,
iconClassName: "border-red-300 bg-red-200 text-red-800",
indicatorColor: "bg-red-500",
@@ -96,8 +99,10 @@ function usePartnerPayoutStatus(partner: PartnerRowItemProps["partner"]) {
function PartnerPayoutStatusTooltip({
statusKey,
+ partner,
}: {
statusKey: keyof typeof PAYOUT_STATUS_CONFIG | null;
+ partner: PartnerRowItemProps["partner"];
}) {
if (!statusKey) return null;
@@ -108,20 +113,37 @@ function PartnerPayoutStatusTooltip({
iconClassName,
} = PAYOUT_STATUS_CONFIG[statusKey];
+ const hasPayoutDetails =
+ statusKey === "enabled" &&
+ partner.payoutsEnabledAt &&
+ partner.defaultPayoutMethod;
+
return (
- <div className="grid max-w-xs gap-2 p-4">
- <div className="flex items-center gap-2 text-sm font-medium">
- {title}
- <div
- className={cn(
- iconClassName,
- "flex size-5 items-center justify-center rounded-md border",
- )}
- >
- <Icon className="size-3" />
+ <div className="max-w-xs">
+ <div className="grid gap-2 p-2.5">
+ <div className="flex items-center gap-2 text-sm font-medium">
+ {title}
+ <div
+ className={cn(
+ iconClassName,
+ "flex size-5 items-center justify-center rounded-md border",
+ )}
+ >
+ <Icon className="size-3" />
+ </div>
+ </div>
+ <div className="text-pretty text-sm text-neutral-500">
+ {description}
</div>
</div>
- <div className="text-pretty text-sm text-neutral-500">{description}</div>
+ {hasPayoutDetails && (
+ <div className="border-t border-neutral-100 p-2.5 text-xs text-neutral-600">
+ <span>
+ Connected {getPayoutMethodLabel(partner.defaultPayoutMethod!)}{" "}
+ {formatDateTimeSmart(partner.payoutsEnabledAt!)}
+ </span>
+ </div>
+ )}
</div>
);
}
@@ -143,7 +165,12 @@ export function PartnerRowItem({
tooltipProps={
statusKey
? {
- content: <PartnerPayoutStatusTooltip statusKey={statusKey} />,
+ content: (
+ <PartnerPayoutStatusTooltip
+ statusKey={statusKey}
+ partner={partner}
+ />
+ ),
}
: undefined
}
diff --git a/apps/web/ui/partners/payouts/payout-method-config.ts b/apps/web/ui/partners/payouts/payout-method-config.ts
index 12c14f8d02..e8e3ce5dfd 100644
--- a/apps/web/ui/partners/payouts/payout-method-config.ts
+++ b/apps/web/ui/partners/payouts/payout-method-config.ts
@@ -44,7 +44,7 @@ export const PAYOUT_METHODS = [
title: "PayPal",
recommended: false,
icon: Paypal,
- iconWrapperClass: "border-[#1717171A] bg-white p-2",
+ iconWrapperClass: "border-[#1717171A] bg-white",
features: [
{ icon: MapPin, text: "Paid in local currency (3% FX fee)" },
{ icon: Zap, text: "Payouts deposited in minutes" },
@@ -72,6 +72,10 @@ export function getPayoutMethodIconConfig(type: PartnerPayoutMethod) {
);
}
+export function getPayoutMethodLabel(type: PartnerPayoutMethod): string {
+ return PAYOUT_METHODS.find((m) => m.id === type)?.title ?? type;
+}
+
export type PayoutMethodFeature = {
icon: ComponentType<{ className?: string }>;
text: string;