The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.
TypeScript clickhousemysqlnextjsopen-sourceplanetscaleprismatailwindcsstinybirdtypescriptupstashvercel
Detect duplicate identity via Veriff risk labels (#3765)
Kiran Kb961675015a3
diff --git a/apps/web/app/api/veriff/webhook/handle-decision-event.ts b/apps/web/app/api/veriff/webhook/handle-decision-event.tsindex e88ec86ece..03fb5214b2 100644--- a/apps/web/app/api/veriff/webhook/handle-decision-event.ts+++ b/apps/web/app/api/veriff/webhook/handle-decision-event.ts@@ -1,5 +1,9 @@-import { computeVeriffIdentityHash } from "@/lib/veriff/compute-veriff-identity-hash";-import { VeriffDecisionEvent } from "@/lib/veriff/schema";+import { detectDuplicateIdentityFraud } from "@/lib/api/fraud/detect-duplicate-identity-fraud";+import {+ VeriffDecisionEvent,+ VeriffRiskLabel,+ veriffRiskLabels,+} from "@/lib/veriff/schema";import {mergeVeriffMetadata,parseVeriffMetadata,@@ -10,6 +14,7 @@ import PartnerIdentityVerified from "@dub/email/templates/partner-identity-verifimport { prisma } from "@dub/prisma";import { IdentityVerificationStatus, Partner } from "@dub/prisma/client";import { DUPLICATE_IDENTITY_DECLINE_REASON } from "@dub/utils";+import { waitUntil } from "@vercel/functions";import { logAndRespond } from "app/(ee)/api/cron/utils";const veriffStatusMap: Record<@@ -27,7 +32,8 @@ const veriffStatusMap: Record<export const handleDecisionEvent = async ({verification,}: VeriffDecisionEvent) => {- const { id, status, decisionTime, reason, attemptId } = verification;+ const { id, status, decisionTime, reason, attemptId, riskLabels } =+ verification;let effectiveStatus = status;@@ -55,7 +61,6 @@ export const handleDecisionEvent = async ({// since we're skipping verified partners, by default identityVerifiedAt is nulllet identityVerifiedAt: Date | null = null;- let veriffIdentityHash: string | null | undefined = undefined;let { sessionUrl, attemptCount, declineReason, sessionExpiresAt } =parseVeriffMetadata(partner.veriffMetadata);@@ -65,20 +70,28 @@ export const handleDecisionEvent = async ({// If the verification was approved, check for country mismatchif (effectiveStatus === "approved") {- veriffIdentityHash = computeVeriffIdentityHash(verification);- const isDuplicate = await checkDuplicateIdentity({- partner,- veriffIdentityHash,- });+ const hasDuplicateRiskLabel =+ riskLabels &&+ riskLabels?.length > 0 &&+ riskLabels.some(({ label }) =>+ veriffRiskLabels.includes(label as VeriffRiskLabel),+ );const isCountryMismatch = checkCountryMismatch({partner,verification,});- if (isDuplicate) {+ if (hasDuplicateRiskLabel) {effectiveStatus = "declined";declineReason = DUPLICATE_IDENTITY_DECLINE_REASON;++ waitUntil(+ detectDuplicateIdentityFraud({+ veriffSessionId: id,+ riskLabels,+ }),+ );} else if (isCountryMismatch) {effectiveStatus = "declined";declineReason = `Your document country (${verification.document?.country}) does not match your account country (${partner.country})`;@@ -109,8 +122,6 @@ export const handleDecisionEvent = async ({data: {identityVerificationStatus: veriffStatusMap[effectiveStatus],identityVerifiedAt,- veriffIdentityHash:- effectiveStatus === "approved" ? veriffIdentityHash : null,veriffMetadata,},select: {@@ -148,32 +159,6 @@ function checkCountryMismatch({return partner.country.toUpperCase() !== veriffCountry;}-async function checkDuplicateIdentity({- partner,- veriffIdentityHash,-}: {- partner: Pick<Partner, "id">;- veriffIdentityHash: string | null;-}): Promise<boolean> {- if (!veriffIdentityHash) {- return false;- }-- const duplicatePartner = await prisma.partner.findFirst({- where: {- veriffIdentityHash,- id: {- not: partner.id,- },- },- select: {- id: true,- },- });-- return !!duplicatePartner;-}-async function sendEmailNotification({partner,attemptId,diff --git a/apps/web/app/api/veriff/webhook/handle-session-event.ts b/apps/web/app/api/veriff/webhook/handle-session-event.tsindex d289de39a5..b79b303c1a 100644--- a/apps/web/app/api/veriff/webhook/handle-session-event.ts+++ b/apps/web/app/api/veriff/webhook/handle-session-event.ts@@ -40,7 +40,6 @@ export const handleSessionEvent = async ({},data: {identityVerificationStatus: action,- veriffIdentityHash: null,veriffMetadata,},});diff --git a/apps/web/lib/api/fraud/constants.ts b/apps/web/lib/api/fraud/constants.tsindex dfe5f651f9..891f859d88 100644--- a/apps/web/lib/api/fraud/constants.ts+++ b/apps/web/lib/api/fraud/constants.ts@@ -56,6 +56,16 @@ export const FRAUD_RULES: FraudRuleInfo[] = [severity: "high",configurable: true,},+ // Not visible in the UI+ {+ type: "partnerDuplicateAccount",+ name: "Duplicate account detected",+ description:+ "This partner was flagged by our system for having 2 or more Dub accounts. Please review to prevent abuse of program restrictions, caps, or bonuses.",+ scope: "partner",+ severity: "low",+ configurable: false,+ },{type: "partnerEmailDomainMismatch",name: "Email domain mismatch with website",diff --git a/apps/web/lib/api/fraud/detect-duplicate-identity-fraud.ts b/apps/web/lib/api/fraud/detect-duplicate-identity-fraud.tsnew file mode 100644index 0000000000..977ecc5aac--- /dev/null+++ b/apps/web/lib/api/fraud/detect-duplicate-identity-fraud.ts@@ -0,0 +1,128 @@+import { CreateFraudEventInput } from "@/lib/types";+import {+ VeriffDecisionEvent,+ VeriffRiskLabel,+ veriffRiskLabels,+} from "@/lib/veriff/schema";+import { INACTIVE_ENROLLMENT_STATUSES } from "@/lib/zod/schemas/partners";+import { prisma } from "@dub/prisma";+import { FraudRuleType, ProgramEnrollment } from "@dub/prisma/client";+import { createFraudEvents } from "./create-fraud-events";+import { isFraudRuleEnabled } from "./get-merged-fraud-rules";++// Check for duplicate identities: if multiple partners share the same identity,+// create fraud events for all their active program enrollments to flag potential fraud+export async function detectDuplicateIdentityFraud({+ veriffSessionId,+ riskLabels,+}: {+ veriffSessionId: string;+ riskLabels: VeriffDecisionEvent["verification"]["riskLabels"];+}) {+ if (!riskLabels || riskLabels.length === 0) {+ console.log("[detectDuplicateIdentityFraud] No risk labels provided.");++ return;+ }++ let veriffSessionIds = riskLabels+ .filter(({ label }) => veriffRiskLabels.includes(label as VeriffRiskLabel))+ .map(({ sessionIds }) => sessionIds)+ .flat();++ // Add the current veriff session id to the list+ veriffSessionIds.push(veriffSessionId);++ // Remove duplicates+ veriffSessionIds = [...new Set(veriffSessionIds)];++ if (veriffSessionIds.length === 0) {+ console.log(+ "[detectDuplicateIdentityFraud] No veriff session ids provided.",+ );+ return;+ }++ let programEnrollments = await prisma.programEnrollment.findMany({+ where: {+ partner: {+ veriffSessionId: {+ in: veriffSessionIds,+ },+ },+ },+ select: {+ programId: true,+ partnerId: true,+ status: true,+ program: {+ select: {+ fraudRules: true,+ },+ },+ },+ });++ if (programEnrollments.length === 0) {+ console.log("[detectDuplicateIdentityFraud] No program enrollments found.");+ return;+ }++ // Filter out program enrollments where the partnerDuplicateAccount rule is disabled+ programEnrollments = programEnrollments.filter((enrollment) =>+ isFraudRuleEnabled({+ fraudRules: enrollment.program.fraudRules,+ ruleType: FraudRuleType.partnerDuplicatePayoutMethod, // TODO: Change to partnerDuplicateAccount+ }),+ );++ // Group partners by program enrollment+ let partnersByProgram = programEnrollments.reduce((map, e) => {+ if (!map.has(e.programId)) {+ map.set(e.programId, []);+ }++ map.get(e.programId)!.push({+ partnerId: e.partnerId,+ status: e.status,+ });++ return map;+ }, new Map<string, Pick<ProgramEnrollment, "partnerId" | "status">[]>());++ // Filter out programs with only one partner+ partnersByProgram = new Map(+ Array.from(partnersByProgram.entries()).filter(+ ([_, partners]) => partners.length > 1,+ ),+ );++ if (partnersByProgram.size === 0) {+ console.log("[detectDuplicateIdentityFraud] No multiple partners found.");+ return;+ }++ const fraudEvents: CreateFraudEventInput[] = [];++ for (const [programId, partners] of partnersByProgram.entries()) {+ for (const sourcePartner of partners) {+ if (INACTIVE_ENROLLMENT_STATUSES.includes(sourcePartner.status)) {+ continue;+ }++ for (const enrolledPartner of partners) {+ fraudEvents.push({+ programId,+ partnerId: sourcePartner.partnerId,+ type: FraudRuleType.partnerDuplicateAccount,+ metadata: {+ duplicatePartnerId: enrolledPartner.partnerId,+ riskLabels,+ },+ });+ }+ }+ }++ await createFraudEvents(fraudEvents);+}diff --git a/apps/web/lib/api/fraud/execute-fraud-rule.ts b/apps/web/lib/api/fraud/execute-fraud-rule.tsindex 421adda3a8..d8ef692a4d 100644--- a/apps/web/lib/api/fraud/execute-fraud-rule.ts+++ b/apps/web/lib/api/fraud/execute-fraud-rule.ts@@ -26,6 +26,7 @@ const FRAUD_RULES_REGISTRY: Record<partnerDuplicatePayoutMethod: defineFraudRuleStub("partnerDuplicatePayoutMethod",),+ partnerDuplicateAccount: defineFraudRuleStub("partnerDuplicateAccount"),};// Execute a fraud rule with the given context and configurationdiff --git a/apps/web/lib/api/fraud/utils.ts b/apps/web/lib/api/fraud/utils.tsindex 05f00bf715..f9233b5dcb 100644--- a/apps/web/lib/api/fraud/utils.ts+++ b/apps/web/lib/api/fraud/utils.ts@@ -90,6 +90,7 @@ function getIdentityFieldsForFraudEvent({};case "partnerDuplicatePayoutMethod":+ case "partnerDuplicateAccount":return {duplicatePartnerId: eventMetadata?.duplicatePartnerId,};@@ -130,13 +131,15 @@ export function createGroupCompositeKey(}// Determine the correct partnerId for a fraud event.-// For duplicate payout method events, uses the duplicatePartnerId from metadata.export function getPartnerIdForFraudEvent(event: Pick<CreateFraudEventInput, "partnerId" | "type" | "metadata">,) {const metadata = event.metadata as Record<string, string> | undefined;- if (event.type === "partnerDuplicatePayoutMethod") {+ if (+ event.type === "partnerDuplicatePayoutMethod" ||+ event.type === "partnerDuplicateAccount"+ ) {return metadata?.duplicatePartnerId ?? event.partnerId;}diff --git a/apps/web/lib/auth/partner.ts b/apps/web/lib/auth/partner.tsindex 84031b2854..d9a5053f3a 100644--- a/apps/web/lib/auth/partner.ts+++ b/apps/web/lib/auth/partner.ts@@ -224,9 +224,6 @@ export const withPartnerProfile = (salesChannels: true,platforms: true,},- omit: {- veriffIdentityHash: true,- },},},});diff --git a/apps/web/lib/veriff/compute-veriff-identity-hash.ts b/apps/web/lib/veriff/compute-veriff-identity-hash.tsdeleted file mode 100644index 98895166ae..0000000000--- a/apps/web/lib/veriff/compute-veriff-identity-hash.ts+++ /dev/null@@ -1,36 +0,0 @@-import { createHash } from "crypto";-import { VeriffDecisionEvent } from "./schema";--export function computeVeriffIdentityHash(- verification: VeriffDecisionEvent["verification"],-) {- const { person, document } = verification;- const documentNumber = document?.number?.trim();- const documentCountry = document?.country?.trim();- const firstName = person?.firstName?.trim();- const lastName = person?.lastName?.trim();- const dateOfBirth = person?.dateOfBirth?.trim();-- // Prefer document number (passport/ID number) — strongest unique signal- if (documentNumber) {- const input = [- "doc",- documentNumber.toLowerCase(),- ...(documentCountry ? [documentCountry.toUpperCase()] : []),- ].join("|");- return createHash("sha256").update(input).digest("hex");- }-- // Fall back to name + date of birth- if ((firstName || lastName) && dateOfBirth) {- const input = [- "person",- ...(firstName ? [firstName.toLowerCase()] : []),- ...(lastName ? [lastName.toLowerCase()] : []),- dateOfBirth,- ].join("|");- return createHash("sha256").update(input).digest("hex");- }-- return null;-}diff --git a/apps/web/lib/veriff/schema.ts b/apps/web/lib/veriff/schema.tsindex 03e1e4e50a..a6221b8e29 100644--- a/apps/web/lib/veriff/schema.ts+++ b/apps/web/lib/veriff/schema.ts@@ -64,6 +64,16 @@ export const veriffDecisionEventSchema = z.object({country: z.string().nullable(),}).optional(),+ riskLabels: z+ .array(+ z.object({+ label: z.string(),+ category: z.string(),+ sessionIds: z.array(z.string()),+ }),+ )+ .nullish()+ .describe("Only sent on production environment."),}),});@@ -73,3 +83,12 @@ export const veriffEventSchema = z.union([veriffSessionEventSchema,veriffDecisionEventSchema,]);++// https://help.veriff.com/en/articles/3410712-risk-insights-and-crosslinks+// This schema only includes the categories we care about; others may exist but are ignored.+export const veriffRiskLabels = [+ "person_previously_approved",+ "document_previously_approved",+] as const;++export type VeriffRiskLabel = (typeof veriffRiskLabels)[number];diff --git a/apps/web/lib/zod/schemas/fraud.ts b/apps/web/lib/zod/schemas/fraud.tsindex ce5343d2a5..100bb7f026 100644--- a/apps/web/lib/zod/schemas/fraud.ts+++ b/apps/web/lib/zod/schemas/fraud.ts@@ -252,6 +252,7 @@ export const updateFraudRuleSettingsSchema = z.object({customerEmailSuspiciousDomain: toggleOnlyFraudRuleSchema,partnerCrossProgramBan: toggleOnlyFraudRuleSchema,partnerDuplicatePayoutMethod: toggleOnlyFraudRuleSchema,+ partnerDuplicateAccount: toggleOnlyFraudRuleSchema,});const baseFraudEventSchema = z.object({@@ -326,6 +327,8 @@ export const fraudEventSchemas = {}),partnerDuplicatePayoutMethod: baseFraudEventSchema,++ partnerDuplicateAccount: baseFraudEventSchema,};export const fraudAlertSchema = z.object({diff --git a/apps/web/scripts/programs/update-commissions-canceled.ts b/apps/web/scripts/programs/update-commissions-canceled.tsindex d6b0b8ae58..525f7a7f5b 100644--- a/apps/web/scripts/programs/update-commissions-canceled.ts+++ b/apps/web/scripts/programs/update-commissions-canceled.ts@@ -91,7 +91,6 @@ async function main() {await syncTotalCommissions({partnerId,programId,- mode: "direct",});}}diff --git a/apps/web/tests/fraud/fraud-groups.test.ts b/apps/web/tests/fraud/fraud-groups.test.tsindex 3c36b2dfb8..b54f053407 100644--- a/apps/web/tests/fraud/fraud-groups.test.ts+++ b/apps/web/tests/fraud/fraud-groups.test.ts@@ -66,6 +66,7 @@ describe.concurrent("/fraud/groups", async () => {FraudRuleType.customerEmailSuspiciousDomain,FraudRuleType.referralSourceBanned,FraudRuleType.paidTrafficDetected,+ FraudRuleType.partnerDuplicateAccount,];for (const fraudType of typesToTest) {diff --git a/apps/web/ui/partners/fraud-risks/fraud-events-tables/index.tsx b/apps/web/ui/partners/fraud-risks/fraud-events-tables/index.tsxindex 30164aa620..3ea29fd446 100644--- a/apps/web/ui/partners/fraud-risks/fraud-events-tables/index.tsx+++ b/apps/web/ui/partners/fraud-risks/fraud-events-tables/index.tsx@@ -15,6 +15,7 @@ const FRAUD_EVENTS_TABLES: Partial<Record<FraudRuleType, React.ComponentType>> =paidTrafficDetected: FraudPaidTrafficDetectedTable,partnerCrossProgramBan: FraudCrossProgramBanTable,partnerDuplicatePayoutMethod: FraudPartnerInfoTable,+ partnerDuplicateAccount: FraudPartnerInfoTable,};export function FraudEventsTableWrapper({diff --git a/packages/prisma/schema/fraud.prisma b/packages/prisma/schema/fraud.prismaindex 5918159317..f831377661 100644--- a/packages/prisma/schema/fraud.prisma+++ b/packages/prisma/schema/fraud.prisma@@ -10,6 +10,7 @@ enum FraudRuleType {paidTrafficDetectedpartnerCrossProgramBan // Cross-program ban from other programspartnerDuplicatePayoutMethod // Duplicate payout method with other partners+ partnerDuplicateAccount // Duplicate identity with other partners}model FraudRule {diff --git a/packages/prisma/schema/partner.prisma b/packages/prisma/schema/partner.prismaindex cbad0c3ac3..7120365480 100644--- a/packages/prisma/schema/partner.prisma+++ b/packages/prisma/schema/partner.prisma@@ -48,7 +48,6 @@ model Partner {identityVerificationStatus IdentityVerificationStatus?identityVerifiedAt DateTime?veriffSessionId String? @unique- veriffIdentityHash String? @uniqueveriffMetadata Json? // see veriffMetadataSchema// payout fields