# No-card free trials

URL: https://iscredible.com/docs/integrations/no-card-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](https://iscredible.com/docs/integrations/nextjs), [Supabase](https://iscredible.com/docs/integrations/supabase), [Clerk](https://iscredible.com/docs/integrations/clerk), [Firebase](https://iscredible.com/docs/integrations/firebase) and [Django](https://iscredible.com/docs/integrations/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:

Node.js:

```typescript
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);
```

Python:

```python
result = client.verify(
    {
        "email": email,
        "ip": ip,
        "userAgent": user_agent,
        "deviceId": device_id,
        "eventType": "signup",
        "accountCreation": True,
    },
    scenario_ids=["SYS_FREE_TRIAL_ABUSE_001", "SYS_MULTI_ACCOUNT_001"],
)
action, reasons = 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](https://iscredible.com/docs/guides/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:

| Decision | Suggested action |
|---|---|
| APPROVE | Start the full trial |
| REVIEW | Start a smaller trial (fewer credits or days), or ask for a phone or email code first |
| DENY | Skip 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.

Node.js:

```typescript
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." });
```

Python:

```python
decision = client.check_usage(
    str(user.id),
    {"metric": "credits", "used": credits_used, "limit": trial_credits, "window": "trial"},
    {"deviceId": device_id, "ip": ip, "accountCreatedAt": user.created_at.isoformat()},
)
if decision["action"] == "DENY":
    return {"error": "Your free trial allowance is used up. Choose a plan to continue."}, 402
```

On **REVIEW**, slow the account down or ask for a phone check before more free usage. See [Stop resource abuse](https://iscredible.com/docs/guides/usage).

## 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.

```typescript
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](https://iscredible.com/docs/integrations/express) and [Django](https://iscredible.com/docs/integrations/django) guides.

> **Tip: 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.
