订单提交接口(电费,抖音,游戏)
[TOC]
简要描述
- 通过此接口提交电费,游戏或抖音充值订单
请求URL
地址:http://平台服务地址:9086/gameonlinepay.do
请求方式
- post
Header
header | 示例值 | 必选 | 类型 | 说明 |
---|---|---|---|---|
Content-type | 是 | string | application/x-www-form-urlencoded |
请求Body参数
参数名 | 示例值 | 必选 | 类型 | 说明 |
---|---|---|---|---|
userid | 是 | string | 商户编号(非登录名),平台方提供 | |
productid | 否 | string | 平台商品编号,可为空,为空时根据号码判断运营商, 充流量时填写对应流量商品编号 | |
num | 是 | string | 订单商品数量 | |
areaid | 否 | string | 游戏账户所在区编号,国网电费时传用户手机号. | |
serverid | 否 | string | 游戏账户所在服编号 | |
account | 是 | string | 需充值账号(电费格式注一) | |
userip | 否 | string | 买家IP由合作商提供,南网电费此字段传身份证号(不参与签名 ) | |
spordertime | 是 | string | 代理商订单时间(yyyyMMddHHmmss)如20210224134552 | |
sporderid | 是 | string | 代理商系统订单号(流水号)要求不可重复,每笔只可同时提交一次 | |
sign | 是 | string | 验证摘要串(注二) | |
back_url | 否 | string | 回调URL,(不参与签名 ) |
成功返回示例
<?xml version="1.0" encoding="GB2312" ?> -
<order>
<orderid>XS090428000003</orderid>
<productid>3312</productid>
<num>1</num>
<ordercash>98.5</ordercash>
<productname>游戏直充</productname>
<sporderid>2009042800001</sporderid>
<account>13590101510</account>
<resultno>0</resultno>
</order>
成功返回示例的参数说明
参数名 | 类型 | 说明 |
---|---|---|
orderid | string | 直充平台订单号 |
productid | string | 商品编号 |
num | string | 数量 |
ordercash | string | 订单金额 |
productname | string | 商品名称 |
sporderid | string | 商户平台订单号 |
account | string | 待充值账号 |
resultno | string | 直充结果编码 详见备注描述 |
备注
(注一)电费account 为一个JSON格式:
{“product_type”:”3”,”userid”:”123123123”,”username”:””,”type”:”1”,”area”:”江苏”,”city”:”南京”}
“product_type” 必填 1:话费,2:流量,3:电费,4:油卡
“userid” 必填 需要充值的户号
“username” 可选 南网用户传 身份证后六位
“type” 可选 户号类型 : 1:住宅,2:店铺,3:企事业,4:身份证, 7:代扣银行卡 ,6:营业执照/机构代码
“area” 可选 北京,江苏,广东,等省份信息
“city” 可选 北京,南京
(注二)验证摘要串规则:
sign=MD5(userid=xxxx&productid=xxxxxxx&num=xxx&areaid=xxx&serverid=xxx&account=xxxxx&spordertime=xxxxxxx&sporderid=xxxxx&key=xxxxxxx).toUpperCase()
签名时key和顺序都不能错.参数值为空的时候传空字符串参与签名,不是传null.大小写敏感.
字符串内中文使用GBK字符集!
userid和key 都由平台提供,请联系商务获取