> ## 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.

# Getting Started

> Build native wallet infrastructure into your application with email-based user onboarding

The **Wallet API** (WaaS) provisions embedded HandCash wallets for your users via `/v1/waas/*`. It is separate from **[HandCash Connect](/v3/connect/authentication)**, which links users who already have HandCash.

## Setup

1. Create an application in the [Developer Dashboard](/developer-dashboard).

2. Save your **App ID** and **App Secret** for server-side calls.

3. Contact [sales@handcash.io](mailto:sales@handcash.io) to enable **wallet creation** for your App ID.

4. Use the API contract:
   * **OpenAPI:** [cloud.handcash.io/sdk-docs.json](https://cloud.handcash.io/sdk-docs.json) (filter **Wallet API**)
   * **Explorer:** [cloud.handcash.io/sdk-docs](https://cloud.handcash.io/sdk-docs/)
   * **Base URL:** `https://cloud.handcash.io`

## Overview

| Capability          | Endpoints                                                                                            |
| ------------------- | ---------------------------------------------------------------------------------------------------- |
| User onboarding     | `POST /v1/waas/account/requestEmailCode`, `POST /v1/waas/account`, `POST /v1/waas/account/accessKey` |
| Balances            | `GET /v1/waas/wallet/balances`                                                                       |
| Payments            | `POST /v1/waas/wallet/pay`                                                                           |
| Transaction history | `GET /v1/waas/wallet/transactions`, `GET /v1/waas/wallet/transaction`                                |
| Deposit info        | `GET /v1/waas/wallet/depositInfo`                                                                    |

Account setup uses **`app-id`** and **`app-secret`**. Wallet calls use **[request signing](/wallet-api/request-signing)** with the user’s access private key.

## Next steps

* [Create a new wallet](/wallet-api/create-user-account)
* [Access an existing wallet](/wallet-api/create-authorization-for-existing-account)
* [Request signing](/wallet-api/request-signing)
* [Wallet operations](/wallet-api/manage-wallets)
* [Wallet API vs Connect](/wallet-api/waas-vs-connect)