Get access to an existing Wallet

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.

Create a new Wallet Request signing

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

Step 1: Request email code

Step 2: Generate a new access key pair

Step 3: Activate the access key

​Step 1: Request email code

​Step 2: Generate a new access key pair

​Step 3: Activate the access key

Step 1: Request email code

Step 2: Generate a new access key pair

Step 3: Activate the access key