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.

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.ts
index 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-verif
import { 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 null
let 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 mismatch
if (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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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 configuration
diff --git a/apps/web/lib/api/fraud/utils.ts b/apps/web/lib/api/fraud/utils.ts
index 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.ts
index 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.ts
deleted file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.prisma
index 5918159317..f831377661 100644
--- a/packages/prisma/schema/fraud.prisma
+++ b/packages/prisma/schema/fraud.prisma
@@ -10,6 +10,7 @@ enum FraudRuleType {
paidTrafficDetected
partnerCrossProgramBan // Cross-program ban from other programs
partnerDuplicatePayoutMethod // 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.prisma
index 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? @unique
veriffMetadata Json? // see veriffMetadataSchema
// payout fields