POST http://域名/yrapi.php/index/recharge
请求体(Request Body)
| 参数名称 | 数据类型 | 示例 | 不为空 | 描述 |
|---|---|---|---|---|
| out_trade_num | string | CZH668877 | true | 商户订单号,由商户自己生成唯一单号。(同一商户,不能存在相同单号订单,相同订单号不能提单) |
| product_id | number | 66 | true | 产品ID(代理后台查看) |
| mobile | string | 18866667777 | true | 充值号码(手机号、电费户、QQ号等) |
| notify_url | string | http://www.abc.com | true | 回调地址,用于接收充值状态回调 |
| userid | string | 99 | true | 商户ID,通过客服或代理后台获取 |
| amount | number | 100 | false | 面值,(不传不校验)如果产品的面值与此参数不同,提单驳回 |
| price | number | 95.9 | false | 最高成本,(不传不校验)如果产品成本超过这个值,提单驳回 |
| area | string | 广东 | false | 电费省份/直辖市,如:四川、北京、上海,仅电费带此参数 |
| ytype | string | 1 | false | 电费验证三要素,1-身份证后6位,2-银行卡后六位,3-营业执照后六位,仅南网电费带此参数 |
| id_card_no | string | 123456 | false | 身份证后6位/银行卡后6位/营业执照后6位,仅南网电费带此参数 |
| city | string | 广州 | false | 地级市名,仅部分南网电费带此参数,是否带此参数需咨询渠道方 |
| param1 | string | * | false | 扩展参数,后台查看提交的产品类目是否需要提交此参数 |
| param1 | string | * | false | 扩展参数,后台查看提交的产品类目是否需要提交此参数 |
| param1 | string | * | false | 扩展参数,后台查看提交的产品类目是否需要提交此参数 |
| sign | string | JCXHF8S66BO6MPG5JNW2DGEJ9SB3F7ST | true | 签名,签名规则见“签名说明” |
//请求示例:
out_trade_num=CZH668877&product_id=66&mobile=18866667777¬ify_url=http://www.abc.com/yuanren&userid=99&sign=JCXHF8S66BO6MPG5JNW2DGEJ9SB3F7ST响应体
响应数据格式:JSON,当“http状态非200”或者“响应体无数据时”可能是服务器或其他链路出现故障,无法准确判定是否成功下单,请通过订单查询或者人工方式再次确认状态。
| 参数名称 | 类型 | 示例 | 不为空 | 描述 |
|---|---|---|---|---|
| errno | string | * | true | 错误码,0代表成功,非0代表提交失败 |
| errmsg | string | * | true | 错误描述 |
| data | object | * | true | errno=0时 返回数据 |
| ⇥ order_number | string | * | true | 系统订单号 |
| ⇥ mobile | string | * | true | 充值手机号 |
| ⇥ product_id | string | * | true | 产品ID |
| ⇥ total_price | string | * | true | 消费金额 |
| ⇥ out_trade_num | string | * | true | 商户订单号 |
| ⇥ title | string | * | true | 充值产品说明 |
//响应示例:
{
"errno": 0,
"errmsg": "下单成功",
"data": {
"order_number": "DEM24031101",
"mobile": "18866667777",
"product_id": 66,
"total_price": "90.00",
"out_trade_num": "DEM24031101A00N1",
"title": "100元话费",
}
}作者:MissDoc 创建时间:2024-03-18 14:41
最后编辑:MissDoc 更新时间:2024-03-27 17:15
最后编辑:MissDoc 更新时间:2024-03-27 17:15