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

# Wallet Deposit Transactions

> Query wallet deposit transaction history



## OpenAPI

````yaml post /api/v2.1/fincard/virtual/account/walletDepositTransaction
openapi: 3.1.0
info:
  title: Business BFF API
  version: 1.0.0
  description: Backend for Frontend - Business Panels Orchestration Layer
servers:
  - url: https://sandbox.finhub.cloud
    description: Sandbox Environment
security: []
tags:
  - name: AML
    description: Anti-Money Laundering checks and transaction monitoring
  - name: Admin - Consent Management
    description: Operations for managing consent templates and definitions
  - name: B2B Customer - Organization
    description: B2B organization registration and management
  - name: B2C Customer - Individual
    description: Individual customer registration and lifecycle management
  - name: BFF Admin - Tenant Initialization
    description: Lazy tenant initialization for fast startup
  - name: Catalog Hierarchy
    description: Hierarchical catalog management APIs
  - name: Catalog-Process Mapping
    description: APIs for catalog-process relationship management
  - name: Consent
    description: Payment consent creation and approval
  - name: Draft Management
  - name: External Events
    description: Kafka-to-HTTP bridge event ingestion and query
  - name: FinCard Virtual - Webhooks
    description: FinCard Virtual Card Webhook receiver
  - name: FinCard Virtual Account
    description: FinCard Virtual Card Account API proxy
  - name: FinCard Virtual Card Holder
    description: FinCard Virtual Card Holder API proxy
  - name: FinCard Virtual Cards
    description: FinCard Virtual Card API proxy
  - name: FinCard Virtual Common
    description: FinCard Virtual Card Common API proxy
  - name: FinCard Virtual Wallet
    description: FinCard Virtual Card Wallet API v2 proxy
  - name: FinTrans - Operations
    description: Financial transaction operations
  - name: Internal Webhooks
    description: Internal service-to-service webhook trigger (HMAC-secured)
  - name: MFE Preload
    description: MFE preload endpoints for SSR optimization
  - name: MFE Registry
    description: MFE Registry management endpoints
  - name: Payment Consent Management
    description: Operations for managing payment consents and validation
  - name: Person
    description: Person details for process context
  - name: Products
    description: Product Catalog Management API
  - name: Reference Data
    description: Shared reference data (countries, etc.)
  - name: Tenant Lifecycle
    description: Tenant mode transitions and lifecycle management
  - name: Tenant Registration
    description: Self-registration and tenant onboarding
  - name: Transfers
    description: Transfer prepare/execute aliases for muse-proxy compatibility
  - name: Verification
    description: Customer verification (KYC/KYB/AML) management
  - name: Wallet
    description: Wallet operations and balance management
  - name: Webhooks
    description: Webhook subscription and delivery management
paths:
  /api/v2.1/fincard/virtual/account/walletDepositTransaction:
    post:
      tags:
        - FinCard Virtual Account
      summary: Wallet Deposit Transactions (Deprecated)
      description: Query wallet deposit transaction history
      parameters:
        - description: User agent
          name: User-Agent
          in: header
          schema:
            type: string
        - description: Forwarded for
          name: X-Forwarded-For
          in: header
          schema:
            type: string
        - $ref: '#/components/parameters/XForwardedFromHeader'
        - description: Tenant ID
          name: X-Tenant-ID
          in: header
          schema:
            type: string
        - description: Device ID
          name: deviceId
          in: header
          schema:
            type: string
        - description: Platform
          name: platform
          in: header
          schema:
            type: string
      requestBody:
        description: Account transaction request
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountTransactionRequest'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountTransactionResponse'
        '400':
          description: Bad request
        '500':
          description: Internal server error
components:
  parameters:
    XForwardedFromHeader:
      name: X-Forwarded-From
      in: header
      required: true
      description: Client application identifier
      schema:
        type: string
        example: client-app
  schemas:
    AccountTransactionRequest:
      type: object
      description: Account transaction history request
      properties:
        accountId:
          type: string
          examples:
            - wsb-abc123
          description: Account ID (optional filter)
          example: wsb-abc123
        orderNo:
          type: string
          description: Transaction order number (optional filter)
        transactionType:
          type: string
          description: >-
            Transaction type: chain_deposit, chain_withdraw, card_purchase,
            card_deposit, card_withdraw, card_cancel, card_auth_fee_patch,
            card_auth_cross_board_patch, gt_transfer, fixed,
            card_overdraft_statement, gt_transfer_refund
        startTime:
          type: integer
          format: int64
          description: Start time (milliseconds). Time range cannot exceed 30 days.
        endTime:
          type: integer
          format: int64
          description: End time (milliseconds). Time range cannot exceed 30 days.
        pageNum:
          type: integer
          format: int32
          description: Current page. Default is 1
          default: 1
        pageSize:
          type: integer
          format: int32
          description: Number of pages per page. Default 10, maximum 100
          default: 10
    AccountTransactionResponse:
      type: object
      description: Account transaction response
      properties:
        success:
          type: boolean
          description: Success flag
        code:
          type: integer
          format: int32
          description: Response code
        msg:
          type: string
          description: Response message
        data:
          $ref: '#/components/schemas/AccountTransactionData'
          type: object
          description: Response data
    AccountTransactionData:
      type: object
      description: Account transaction data
      properties:
        total:
          type: integer
          format: int64
          description: Total count
        records:
          type: array
          items:
            $ref: '#/components/schemas/TransactionData'
          description: Transaction records
    TransactionData:
      type: object
      description: Account ledger transaction data
      properties:
        txId:
          type: integer
          format: int64
          examples:
            - 517581
          description: Transaction ID (Wasabi original)
          example: 517581
        transactionId:
          type: integer
          format: int64
          description: Transaction ID (BFF extension alias for txId)
        accountId:
          type: string
          examples:
            - '1979009257233215490'
          description: Account ID
          example: '1979009257233215490'
        currency:
          type: string
          examples:
            - USD
          description: Currency
          example: USD
        amount:
          type: number
          examples:
            - 4.08
          description: Amount
          example: 4.08
        balanceBefore:
          type: number
          examples:
            - 99327.04375
          description: Balance before transaction
          example: 99327.04375
        balanceAfter:
          type: number
          examples:
            - 99322.96375
          description: Balance after transaction
          example: 99322.96375
        orderNo:
          type: string
          examples:
            - C2C_UZS_2025122307584616966
          description: Order number
          example: C2C_UZS_2025122307584616966
        bizType:
          type: string
          description: Biz type (Wasabi original)
        transactionType:
          type: string
          description: Transaction type (BFF extension alias for bizType)
        direction:
          type: string
          description: 'Direction: IN, OUT'
        remark:
          type: string
          description: Remark (Wasabi original)
        description:
          type: string
          description: Description (BFF extension alias for remark)
        beforeBalance:
          type: string
          description: Balance before transaction (Wasabi original, String format)
        afterBalance:
          type: string
          description: Balance after transaction (Wasabi original, String format)
        createTime:
          type: integer
          format: int64
          examples:
            - 1766480100874
          description: Transaction time (milliseconds)
          example: 1766480100874
        updateTime:
          type: integer
          format: int64
          description: Update time (milliseconds)
        transactionStatus:
          type: string
          examples:
            - COMPLETED
          description: Transaction status (BFF extension)
          example: COMPLETED

````