The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.
TypeScript clickhousemysqlnextjsopen-sourceplanetscaleprismatailwindcsstinybirdtypescriptupstashvercel
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.tsxindex 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.tsindex 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.jsonindex 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.tsindex 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.tsxindex 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.tsxindex 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.tsindex 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;