Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.handcash.io/llms.txt

Use this file to discover all available pages before exploring further.

For users who already have an embedded wallet under your app, request email verification and activate their access key instead of creating a new account. Same headers as Create a new wallet: app-id, app-secret.

​
Step 1: Request email code

POST /v1/waas/account/requestEmailCode

{ "email": "user@example.com" }

​
Step 2: Generate a new access key pair

Generate a fresh key pair on your server (see Create a new wallet).

​
Step 3: Activate the access key

POST /v1/waas/account/accessKey

{
  "email": "user@example.com",
  "accessPublicKey": "<hex-public-key>"
}

await fetch('https://cloud.handcash.io/v1/waas/account/accessKey', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'app-id': process.env.HANDCASH_APP_ID,
    'app-secret': process.env.HANDCASH_APP_SECRET,
  },
  body: JSON.stringify({
    email: 'user@example.com',
    accessPublicKey: publicKeyHex,
  }),
});
Store the private key securely, then use request signing for wallet endpoints. The difference from new account creation: use /v1/waas/account/accessKey instead of POST /v1/waas/account.