海心下游对接接口文档


电费充值下单接口

简要描述
  • 充值下单操作为异步请求,报文返回成功,则表示受理成功,具体充值是否成功,则需要我方发起异步通知,或者下游发起查询请求来判断
请求URL
  • http://ip:port/order/submitPower
请求方式
  • POST
  • application/json;charset=UTF-8
请求参数说明
参数名 必选 类型 说明
productId Long 平台商品id
requestId string 流水Id,下游生成,不可重复
number string 充值号码
checkPrice BigDecimal 校验价格,单位元,保留四位小数。我方平台提供该商品的代理价格(售价 x 折扣) 。<font color=LightCoral >校验价格与面额必传其一 </font>
faceValue Integer 面额,单位元。<font color=LightCoral >校验价格与面额必传其一 </font>
timeOut Integer 超时时间,单位秒。
callbackUrl String 回调地址
productOperator int 产品运营商,南网:7,国网:8
creditType int 身份类型,个人:1,店铺:2,企业:3
creditMessage String 身份信息,身份证后六位/营业执照后六位/银行卡后六位,南网必传
province String 省份,例如:广东
city String 城市,例如:广州
sign String 签名,MD5(userId+key+productId+ requestId + number)
请求示例
{

    &quot;number&quot;:&quot;13966666666&quot;,

    &quot;productId&quot;:10015,

    &quot;requestId&quot;:&quot;6607378090040&quot;,

    &quot;checkPrice&quot;:&quot;10.0900&quot;,

    &quot;callbackUrl&quot;:&quot;http://127.0.0.1:8080/callback&quot;,

    &quot;productOperator&quot;: 7,

    &quot;creditType&quot;: 1,

    &quot;creditMessage&quot;: &quot;123456&quot;,

    &quot;province&quot;: &quot;广东&quot;,

    &quot;city&quot;: &quot;广州&quot;,

    &quot;sign&quot;:&quot;6848b1f4a28a67aa203ae1038113ec90&quot;

}
返回参数说明
参数名 类型 说明
code Integer 返回结果码
msg String 返回结果信息
success Boolean code为200返回true,其他false
data Map 数据集合,提单成功返回
data. orderId Long 我方平台订单id,提单成功返回
返回示例
 {

    &quot;code&quot;:200,

    &quot;msg&quot;:&quot;订单提交成功&quot;,

    &quot;data&quot;:{

        &quot;orderId&quot;:&quot;1407727321389207552&quot;

    },

    &quot;success&quot;:true

}
 {

    &quot;code&quot;:413,

    &quot;msg&quot;:&quot;订单号重复&quot;,

    &quot;success&quot;:false

}
  • 错误码
错误码 结果 注释
200 受理成功 <font color=LightCoral >受理成功,但不代理充值成功。充值结果以平台回调结果或通过订单查询接口结果为准</font>
400 失败 参数有误(失败)
410 失败 用户不存在(检查请求头是否传了Authorization-User并且是否正确) (失败)
412 失败 白名单校验失败(失败)
413 人工确认 <font color=LightCoral >流水号重复(每次请求都要求唯一) (人工确认,如果确实重复提交了,重复的订单也可以当失败处理) </font>
414 失败 产品不存在(失败)
415 失败 用户没有配置该产品(请联系平台工作人员进行配置) (失败)
416 失败 校验价格校验失败,输入价格与实际代理价格不一致(失败)
417 失败 账户余额不足(失败)
418 失败 用户没有配置供货商通道(请联系平台工作人员进行配置) (失败)
419 失败 供货商没有配置产品信息(请联系平台工作人员进行配置) (失败)
422 失败 验签失败(请检查加签参数与顺序是否正确) (失败)
423 失败 充值失败,流控不通过
500 人工确认 <font color=LightCoral >服务异常(请检查请求方式,参数格式,类型是否正确) (请求格式没问题需人工确认,或者调订单查询接口查看结果,不可当失败处理)</font>
505 失败 充值失败
  • 备注:无

页面列表

ITEM_HTML