> ## Documentation Index
> Fetch the complete documentation index at: https://guides.saber.money/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Dummy Balance [Sandbox Only]

> Creates a dummy crypto deposit record against a user's wallet so you can fund a sandbox user without a real on-chain transfer. Sandbox only, not available in production.

Once the record is created, the credited balance is visible via [Get Wallet Balance](/api-reference/wallet-operations/get-wallet-balance).


## OpenAPI

````yaml openapi-v2.json POST /api/v2/wallet/transaction/create-crypto-deposit-record
openapi: 3.1.0
info:
  title: Saber Money API (v2)
  version: v2
  description: >-
    ## Authentication


    There is no standalone API-key auth — every request must be **signed**. An
    API key by itself authenticates nothing. Each call requires four headers
    together: `X-Api-Key` (your key), `X-Signature` (HMAC-SHA256 of `apiKey +
    timestamp` — or `apiKey + timestamp + userId` when `X-User-Id` is required —
    keyed with your API secret), `X-Timestamp` (unix seconds), and
    `X-Request-Id` (any unique string per request). The signature must be
    computed by a client script; there is no way to derive it by hand. Use the
    HMAC Generator flow to compute valid values for manual testing.


    ## Common Authentication Errors


    - **Invalid Client ID**: {"error_code":6092,"message":"X-Client-Id
    invalid","success":false}

    - **Invalid Secret**: {"error_code":6090,"message":"invalid
    secret","success":false}

    - **Timestamp (Older than 10 secs)**:
    {"errors":{"error_code":6093,"text":"timestamp expired"},"success":false}
servers:
  - url: https://api.saber.money
security: []
paths:
  /api/v2/wallet/transaction/create-crypto-deposit-record:
    post:
      tags:
        - Wallet Operations
      summary: Add Dummy Balance [Sandbox Only]
      description: >-
        Creates a dummy crypto deposit record against a user's wallet so you can
        fund a sandbox user without a real on-chain transfer. Sandbox only, not
        available in production.
      operationId: create-crypto-deposit-record-v2
      parameters:
        - name: X-Api-Key
          in: header
          required: true
          description: Your API key (configured in credentials)
          schema:
            type: string
        - name: X-Signature
          in: header
          required: true
          description: >-
            HMAC-SHA256 signature (auto-generated) To test manually: HMAC-SHA256
            of `apiKey + timestamp` (or `apiKey + timestamp + userId` when
            X-User-Id is required), keyed with your API secret. The HMAC
            Generator flow computes this for you.
          schema:
            type: string
        - name: X-Timestamp
          in: header
          required: true
          description: >-
            Unix timestamp in seconds (auto-generated) Unix seconds, e.g.
            `Math.floor(Date.now() / 1000)`. Must match the timestamp used in
            the X-Signature computation.
          schema:
            type: string
        - name: X-Request-Id
          in: header
          required: true
          description: >-
            Unique request identifier (auto-generated) Any unique string per
            request, e.g. a UUID.
          schema:
            type: string
        - name: X-User-Id
          in: header
          required: true
          description: UUID of the user receiving the balance.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: string
                  description: >-
                    UUID of the user receiving the balance. Same value as
                    X-User-Id.
                symbol:
                  type: string
                  description: Crypto asset to credit, e.g. `USDC`.
                amount:
                  type: number
                  description: Amount to credit.
                network:
                  type: string
                  description: Network the deposit is recorded on, e.g. `MATIC`.
              required:
                - user_id
                - symbol
                - amount
                - network
            example:
              user_id: 550e8400-e29b-41d4-a716-446655440000
              symbol: USDC
              amount: 1
              network: MATIC
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      transaction_type:
                        type: string
                        enum:
                          - EXTERNAL_SELL
                          - POOL_SELL
                          - SELL
                          - BUY
                          - POOL_BUY
                          - EXTERNAL_BUY
                          - DEPOSIT
                          - CRYPTO_DEPOSIT
                          - WITHDRAW
                          - CRYPTO_WITHDRAW
                      status:
                        type: string
                        enum:
                          - CREATED
                          - PAYMENT_INITIATED
                          - FUNDS_RECEIVED
                          - COMPLETED
                          - FAILED
                          - REFUND_INITIATED
                          - REFUND_COMPLETED
                          - REFUND_FAILED
                          - PROCESSING
                          - CANCELLED
                          - APPROVAL_REQUIRED
                          - SOURCE_INVALID
                          - VERIFICATION_PENDING
                          - PENDING
                          - REVERTED
                          - REJECTED
                          - EXPIRED
                          - SUCCESSFUL
                      created_at:
                        type: integer
                      updated_at:
                        type: integer
                      id:
                        type: string
                      crypto_symbol:
                        type: string
                      fiat_symbol:
                        type: string
                      exchange_rate:
                        type:
                          - number
                          - integer
                      crypto_amount:
                        type:
                          - integer
                          - number
                      fiat_amount:
                        type:
                          - number
                          - integer
                      bank_transaction_id:
                        type: string
                      source_id:
                        type: string
                      user_id:
                        type: string
                      usd_value:
                        type: integer
                      deposit_crypto_address:
                        type: string
                      deposit_network:
                        type: string
                      destination_instrument_id:
                        type: string
                      amount:
                        type: integer
                      uuid:
                        type: string
                      symbol:
                        type: string
                      tag:
                        type: string
                      source_address:
                        type: string
                      address:
                        type: string
                      network:
                        type: string
                      txn_hash:
                        type: string

````

## Related topics

- [Reset User [Sandbox Only]](/api-reference/user-operations/reset-user-sandbox-only.md)
- [Reset KYC [Sandbox Only]](/api-reference/kyc-and-edd-operations/reset-kyc-sandbox-only.md)
- [Reset Phone and Email [Sandbox Only]](/api-reference/user-operations/reset-phone-and-email-sandbox-only.md)
- [Approve Bank Account [Sandbox Only]](/api-reference/bank-account-operations/approve-bank-account-sandbox-only.md)
- [Through Saber Widget](/user/bank-account/widget.md)
