油卡充值下单接口

简要描述

• 充值下单操作为异步请求，报文返回成功，则表示受理成功，具体充值是否成功，则需要我方发起异步通知，或者下游发起查询请求来判断

请求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	失败	充值失败

• 备注：无