Hosted Verify is https://neus.network/verify. Use it when a step needs a browser ceremony (passkey, wallet, OAuth, human check, or gate checkout). By default your app does not embed wallet or passkey UI.
What runs here
| Query intent | User completes on NEUS |
|---|
intent=login | NEUS session: passkey sign-in, wallet sign-in, optional passkey registration |
gateId | Gate checkout; wallet steps only if the published gate requires them |
| Social / org proof | OAuth inside a verifier — ownership-social, ownership-org-oauth |
Login vs verification
| Topic | intent=login | Gate checkout (gateId, no login-only intent) |
|---|
| Purpose | NEUS session (Hub, profile, later checks) | Receipt / gate outcome |
| Screen | Dedicated login shell | Composer |
Parameters
| Param | Use |
|---|
intent=login | Hosted login only |
returnUrl | Absolute https://… back to your app after completion. Validated before redirect. |
returnTo | neus.network path only (e.g. /profile). Not for third-party domains. @neus/sdk getHostedCheckoutUrl does not set this; append manually if needed. |
connect=1 | Optional for wallet-native products. With intent=login, auto-starts wallet connect on load |
gateId | Gate definition |
mode=popup | Popup; requires origin |
origin | Opener origin for postMessage |
appId | Advanced server/app attribution only; not required for published gate checkout |
Redirect examples
Checkout / proof (your app):
import { getHostedCheckoutUrl } from '@neus/sdk';
window.location.href = getHostedCheckoutUrl({
gateId: 'gate_your-app-name',
returnUrl: 'https://myapp.com/auth/callback',
});
qHash (and related fields) from your callback URL.
Login then return to your app:
import { getHostedCheckoutUrl } from '@neus/sdk';
window.location.href = getHostedCheckoutUrl({
intent: 'login',
returnUrl: 'https://myapp.com/auth/after-login',
});
neus.network):
https://neus.network/verify?intent=login&returnTo=/profile
/login on neus.network redirects to /verify?intent=login&… with a validated returnTo.
Open with mode: 'popup' and origin: window.location.origin.
| Flow | Opener listens for |
|---|
| Verification / gate | neus_checkout_done (includes qHash when applicable) |
intent=login | neus_login_complete |
No browser handoff
Server-created receipts and access keys: Integrations. Last modified on June 5, 2026
