直充下单接口
开发者可通过该接口对橙券支持的所有直充产品进行充值,接口调用成功(即下单成功),不代表充值成功;最终“充值结果”,橙券可通过“订单通知接口”通知开发者,或开发者调用“订单查询接口”进行查询。
系统级参数
API参数共由系统级参数和应用级参数两部分构成,系统级参数指所有由橙券提供的API所必须的参数,应用级参数是指对应API所需的参数。
参数名 |
类型 |
描述 |
timestamp |
long |
时间戳,以毫秒为单位。校验开发者与橙券的时间差,橙券允许开发者请求最大时间误差为3分钟 (3*60*1000) |
app_id |
string |
商户账号,由橙券提供,如:13105356515 |
sign |
string |
签名 跳转到签名规范 |
请求地址
https://api.chengquan.cn/order/directCharge
应用级参数
参数名 |
类型 |
是否必须 |
描述 |
order_no |
string(32) |
是 |
商户提交的订单号,最长32位(商户保证其唯一性) |
recharge_number |
string(20) |
是 |
充值账号 |
product_id |
int |
是 |
充值产品编号 |
amount |
int |
是 |
充值数量(加油卡,视频业务默认为1,其它业务按照实际情况传递)。数量范围1-99999 |
ip |
string |
否 |
充值ip(仅腾讯业务需要,根据实际情况进行传递) |
oil_phone_account |
string |
否 |
加油卡充值时用户的手机号 |
notify_url |
string |
否 |
橙券主动通知订单结果地址 |
version |
string |
是 |
版本号 |
响应参数
data说明
参数名 |
类型 |
描述 |
app_id |
string |
商户账号 |
order_no |
string |
商户订单号 |
recharge_number |
string |
充值手机号码 |
start_time |
string |
订单创建时间 |
end_time |
string |
订单完成时间,如果订单为充值中该时间和创建时间相同,如果成功或者失败该时间为订单完成时间。 |
state |
string |
订单状态,详见直充订单状态码说明 |
consume_amount |
decimal |
扣款金额(单位:元),保留小数点后四位 |
成功返回值示例
{
"code": 7000,
"message": "请求通过",
"data": {
"app_id": "13105356515",
"order_no": "WvzLt70AfmMT8fiD4ejyj4hz59QTapBn",
"recharge_number": "13867891280",
"start_time": "2019-04-09 11:28:59",
"end_time": "2019-04-09 11:28:59",
"state": "RECHARGE",
"consume_amount": 100.0
}
}
- 回到顶部
- 155-8952-5929
- 在线咨询
- 微信二维码