Skip to main content
Create embedded wallets with the Wallet API REST endpoints. Generate a secp256k1 access key pair on your server before starting. Base URL: https://cloud.handcash.io
Headers (account steps): app-id, app-secret, Content-Type: application/json
Wallet creation must be enabled for your App ID. Contact sales@handcash.io if account creation fails with a feature or limit error.

Step 1: Request email verification

The user receives a verification code by email. Complete that flow before creating the account (HandCash validates the email when you call create account).

Step 2: Generate an access key pair

You can use @noble/curves only for key generation; Wallet API wallet calls do not require @handcash/sdk.

Step 3: Check alias availability (optional)

Step 4: Create the wallet account

Response includes deposit info (paymail, address, etc.). See OpenAPI schema wallet-depositInfoSchema.

Step 5: Wallet operations

Use the access private key to sign requests for /v1/waas/wallet/* — balances, pay, transactions, etc. See Wallet operations.

Sequence diagram