Wallet API vs Connect

	Wallet API	HandCash Connect
User	Your user (new or embedded)	Existing HandCash user
Onboarding	Email → create account in your app	Redirect → authorize app
Wallet auth	Sign with user access private key	`authToken` from redirect
Base paths	`/v1/waas/*`	`/v3/connect/`, `/v3/wallet/`, …
npm `@handcash/sdk`	Not included	`Connect`, `Items`, `Users`, …

Common mistake

import { WalletService } from '@handcash/sdk' will fail — that class is not published. Connect wallet helpers are on Connect (Connect.pay, Connect.getBalances). Wallet API requires REST + signing or an OpenAPI-generated client.

Wallet API: Getting started
Connect: v3 Connect authentication

Getting Started Create a new Wallet

Get Started

v3 / Getting Started

v3 / Connect

v3 / Payments

v3 / Items

v3 / Business Wallet

v2 / Item Operations

v2 / Collection Management

v2 / Friends

API / Payment Requests

Wallet API / Whitelabel Services

Common mistake

​Common mistake

Common mistake