Integrations

No-card free trials

Offer a free trial without a card and still keep each person to one trial: check the trial start, then check usage during the trial.

A free trial without a credit card converts more visitors, and it is also the easiest trial to abuse: one person can start trial after trial with new email addresses. This guide protects a no-card trial at the two moments that matter: when the trial starts, and while it is being used.

It works with any signup form, auth provider and payment processor. The examples use the Node.js and Python SDKs; for a specific stack, see the integration guides for Next.js, Supabase, Clerk, Firebase and Django.

1. Check when the trial starts#

Call the Verify API from your backend at signup (or whenever the trial starts), with the data your form already has. Run the free-trial and multi-account scenarios together:

const result = await iscredible.verify(
  {
    email: body.email,
    ip: req.ip,
    userAgent: req.get("user-agent"),
    deviceId: body.deviceId,
    eventType: "signup",
    accountCreation: true
  },
  { scenarioIds: ["SYS_FREE_TRIAL_ABUSE_001", "SYS_MULTI_ACCOUNT_001"] }
);
const { action } = decide(result);

Without a card, the device ID does most of the work of recognising a returning person, so send one. See Send device signals.

2. Decide what kind of trial to give#

A no-card trial doesn't have to be all or nothing. Match the trial to the decision:

DecisionSuggested action
APPROVEStart the full trial
REVIEWStart a smaller trial (fewer credits or days), or ask for a phone or email code first
DENYSkip the trial and show the paid plans, with a neutral message

3. Check usage during the trial#

Some abusers only show themselves once they start using the product: linked accounts sharing one person's free allowance, or a new account burning through it in a day. Check usage before expensive actions with the Usage Screening scenario. The SDK only calls the API when a check is due.

const decision = await iscredible.checkUsage(
  user.id,
  { metric: "credits", used: creditsUsed, limit: trialCredits, window: "trial" },
  { deviceId: body.deviceId, ip: req.ip, accountCreatedAt: user.createdAt }
);
if (decision.action === "DENY") return res.status(402).json({ error: "Your free trial allowance is used up. Choose a plan to continue." });

On REVIEW, slow the account down or ask for a phone check before more free usage. See Stop resource abuse.

4. When the user adds a card#

If the user upgrades, or you ask for a card later, send the card fingerprint from your payment processor with one more check. It links the card to any earlier trials from the same person.

await iscredible.verify(
  { userId: user.id, email: user.email, paymentFingerprint: card.fingerprint },
  { scenarioId: "SYS_FREE_TRIAL_ABUSE_001" }
);

Send only the fingerprint (for Stripe, payment_method.card.fingerprint), never card numbers.

Fail open, and watch your limits#

  • Wrap every call in try/catch and start the trial when isCredible can't answer. A check should never stop an honest signup.
  • 429 means a rate limit or your daily quota was reached. The SDK retries with backoff; after that, fail open.
  • 402 (code trial_ended or subscription_ended) means your isCredible account has no active plan. Fail open and choose a plan in the dashboard.

Full examples of the try/catch helper are in the Express and Django guides.

How checks are counted

Each trial-start check counts once towards your daily quota. Usage checks count only when the SDK actually calls the API, not when it answers from its cache.