简要描述
- 充值下单操作为异步请求,报文返回成功,则表示受理成功,具体充值是否成功,则需要我方发起异步通知,或者下游发起查询请求来判断
请求URL
http://ip:port/order/interest
请求方式
- 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 |
产品运营商,枚举值见文档底部 |
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": 9,
"sign":"6848b1f4a28a67aa203ae1038113ec90"
}
返回参数说明
参数名 |
类型 |
说明 |
code |
Integer |
返回结果码 |
msg |
String |
返回结果信息 |
success |
Boolean |
code为200返回true,其他false |
data |
Map |
数据集合,提单成功返回 |
data. orderId |
Long |
我方平台订单id,提单成功返回 |
返回示例
{
"code":200,
"msg":"订单提交成功",
"data":{
"orderId":"1407727321389207552"
},
"success":true
}
{
"code":413,
"msg":"订单号重复",
"success":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 |
失败 |
充值失败 |
运营商 |
枚举 |
京东 |
9 |
饿了么 |
10 |
美团 |
11 |
麦当劳 |
12 |
必胜客 |
13 |
哔哩哔哩 |
14 |
QQ音乐 |
15 |
肯德基 |
16 |
芒果视频 |
17 |
滴滴出行 |
18 |
猫眼电影 |
19 |
网易云 |
20 |
pp视频 |
21 |
腾讯黄钻 |
22 |
QQ会员 |
23 |
瑞幸咖啡 |
24 |
搜狐视频黄金会员 |
25 |
芒果TV会员 |
26 |
优酷 |
27 |
腾讯视频 |
28 |
酷喵 |
29 |
风行视频 |
30 |
暴风影音 |
31 |
爱奇艺视频 |
32 |
搜狐视频 |
33 |
迅雷 |
34 |
爱奇艺 |
35 |
天猫 |
36 |