海心下游对接接口文档


油卡充值下单接口

简要描述
  • 充值下单操作为异步请求,报文返回成功,则表示受理成功,具体充值是否成功,则需要我方发起异步通知,或者下游发起查询请求来判断
请求URL
  • http://ip:port/order/submitOil
请求方式
  • 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 回调地址(不需要url编码)
productOperator int 产品运营商,中石油:4,中石化:5,广东石化:6
phoneNo String 充值人手机号
creditMessage String 充值人身份证号码
name String 充值人姓名
sign String 签名,MD5(userId+key+productId+ requestId + number)
请求示例
{

    "number":"13966666666",

    "productId":10015,

    "requestId":"6607378090040",

    "checkPrice":"10.0900",

    "callbackUrl":"http://127.0.0.1:8080/callback",

    "productOperator": 4,

    "creditMessage": "111111111111111111",

    "name": "张三",

    "phoneNo": "13666666666",

    "sign":"6848b1f4a28a67aa203ae1038113ec90"

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

    "code":200,

    "msg":"订单提交成功",

    "data":{

        "orderId":"1407727321389207552"

    }

}
 {

    "code":413,

    "msg":"订单号重复"

}
  • 错误码
错误码 结果 注释
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