高盛 · 商户对接接口文档

{
  "Code": 0,
  "Message": "成功",
  "Data": { }
}

account=M100001
api_key=your-api-key
api_code=AG
username=demo_user
password=demo_pass

{
  "Code": 0,
  "Message": "成功",
  "Data": {
    "username": "demo_user",
    "game_username": "demo_user"
  }
}

account=M100001
api_key=your-api-key
api_code=AG
username=demo_user
gameType=1
gameCode=0
isMobile=0

{
  "Code": 0,
  "Message": "成功",
  "Data": {
    "url": "https://game.example.com/launch?token=xxx",
    "specialurl": ""
  }
}

{
  "Code": 0,
  "Message": "成功",
  "Data": {
    "balance": 100.56
  }
}

{
  "Code": 0,
  "Message": "成功",
  "Data": {
    "transferno": "2026110100000001",
    "status": "success"
  }
}

{
  "Code": 0,
  "Message": "成功",
  "Data": {
    "name": "M100001",
    "code": "CURRENCY",
    "money": 1000
  }
}

account=M100001
api_key=your-api-key
platform=PG
start_at=1793329860
end_at=1793333460
page=1
pageSize=100

{
  "Code": 0,
  "Message": "成功",
  "Data": {
    "total_count": 8,
    "lastPage": 4,
    "pageSize": 2,
    "page": 2,
    "data": [
      {
        "id": 1793805,
        "rowid": "1210627807831229",
        "billNo": "2021101708273880136788",
        "code": "OB",
        "username": "a3212",
        "playName": "asa3212",
        "gameName": "赤壁之战",
        "gameType": 5,
        "playType": "西班牙甲级联赛",
        "xzhm": "全场独赢",
        "Odds": "1.84",
        "tableCode": null,
        "roundNo": "1198139",
        "betAmount": "20.00",
        "validBetAmount": "20.00",
        "netAmount": "-20",
        "status": 1,
        "Lottery_results": null,
        "betTime": 1634453258,
        "updateTime": 0
      }
    ]
  }
}

account=M100001
api_key=your-api-key
api_code=AG
username=demo_user
amount=100
transferno=202611010000000001

{
  "Code": 0,
  "Message": "成功",
  "Data": {
    "deposit": 100
  }
}

{
  "Code": 0,
  "Message": "成功",
  "Data": {
    "withdrawal": 100
  }
}

signStr   = merchantId + timestamp + apiKey + bodyStr
X-Signature = hex( HMAC-SHA256( key = apiSecret, data = signStr ) )

$merchantId = 'M100001';
$apiKey     = 'your-api-key';
$apiSecret  = 'your-api-secret';
$timestamp  = (string)time();

// POST：bodyStr 为请求体原文
$body = json_encode(['merchant_user_id' => 'u_1001'], JSON_UNESCAPED_UNICODE);

// GET：bodyStr 为空字符串
// $body = '';

$signStr   = $merchantId . $timestamp . $apiKey . $body;
$signature = hash_hmac('sha256', $signStr, $apiSecret);

curl -X GET "https://【服务域名】/api/v1/merchant/balance" \
  -H "X-Merchant-Id: M100001" \
  -H "X-API-Key: your-api-key" \
  -H "X-Timestamp: 1793329860" \
  -H "X-Signature: 9f2c1a..."

{
  "success": true,
  "data": { },
  "message": "操作成功"
}

{
  "success": false,
  "message": "错误描述",
  "error_code": 1002,
  "details": "补充说明"
}

{
  "merchant_user_id": "u_1001",
  "email": "user1001@example.com",
  "username": "user1001",
  "extra_data": { "vip": 1 }
}

{
  "success": true,
  "data": {
    "user_id": "USR_1001",
    "merchant_user_id": "u_1001",
    "usdt_address": "TXYZExampleAddress123456789",
    "balance": 0,
    "created_at": "2026-11-01 10:00:00"
  },
  "message": "创建成功"
}

{
  "success": true,
  "data": {
    "user_id": "USR_1001",
    "merchant_user_id": "u_1001",
    "usdt_address": "TXYZExampleAddress123456789",
    "balance": 100.5,
    "frozen_balance": 10.0,
    "total_deposits": 200.5,
    "total_withdrawals": 90.0,
    "status": "active",
    "created_at": "2026-11-01 10:00:00"
  }
}

{
  "success": true,
  "data": {
    "stats": {
      "total": 5000.5,
      "pending": 2,
      "today": 120.0
    },
    "deposits": [
      {
        "deposit_id": "DEP_9001",
        "merchant_user_id": "u_1001",
        "username": "user1001",
        "amount": 100.5,
        "fee": 0,
        "tx_hash": "abc123...",
        "from_address": "TSenderAddress...",
        "to_address": "TXYZExampleAddress123456789",
        "confirmations": 6,
        "status": "confirmed",
        "created_at": "2026-11-01 10:00:00",
        "confirmed_at": "2026-11-01 10:01:00"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 50,
      "total_pages": 3
    }
  }
}

{
  "success": true,
  "data": {
    "total_balance": 5000.5,
    "frozen_balance": 200.0,
    "available_balance": 4800.5,
    "today_deposits": 120.0,
    "today_withdrawals": 90.0,
    "total_users": 128
  }
}

{
  "success": true,
  "data": {
    "record_id": 88,
    "total": 128,
    "success": 120,
    "failed": 3,
    "skipped": 5,
    "stopped": false,
    "results": [
      {
        "user_id": 1001,
        "from_address": "TXYZExampleAddress123456789",
        "amount": 150.5,
        "status": "success",
        "tx_hash": "abc123...",
        "error_msg": null,
        "onchain_usdt": 150.5,
        "onchain_trx": 12.0
      }
    ]
  },
  "message": "归集完成：成功 120 笔，失败 3 笔，跳过 5 笔（未达阈值）"
}