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:
| 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.
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/catchand start the trial when isCredible can't answer. A check should never stop an honest signup. 429means a rate limit or your daily quota was reached. The SDK retries with backoff; after that, fail open.402(codetrial_endedorsubscription_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.