OneTrial with Next.js (App Router)
- Snippet on the signup page:
html<script src="https://onetrial.dev/v1.js" data-key="YOUR_PUBLIC_KEY" async></script>
- Send the token with the form:
js// Signup form (browser): include the token in your POSTconst token = await OneTrial.getToken(); // window.OneTrial is set by the snippetOneTrial.markSubmit(); // records time-to-submitformData.append('visitorToken', token);
- Decide in a Route Handler (server):
ts// app/api/signup/route.tsimport { headers } from 'next/headers';export async function POST(req: Request) {const { email, visitorToken } = await req.json();const ip = (await headers()).get('x-forwarded-for')?.split(',')[0] ?? '0.0.0.0';const userId = await createUser(email);const res = await fetch('https://onetrial.dev/api/v1/decisions', {method: 'POST',headers: { Authorization: `Bearer ${process.env.ONETRIAL_API_KEY}`, 'Content-Type': 'application/json' },body: JSON.stringify({ visitorToken, email, ip, userId }),});const d = await res.json();if (d.decision === 'deny') return showPaidPlanOrSupport();if (d.decision === 'challenge') return redirect(d.challengeUrl); // trial unlocks on the challenge.completed webhookcreateTrial(userId);return Response.json({ ok: true });}
- Env:
ONETRIAL_API_KEY=ot_test_...(server only). Test keys hit the same engine; switch toot_live_when you go live. - Verify:
GET /api/v1/integration/statusreturns a checklist. Shadow mode is on until you flip it.
Snippet placement:
app/layout.tsx -> <Script src="https://onetrial.dev/v1.js" data-key="..." strategy="afterInteractive" /> from next/script.