简要描述
- 充值下单操作为异步请求,报文返回成功,则表示受理成功,具体充值是否成功,则需要我方发起异步通知,或者下游发起查询请求来判断
请求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) |
请求示例
{
&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;: 4,
&quot;creditMessage&quot;: &quot;111111111111111111&quot;,
&quot;name&quot;: &quot;张三&quot;,
&quot;phoneNo&quot;: &quot;13666666666&quot;,
&quot;sign&quot;:&quot;6848b1f4a28a67aa203ae1038113ec90&quot;
}
返回参数说明
参数名 |
类型 |
说明 |
code |
Integer |
返回结果码 |
msg |
String |
返回结果信息 |
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;code&quot;:413,
&quot;msg&quot;:&quot;订单号重复&quot;
}
错误码 |
结果 |
注释 |
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 |
失败 |
充值失败 |