查询会员余额

1、查询会员余额

接口路径

• Get
• /api/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	响应数据详情
--agent_id	商户 ID	string	商户 ID
--user_id	商户侧用户 ID	string	商户侧用户 ID
--balance	当前余额	string	当前余额
--currency	币种	string	币种

请求范例

curl --location 'https://staging.aig1234.com/api/wallet/balance?agent_id=agent001&currency=VND2&user_id=testUid03&timestamp=1732589849000&sign=554f8c395b712dbee3e18c79c6274408' \
--header 'Content-Type: application/json'

响应范例

{
    "code": 200,
    "message": "success",
    "data": {
        "agent_id": "agent001",
        "user_id": "testUid03",
        "balance": "500.00",
        "currency": "VND2"
    }
}

错误码

200 成功
408000 请求参数错误
408003 白名单限制
408004 API频率限制
600100 签名不合法
600101 参数不合法
700101 商户不存在
700103 会员不存在
700201 会员钱包不存在
700202 会员钱包类型不是转账钱包