会员文档

提交订单接口(按照产品编码)

请求方式:POST,参数格式为form-data

请求地址:http://api.gjxnet.com/sendOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
mobile string 充值帐号 15205201314(注 : 提卡业务请输入cards)
bizid string 商户订单ID(注 : 订单号必须唯一) 只支持最长36位字符串
productid string 商品ID 00101010010
notifyurl string 本条充值的状态报告推送地址 http://yourreceiveurl_address
buynum string 充值数量 非必填,默认为1,若提卡业务,数量最大为100
key string 数字签名 MD5加密串(32位,小写)

详细说明:

签名规则:

MD5.digest(userid + mobile + productid + sign),加密方式为MD5 (32位,小写)

密钥sign由充值平台方分配,请妥善保存。上线之前请告知充值平台方技术,请求服务器IP列表,通过IP 白名单加强交易安全

返回示例:

注明:下单成功时,saleprice为扣款总额,resultMsg为我方平台订单号

                                {"resultCode":"T00001","resultMsg":"DO150827152601707","saleprice":"88.88"}
                            

充值接口(按照产品面值)

请求方式:POST,参数格式为form-data

请求地址:http://api.gjxnet.com/sendOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
mobile string 充值帐号 15205201314
bizid string 商户订单ID(注 : 订单号必须唯一) 只支持最长36位字符串
pfacevalue string 商品面值 10(按照元计算,例如十元)
mctype string 是否慢充 1慢充,0快充 ,可以不填写,默认为快充
notifyurl string 本条充值的状态报告推送地址 http://yourreceiveurl_address
buynum string 充值数量 非必填,默认为1
key string 数字签名 MD5加密串(32位,小写)

详细说明:

签名规则:

MD5.digest(userid + mobile + pfacevalue + sign),加密方式为MD5 (32位,小写)

密钥sign由充值平台方分配,请妥善保存。上线之前请告知充值平台方技术,请求服务器IP列表,通过IP 白名单加强交易安全

返回示例:

注明:下单成功时,saleprice为扣款总额,resultMsg为我方平台订单号

                                {"resultCode":"T00001","resultMsg":"DO150827152601707","saleprice":"88.88"}
                            

微信/支付宝红包接口

请求方式:POST,参数格式为form-data

请求地址:http://api.gjxnet.com/sendOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
mobile string 充值账号 支付宝用户账户/微信openid
bizid string 商户订单ID(注 : 订单号必须唯一) 只支持最长36位字符串
productid string 商品ID 固定产品id跟业务人员索取
notifyurl string 本条充值的状态报告推送地址 http://yourreceiveurl_address
extmsg string 批次号 微信/支付宝立减金业务必填为批次号
hongbaovalue string 自定义红包金额,单位元 只支持到小数点2位,例如5.88
hbaosendname string 红包发送者名称 不可超过32字符,一个中文算2个字符,必须使用URLEncoder,防止中文乱码
hbaoactname string 红包活动名称 不可超过128字符,一个中文算2个字符,可以用#data#替代具体面值,必须使用URLEncoder,防止中文乱码
hbaowishing string 红包祝福语 不可超过120字符,一个中文算2个字符,必须使用URLEncoder,防止中文乱码
hbaoactnote string 自定义红包备注 不可超过240字符,一个中文算2个字符,可以用#data#替代具体面值,必须使用URLEncoder,防止中文乱码
key string 数字签名 MD5加密串(32位,小写)

详细说明:

签名规则:

MD5.digest(userid + mobile + productid + sign),加密方式为MD5 (32位,小写)

密钥sign由充值平台方分配,请妥善保存。上线之前请告知充值平台方技术,请求服务器IP列表,通过IP 白名单加强交易安全

返回示例:

注明:下单成功时,saleprice为扣款总额,resultMsg为我方平台订单号

                                {"resultCode":"T00001","resultMsg":"DO150827152601707","saleprice":"88.88"}
                            

微信/支付宝转账接口

请求方式:POST,参数格式为form-data

请求地址:http://api.gjxnet.com/sendOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
mobile string 充值账号 支付宝用户账户/微信openid
bizid string 商户订单ID(注 : 订单号必须唯一) 只支持最长36位字符串
productid string 商品ID 固定产品id跟业务人员索取
notifyurl string 本条充值的状态报告推送地址 http://yourreceiveurl_address
extmsg string 批次号 微信/支付宝立减金业务必填为批次号
hongbaovalue string 自定义转账金额,单位元 只支持到小数点2位,例如5.88
hbaoactnote string 自定义转账备注 不可超过240字符,一个中文算2个字符,可以用#data#替代具体面值,必须使用URLEncoder,防止中文乱码
key string 数字签名 MD5加密串(32位,小写)

详细说明:

签名规则:

MD5.digest(userid + mobile + productid + sign),加密方式为MD5 (32位,小写)

密钥sign由充值平台方分配,请妥善保存。上线之前请告知充值平台方技术,请求服务器IP列表,通过IP 白名单加强交易安全

返回示例:

注明:下单成功时,saleprice为扣款总额,resultMsg为我方平台订单号

                                {"resultCode":"T00001","resultMsg":"DO150827152601707","saleprice":"88.88"}
                            

微信/支付宝立减金接口

请求方式:POST,参数格式为form-data

请求地址:http://api.gjxnet.com/sendOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
mobile string 充值账号 支付宝用户账户/微信openid
bizid string 商户订单ID(注 : 订单号必须唯一) 只支持最长36位字符串
productid string 商品ID 固定产品id跟业务人员索取
notifyurl string 本条充值的状态报告推送地址 http://yourreceiveurl_address
extmsg string 批次号 微信/支付宝立减金业务必填为批次号
key string 数字签名 MD5加密串(32位,小写)

详细说明:

签名规则:

MD5.digest(userid + mobile + productid + sign),加密方式为MD5 (32位,小写)

密钥sign由充值平台方分配,请妥善保存。上线之前请告知充值平台方技术,请求服务器IP列表,通过IP 白名单加强交易安全

返回示例:

注明:下单成功时,saleprice为扣款总额,resultMsg为我方平台订单号

                                {"resultCode":"T00001","resultMsg":"DO150827152601707","saleprice":"88.88"}
                            

微信红包状态查询接口

请求方式:POST,参数格式为form-data

请求地址:http://inquery.gjxnet.com/weixinHongbaoinfoapi

此接口只能用于微信红包状态判断

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
orderid string 我方平台订单ID 我方平台订单ID

详细说明:

查询成功时,resultCode为T00002

status为红包状态,SENDING:发放中,SENT:已发放待领取,FAILED:发放失败,RECEIVED:已领取,RFUND_ING:退款中,REFUND:已退款,NOT_FOUND:红包不存在;

reason为红包失败时候原因(微信提供)。

返回示例:

             {"resultCode":"T00002","orderid":"DO16121015455404245","reason":"用户openid不正确","status":"FAILED"}
        

订单状态查询接口

请求方式:POST,参数格式为form-data

请求地址:http://inquery.gjxnet.com/queryOrderStatusAPI

注明:下单超过10分钟之后,再来查询,否则造成损失自行承担,严禁下单之后立马查询

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
orderid string 我方平台订单ID orderid为空时可以不加入签名计算
bizid string 商户订单ID bizid为空时可以不加入签名计算
key string 数字签名(32位,小写) MD5.digest(userid+orderid+bizid+sign);注:orderid和bizid为空时可以不加入签名计算,但是两者必须存在一个有值

详细说明:

查询成功时,resultCode为T00002

resultMsg为订单状态:0,未充值;1:充值中;2:充值成功;3:充值失败;

resultCode不为T00002都视为查询失败,resultMsg为失败原因。

查询订单充值成功时,moredata字段为话费充值流水凭证

返回示例:

                                {"resultCode":"T00002","resultMsg":"2","moredata":"003420181003114538092850"}
                            

订单状态通知

请求方式:POST,参数格式为form-data

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
orderid string 我方平台订单ID DO16121015455404245
mobile string 充值帐号 15205201314
saleprice string 充值金额 100.33
bizid string 商户订单ID
resultCode string 充值状态码 T00003=充值成功;T00004=充值失败
resultMsg string 返回信息 例如:充值成功[0034XXXX]
cardsInfo string 卡密信息,提卡业务才会出现,返回信息为json数组 例如:[{'cardNo':xxxx(卡号), 'cardPwd':xxxx(卡密), 'expireTime':xxxx(过期时间) }],卡密为加密方式,解密方式请跟我们联系
flowno string 流水号 例如:0034XXXX
refundStatus string 退款状态说明 参数只在订单失败且退款成功才返回信息
key string 数字签名(32位,小写) MD5.digest(orderid+userid + mobile+resultCode +sign);

详细说明:

合作方提供回调地址,格式"http://xxxx",当订单处理结束之后,系统会向合作方发起通知,

合作方接收到通知后返回数字1告知系统接受成功,否则系统会陆续每间隔5分钟重新推送,直到接受到数字1或连续发送5次都失败才终止!

参数获取就是普通键值对方式

余额查询接口

请求方式:POST,参数格式为form-data

请求地址:http://account.gjxnet.com/queryBalanceAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
key string 数字签名(32位,小写) MD5.digest(userid+sign);

返回示例:

                                {"resultCode":"T00002","resultMsg":"2999.23"}
                            

京东礼品卡(直充)

业务流程以及注意事项值

1),调用京东验证码发送接口 (注:相同号码一分钟之内只允许调用一次,请控制流速)

2),调用京东验证码回填验证接口,成功验证之后方可下单

3),京东验证码成功验证之后,调用下单京东接口

发送验证码到京东账户手机号

请求方式:POST,参数格式为form-data

请求地址:http://api.gjxnet.com/sendShortMessage

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
mobile string 充值帐号 15205201314
productid string 指定值 直冲填 34801010011 卡密填 3480101001
timestamp string 请求时间 当前调用时间,格式为 yyyyMMddHHmmss
key string 数字签名 MD5加密串(32位,小写)

详细说明:

签名规则:

MD5.digest(userid + mobile + timestamp + sign),加密方式为MD5 (32位,小写)

密钥sign由充值平台方分配,请妥善保存。上线之前请告知充值平台方技术,请求服务器IP列表,通过IP 白名单加强交易安全

返回示例:

注明:请求成功

                                {"resultCode":"T00001","resultMsg":"发送成功"}
                            

手机号验证码回填校验接口

请求方式:POST,参数格式为form-data

请求地址:http://api.gjxnet.com/checkShortMessage

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
mobile string 充值帐号 15205201314
productid string 指定值 直冲填 34801010011 卡密填 3480101001
verifyCode string 客户收到的验证码 445566
timestamp string 请求时间 当前调用时间,格式为 yyyyMMddHHmmss
key string 数字签名 MD5加密串(32位,小写)

详细说明:

签名规则:

MD5.digest(userid + mobile + timestamp + sign),加密方式为MD5 (32位,小写)

密钥sign由充值平台方分配,请妥善保存。上线之前请告知充值平台方技术,请求服务器IP列表,通过IP 白名单加强交易安全

返回示例:

注明:验证成功时

                                {"resultCode":"T00001","resultMsg":"验证成功"}
                            

京东礼品卡提交接口

请求方式:POST,参数格式为form-data

请求地址:http://api.gjxnet.com/jdOrderAPI

务必注意productid填写规则

请求参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
mobile string 充值帐号 15205201314(注 : 京东账户绑定的手机号)
bizid string 商户订单ID(注 : 订单号必须唯一) 只支持最长36位字符串
productid string 非系统产品ID 例如直冲10元填10,卡密10元填10km,按照此规则填写
notifyurl string 本条充值的状态报告推送地址 http://yourreceiveurl_address
verifyCode string 验证码 一码一充
key string 数字签名 MD5加密串(32位,小写)

详细说明:

签名规则:

MD5.digest(userid + mobile + productid + verifyCode + sign),加密方式为MD5 (32位,小写)

密钥sign由充值平台方分配,请妥善保存。上线之前请告知充值平台方技术,请求服务器IP列表,通过IP 白名单加强交易安全

返回示例:

注明:下单成功时,saleprice为扣款总额,resultMsg为我方平台订单号

                                {"resultCode":"T00001","resultMsg":"DO150827152601707","saleprice":"88.88"}
                            

支付宝/微信立减金核销通知

请求方式:POST 参数为json格式,通知地址需要联系商务绑定

Body参数名 类型 必需 描述 示例 e.g.
userid string 会员ID P160
orderid string 我方平台订单ID DO16121015455404245
mobile string 充值帐号 支付宝用户id/微信openid
status string 卡券状态 值为USED,用户已经使用;其他为未知
consumetime string 消费时间 2019-1-12 23:12:12
key string 数字签名(32位,小写) MD5(orderid+userid + mobile +sign);

详细说明:

合作方提供回调地址,格式"http://xxxx",当订单处理结束之后,系统会向合作方发起通知,

合作方接收到通知后返回数字1告知系统接受成功,否则系统会陆续每间隔5分钟重新推送,直到接受到数字1或连续发送5次都失败才终止!

附录

下单接口返回码

状态码 描述 订单状态
T00001 下单成功 订单已入库
T00006 账户余额不足 订单未入库
T00007 下单失败 订单未入库(详细信息)
T00008 系统异常 类似网络超时,返回值不能正常解析等情况,需核实处理
T00009 订单号已存在 平台已存在该订单号,订单具体状态应查询或核实处理

订单查询接口返回码

状态码 描述 订单状态
T00002 查询成功 resultMsg=2充值成功,resultMsg=3充值失败,resultMsg=其他充值中
T00007 查询失败 (失败原因包括密钥不对,用户ID不对等,建议与平台核实信息)
T00010 订单不存在 下单请求成功并且平台返回流水号,30分钟后所查订单不存在,可失败处理

回调接口返回码

状态码 描述
T00003 充值成功
T00004 充值失败

发送验证码到京东账户接口返回码

状态码 描述
T00001 发送成功
T00007 发送失败,详细见返回详细

手机号验证码回填校验接口返回码

状态码 描述
T00001 发送成功
T00007 验证失败,详细见返回详细