查询账户余额

相关内容:


该接口用于查询某个小游戏中可供提现的红包金额剩余。 该接口每10秒最多调用1次。

接口地址
请求方式 地址
GET https://api.kuaiyugo.com/api/payment/v1/programs/:programId/transfers/withdraw?timestamp=1548315226&nonce_str=abc123&signature=20ec96c1f22979398ac06a0f13e49207
参数说明

以下各字段均为必填:

字段 类型 说明 位置
programId string 星汉下发的小程序programId params
timestamp number 秒级时间戳,整数 input
nonce_str string 最长32位的随机字符串,用于签名的计算 input
signature string 签名,具体算法在下文详述 input
字段 类型 说明 位置
miniprogram string 小程序appid header
accesstoken string 星汉平台的accessToken,不建议使用 header
jwt string 星汉平台jwt校验 ,建议使用 header

其中, accesstokenjwt 需选择其中任一使用。

返回格式
{
    "err": 0,
    "data": {
        "amount": 100
    },
    "msg": "请求成功"
}
返回值说明
字段 类型 说明
err number 错误码,非0即有错误
msg string 提示信息
data object 返回数据
data.amount number 红包账户余额,单位为分
异常说明
错误码 状态码 提示文本 说明
1331 200 应用未授权 该应用没有提现资格,需联系商务对接人开启权限
1337 200 ip不在授信范围内 需联系商务对接人添加ip白名单
1339 200 签名错误
1345 200 无法找到应用密钥 请联系商务对接组配置
1347 200 查询操作过快 每10秒最多调用1次
签名
/**
* 签名算法
* @param {Object} signatureData 包含字段:open_id、order_no、amount、timestamp 和 nonce_str
* @param {String} transactionKey 由星汉平台提供的交易 Key(Transaction Key),请联系对接负责人获取 Key
* @return {String} 签名
*/
function sign (signatureData, transactionKey) {
    // 字段要务必!务必!务必!按照字典升序排序!!!
    let signatureStr = Object.keys(signatureData).filter(function(key){
        return signatureData[key] !== undefined && signatureData[key] !== '';
    }).sort().map(function(key){
        return key + '=' + signatureData[key];
    }).join('&');
    signatureStr += transactionKey;
    // 使用 MD5 加密
    return crypto.createHash("md5").update(signatureStr).digest("hex");
},
Last Updated: 3/21/2019, 4:31:09 PM