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&notify_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