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

# Player Balance Query

> Used for player balance refresh (implemented by vendor)



## OpenAPI

````yaml en/seamless-openapi.json POST /dt/callback/balance
openapi: 3.1.0
info:
  title: Seamless Wallet API
  description: Seamless Wallet API documentation, including Game-API and Wallet-API
  version: 1.0.0
servers:
  - url: https://api.example.com
    description: API Server
security: []
tags:
  - name: Game-API User
    description: Game API - User operations
  - name: Game-API Report
    description: Game API - Report queries
  - name: Game-API Internal
    description: Game API - Internal use (hidden)
  - name: Wallet-API
    description: Wallet API - Implemented by vendor
paths:
  /dt/callback/balance:
    post:
      tags:
        - Wallet-API
      summary: Player Balance Query
      description: Used for player balance refresh (implemented by vendor)
      operationId: getBalance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - platform_id
                - token
                - uuid
                - account
              properties:
                platform_id:
                  type: string
                  description: Platform product ID
                token:
                  type: string
                  description: >-
                    Verification code, md5(platform_id + uuid + account +
                    platform_secret)
                uuid:
                  type: string
                  description: >-
                    Platform-defined unique request serial number, length >= 32
                    and <= 128 bytes
                account:
                  type: string
                  description: Player account
            example:
              platform_id: H88
              token: E444957EDE11A261BF7F6E215ED1F1D6
              uuid: lobby1-82818443591811
              account: c001
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletApiResponse'
              example:
                code: 0
                message: success
                uuid: d12e08fd-26de-4b2e-87a6-5dec92786800
                timestamp: 1668580007001
                data:
                  account: c001
                  credit: 115
                  reserved: 100
                  balance: 215
                  platform_id: H88
components:
  schemas:
    WalletApiResponse:
      $ref: '#/components/schemas/WalletApiResponseBase'
      description: getBalance response
    WalletApiResponseBase:
      type: object
      description: Base structure for Wallet API response
      properties:
        code:
          type: integer
          description: Error code
        message:
          type: string
          description: Error message
        uuid:
          type: string
          description: Custom unique request serial number
        timestamp:
          type: integer
          description: UNIX time, milliseconds
        data:
          type: object
          properties:
            account:
              type: string
              description: Player account
            credit:
              type: number
              description: Regular wallet credit
            reserved:
              type: number
              description: Reserved wallet credit
            balance:
              type: number
              description: Player total balance
            platform_id:
              type: string
              description: Platform product ID

````