SignupCops SDK

// Identify the user as soon as their email is known.
// Works on any page: login, signup, checkout, profile, and more.

window.dcutils.identifyUser("[email protected]");

// Optionally pass what you already know. Every field is optional.
window.dcutils.identifyUser("[email protected]", {
  externalId: "usr_123abc",   // your own user id
  firstName: "Ada",
  lastName: "Lovelace",
  phone: "+15551234567",
  country: "GB",
  signupMethod: "email",      // or "google", "apple", "phone"
  value: 25,                  // what this signup is worth to you
  currency: "GBP",
});

import { useEffect } from "react";

function LoginPage() {
  const handleLogin = async (email) => {
    // ... your auth logic ...

    // Identify the user after a successful login
    if (window.dcutils) {
      await window.dcutils.identifyUser(email);
    }
  };

  return <form onSubmit={...}>...</form>;
}

// app/login/page.tsx  (Next.js App Router)
"use client";

export default function LoginPage() {
  const handleSubmit = async (formData) => {
    const email = formData.get("email");
    // ... your auth logic ...

    // Identify the user, works client-side only
    if (typeof window !== "undefined" && window.dcutils) {
      await window.dcutils.identifyUser(email);
    }
  };

  return <form action={handleSubmit}>...</form>;
}

<script id="datacops_script"
  src="https://cdn.joindatacops.com/script?cop_key=YOUR_COP_KEY" async></script>

# npm
npm install @datacops/services-sdk

# yarn
yarn add @datacops/services-sdk

# pnpm
pnpm add @datacops/services-sdk

import { DCServiceSdk } from "@datacops/services-sdk";

// Initialise once and reuse across your app.
// Your private key is available in Settings, API Keys.
const sdk = new DCServiceSdk({
  apiKey: process.env.DATACOPS_PRIVATE_KEY, // keep this server-side only
});

const result = await sdk.checkEmail("[email protected]");

// result.emailInfo  live risk analysis
console.log(result.emailInfo.action);      // "ALLOW" | "CHALLENGE" | "BLOCK"
console.log(result.emailInfo.risk_label);  // "low" | "medium" | "high" | "critical"
console.log(result.emailInfo.risk_score);  // 0 to 100
console.log(result.emailInfo.reasons);     // why, in plain words
console.log(result.emailInfo.fraud_signals.disposable_domain);           // throw-away email
console.log(result.emailInfo.fraud_signals.identity_flags.free_provider); // Gmail, Yahoo, etc.

// result.userInfo  identity record (null if not yet identified)
console.log(result.userInfo?.related_emails);      // other emails on same device
console.log(result.userInfo?.related_email_count); // total emails for that device
console.log(result.userInfo?.deviceFingerprint);   // device fingerprint object

async function handleSignup(email) {
  const result = await sdk.checkEmail(email);

  if (result.emailInfo.action === "BLOCK") {
    throw new Error("Signup rejected: " + result.emailInfo.reasons.join(", "));
  }

  if (result.emailInfo.action === "CHALLENGE") {
    await flagForReview(email, result.emailInfo);
  }

  // Proceed with signup...
}

import express from "express";
import { DCServiceSdk } from "@datacops/services-sdk";

const sdk = new DCServiceSdk({ apiKey: process.env.DATACOPS_PRIVATE_KEY });
const app = express();

app.post("/api/signup", async (req, res) => {
  const { email } = req.body;
  const { emailInfo } = await sdk.checkEmail(email);

  if (emailInfo.fraud_signals.disposable_domain) {
    return res.status(400).json({ error: "Disposable emails are not accepted." });
  }

  // ... create user account ...
  res.json({ success: true });
});