Skip to main content
Shipping an app? Get started for appId, credits, sponsors. Users verify on neus.network. Your app sets returnUrl and builds the link with the SDK. After completion: finish session with @neus/sdk, Authorization: Bearer on API calls. SDK Authentication MCP: run neus_context first; tools return neus.network/verify links without requiring a key. Add Bearer with your personal access key from Access keys when you need a signed-in MCP session. MCP Auth

​
When to use

NeedWhy hosted
Login / signupGuided signer
Social linkingOAuth in NEUS
Human / org checksInteractive flows

​
URL

Base: https://neus.network/verify
ParamRole
intent=loginSession-first login
verifiersComma-separated IDs
presetBundled verifier set
gateIdGate requirements
returnUrlWhere to send the user next
mode=popupPopup + postMessage
originOpener origin (popup)

​
Auth surfaces

How hosted login behaves by environment (passkeys use WebAuthn in a secure context; a missing platform authenticator does not block cross-device or security-key prompts).
SurfacePasskeysWallet (AppKit / WalletConnect)
Desktop browserLocal passkey, phone handoff, or cross-device when the browser supports itConnect Wallet from the page; QR and mobile flows need a normal user gesture
Mobile browser or installed PWAPlatform password manager or authenticator when availablePrefer the wallet app or the deep link the browser offers
WebAuthn: use https, or http://localhost with an origin that matches your NEUS profile. Avoid raw LAN IPs. PWA: service worker does not intercept /api/; do not cache auth traffic for hosted flows.

​
Code

import { getHostedCheckoutUrl } from '@neus/sdk';

const verifyUrl = getHostedCheckoutUrl({
  verifiers: ['ownership-basic'],
  returnUrl: 'https://myapp.com/callback',
});

window.location.href = verifyUrl;
Popup: mode: 'popup', origin: window.location.origin, then window.open. Listen for neus_checkout_done or neus_login_complete. Redirect: handle returnUrl and finish with the SDK.

​
Next

Authentication

Session token and Bearer.

Receipts

What to store after verify.