海心接口文档-规范说明
直充对接文档
卡券提取对接文档
账户查询
账户余额查询
产品查询
账户余额查询
简要描述
  • 下游查询在平台的账户余额,每10秒只能查询一次
请求URL
  • http://ip:port/balance/query
请求方式
  • POST
  • application/json;charset=UTF-8
请求参数说明
参数名 必选 类型 说明
sign String 签名,MD5(userId+key)
请求示例
复制{

    "sign":"d653bc1fc21e412bbe775473e2041f0e"

}
返回参数说明
参数名 类型 说明
code Integer 返回结果码,200查询成功
msg String 返回结果信息
data Map 数据集合,提单成功返回
data. balance BigDecimal 账户余额,单位元,保留四位小数
data. creditBalance BigDecimal 授信金额,单位元,保留四位小数
data. freezeBalance BigDecimal 冻结金额(订单未完时,会冻结该笔订单的充值金额),单位元,保留四位小数
data. enableBalance BigDecimal 可用金额=balance + creditBalance - freezeBalance,单位元,保留四位小数。
返回示例
复制 {
    "code": 200,
    "msg": "操作成功",
    "data": {
        "balance": 86353.1900,
        "creditBalance": 0.0000,
        "freezeBalance": 10409.6500,
        "enableBalance": 75943.5400
    },
    "success": true
}
  • 错误码
错误码 注释
200 查询成功
412 白名单校验失败
422 验签失败(请检查加签参数与顺序是否正确)
500 服务异常(请检查请求方式,参数格式,类型是否正确)
  • 备注:无

海心下游对接接口文档


账户余额查询

<h5>简要描述</h5> <ul> <li>下游查询在平台的账户余额,每10秒只能查询一次</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://ip:port/balance/query</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> <li>application/json;charset=UTF-8 </li> </ul> <h5>请求参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>签名,MD5(userId+key)</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{     &amp;quot;sign&amp;quot;:&amp;quot;d653bc1fc21e412bbe775473e2041f0e&amp;quot; }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">Integer</td> <td>返回结果码,200查询成功</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">String</td> <td>返回结果信息</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">Map</td> <td>数据集合,提单成功返回</td> </tr> <tr> <td style="text-align: left;">data. balance</td> <td style="text-align: left;">BigDecimal</td> <td>账户余额,单位元,保留四位小数</td> </tr> <tr> <td style="text-align: left;">data. creditBalance</td> <td style="text-align: left;">BigDecimal</td> <td>授信金额,单位元,保留四位小数</td> </tr> <tr> <td style="text-align: left;">data. freezeBalance</td> <td style="text-align: left;">BigDecimal</td> <td>冻结金额(订单未完时,会冻结该笔订单的充值金额),单位元,保留四位小数</td> </tr> <tr> <td style="text-align: left;">data. enableBalance</td> <td style="text-align: left;">BigDecimal</td> <td>可用金额=balance + creditBalance - freezeBalance,单位元,保留四位小数。</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code> {     &amp;quot;code&amp;quot;: 200,     &amp;quot;msg&amp;quot;: &amp;quot;操作成功&amp;quot;,     &amp;quot;data&amp;quot;: {         &amp;quot;balance&amp;quot;: 86353.1900,         &amp;quot;creditBalance&amp;quot;: 0.0000,         &amp;quot;freezeBalance&amp;quot;: 10409.6500,         &amp;quot;enableBalance&amp;quot;: 75943.5400     },     &amp;quot;success&amp;quot;: true } </code></pre> <ul> <li>错误码</li> </ul> <table> <thead> <tr> <th style="text-align: left;">错误码</th> <th style="text-align: left;">注释</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">200</td> <td style="text-align: left;">查询成功</td> </tr> <tr> <td style="text-align: left;">412</td> <td style="text-align: left;">白名单校验失败</td> </tr> <tr> <td style="text-align: left;">422</td> <td style="text-align: left;">验签失败(请检查加签参数与顺序是否正确)</td> </tr> <tr> <td style="text-align: left;">500</td> <td style="text-align: left;">服务异常(请检查请求方式,参数格式,类型是否正确)</td> </tr> </tbody> </table> <ul> <li>备注:无</li> </ul>

页面列表

ITEM_HTML