查询余额接口格式
1、查询余额接口格式
接口路径
- POST
- /aigame/v1/wallet/balance
请求参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| agent_id | 商户 ID | string | 必填 | 商户ID |
| user_id | 商户侧用户 ID | string | 必填 | 商户侧用户ID, 字符串长度最小3，最大64, 只支持英文、数字以及_ |
| currency | 币种 | string | 必填 | 币种 |
| timestamp | 当前时间戳 | int64 | 必填 | 传调用接口时的时间戳（单位毫秒，有效期十分钟） |
| sign | 签名 | string | 必填 | 签名算法详见接口说明 |
响应参数
| 参数 | 名称 | 类型 | 说明 |
|---|---|---|---|
| code | 响应码 | int | 错误码 |
| message | 响应信息 | string | 错误信息 |
| data | 响应数据 | dict | 响应数据详情 |
| --balance | 玩家余额 | string | 玩家余额 |
| --currency | 币种 | string | 币种 |
请求范例
curl --location 'https://商户侧地址/aigame/v1/wallet/balance' \
--header 'Content-Type: application/json' \
--data '{
"agent_id": "agent001",
"user_id": "testUid03",
"currency": "VND2",
"timestamp": 1732589849000,
"sign": "5c06ed3c98106c627fff753d9499c7a2"
}'
响应范例
{
"code": 200,
"message": "success",
"data": {
"balance": "1282.66"，
"currency": "VND2"
}
}
错误码
200 成功
408000 参数错误
600100 签名错误
600101 参数不合法
800100 服务异常
800101 会员不存在
800102 币种不存在
800103 查询余额失败