# Create Wallet

Creates a new cryptocurrency wallet entry for a user. This endpoint must be called from your secure backend server.

Security: Requires merchant authentication headers.

Endpoint: POST /wallets
Version: 1.0.0
Security: MerchantAuth

## Header parameters:

  - `merchant-client-id` (string, required)
    Your merchant client identifier (must be kept secure)

## Request fields (application/json):

  - `walletAddress` (string, required)
    Cryptocurrency wallet address
    Example: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

  - `currencyCode` (string, required)
    Currency code (e.g., BTC, ETH, USDT)
    Example: "USDT"

  - `networkCode` (string)
    Blockchain network code (e.g., ERC20, TRC20, BEP20)
    Example: "ERC20"

## Response 201 fields (application/json):

  - `code` (string)
    Result code indicating the operation status
    Example: "OK"

  - `data` (object)
    Response data payload

  - `data.id` (integer)
    Unique wallet identifier
    Example: 1001

  - `data.user` (object)

  - `data.user.firstName` (string)
    Example: "John"

  - `data.user.lastName` (string)
    Example: "Doe"

  - `data.walletAddress` (string)
    Cryptocurrency wallet address
    Example: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

  - `data.currencyCode` (string)
    Currency code
    Example: "USDT"

  - `data.networkCode` (string)
    Network code
    Example: "ERC20"

  - `message` (string)
    Human-readable response message
    Example: "Operation completed successfully"

## Response 400 fields (application/json):

  - `code` (string)
    Error code
    Example: "INVALID_INPUT"

  - `message` (string)
    Error message
    Example: "Invalid JSON in request body"

## Response 401 fields (application/json):

  - `code` (string)
    Error code
    Example: "INVALID_INPUT"

  - `message` (string)
    Error message
    Example: "Invalid JSON in request body"

## Response 500 fields (application/json):

  - `code` (string)
    Error code
    Example: "INVALID_INPUT"

  - `message` (string)
    Error message
    Example: "Invalid JSON in request body"