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

# 傳統開工專用額度申請異常回滾

> 此接口專門處理傳統開工專用額度圈存異動異常回滾（由 vendor 實作）

將不停重試直到成功，實作方需做好判斷，避免重複加款



## OpenAPI

````yaml /seamless-openapi.json POST /dt/callback/rollback_reserved
openapi: 3.1.0
info:
  title: 單一錢包 API
  description: 單一錢包（Seamless Wallet）API 文檔，包含 Game-API 和 Wallet-API
  version: 1.0.0
servers:
  - url: https://api.example.com
    description: API Server
security: []
tags:
  - name: Game-API User
    description: 遊戲 API - 用戶相關操作
  - name: Game-API Report
    description: 遊戲 API - 報表查詢
  - name: Game-API Internal
    description: 遊戲 API - 內部專用（隱藏）
  - name: Wallet-API
    description: 錢包 API - 由 vendor 實作
paths:
  /dt/callback/rollback_reserved:
    post:
      tags:
        - Wallet-API
      summary: 傳統開工專用額度申請異常回滾
      description: |-
        此接口專門處理傳統開工專用額度圈存異動異常回滾（由 vendor 實作）

        將不停重試直到成功，實作方需做好判斷，避免重複加款
      operationId: rollbackReserved
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - platform_id
                - token
                - uuid
                - account
                - type
                - canceled_id
                - transaction_id
                - credit
                - proposal_id
              properties:
                platform_id:
                  type: string
                  description: 平台方產品ID
                token:
                  type: string
                  description: >-
                    驗證碼，md5(platform_id + uuid + account + canceled_id +
                    transaction_id + 平台密鑰)
                uuid:
                  type: string
                  description: 各平台自定義的唯一性請求序號
                account:
                  type: string
                  description: 玩家帳號
                type:
                  type: integer
                  description: 類型 1. 出碼 2. 追碼
                canceled_id:
                  type: string
                  description: 欲取消交易序號，需唯一且不能為空值
                transaction_id:
                  type: string
                  description: >-
                    交易序號，需唯一且不能為空值 (長度 1~128 字元，僅允許 ASCII 32-126 可列印字元，禁止使用 ` 和
                    ~)
                credit:
                  type: integer
                  description: 額度，須為正整數
                proposal_id:
                  type: integer
                  description: 玩家提案號，不能為空值
            example:
              platform_id: H88
              token: E47A56947DF6DA25B6F95C3BFE5748E7
              uuid: lobby1-82818443591811
              account: walter123
              type: 1
              credit: 100
              proposal_id: 954654
              canceled_id: 005-200926080808-0000005
              transaction_id: 005-200926080808-0000005RB
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletApiResponseWithTransaction'
              example:
                code: 0
                message: success
                uuid: lobby1-82818443591811
                timestamp: 1668580007001
                data:
                  account: walter123
                  credit: 115
                  reserved: 100
                  balance: 215
                  platform_id: H88
                  transaction_id: 005-200926080808-0000005RB
components:
  schemas:
    WalletApiResponseWithTransaction:
      type: object
      properties:
        code:
          type: integer
          description: 錯誤代碼
        message:
          type: string
          description: 錯誤訊息
        uuid:
          type: string
          description: 自定義的唯一性請求序號
        timestamp:
          type: integer
          description: UNIX time，毫秒
        data:
          type: object
          properties:
            account:
              type: string
              description: 玩家帳號
            credit:
              type: number
              description: 一般錢包額度
            reserved:
              type: number
              description: 專用錢包額度
            balance:
              type: number
              description: 玩家總額度
            platform_id:
              type: string
              description: 平台方產品ID
            transaction_id:
              type: string
              description: 交易序號

````