会员文档

提交订单接口（按照产品编码）

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/sendFlowOrderAPI

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

详细说明：

签名规则:

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

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

返回示例：

注明：下单成功，saleprice为当前订单扣款总额，resultMsg为平台订单号；因网络波动等原因未收到我方的响应，请查询订单进一步确认，请勿直接失败

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

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

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/sendFlowOrderAPI

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

详细说明：

签名规则:

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

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

返回示例：

注明：下单成功，saleprice为当前订单扣款总额，resultMsg为平台订单号；因网络波动等原因未收到我方的响应，请查询订单进一步确认，请勿直接失败

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

微信支付宝立减金

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/sendFlowOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
mobile string 是 充值帐号 支付宝账户/微信openid
bizid string 是 商户订单ID（注 : 订单号必须唯一） 只支持最长36位字符串
productid string 是 商品ID 固定产品ID，详细联系商务
notifyurl string 是 本条充值的状态报告推送地址 http://yourreceiveurl_address
infomsg string 是 批次号 我方提供，详细联系商务
key string 是 数字签名 MD5加密串(32位，小写)

详细说明：

签名规则:

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

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

返回示例：

注明：下单成功，saleprice为当前订单扣款总额，resultMsg为平台订单号

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

微信支付宝红包

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/sendFlowOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
mobile string 是 充值帐号 支付宝账户/微信openid
bizid string 是 商户订单ID（注 : 订单号必须唯一） 只支持最长36位字符串
productid string 是 商品ID 固定产品ID，详细联系商务
notifyurl string 是 本条充值的状态报告推送地址 http://yourreceiveurl_address
infomsg string 是 批次号 我方提供，详细联系商务
hongbaovalue string 否 自定义红包金额 只支持到小数点2位,单位元，例如88.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(userid + mobile + productid + sign)，加密方式为MD5 (32位，小写)

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

返回示例：

注明：下单成功，saleprice为当前订单扣款总额，resultMsg为平台订单号

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

微信支付宝转账

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/sendFlowOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
mobile string 是 充值帐号 支付宝账户/微信openid
bizid string 是 商户订单ID（注 : 订单号必须唯一） 只支持最长36位字符串
productid string 是 商品ID 固定产品ID，详细联系商务
notifyurl string 是 本条充值的状态报告推送地址 http://yourreceiveurl_address
infomsg string 是 批次号 我方提供，详细联系商务
hongbaovalue string 否 自定义转账金额 只支持到小数点2位，单位元，例如88.88
hbaoactnote string 否 自定义转账备注 不可超过240字符，一个中文算2个字符，可以用#data#替代金额，请用URLEncoder编码传输
key string 是 数字签名 MD5加密串(32位，小写)

详细说明：

签名规则:

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

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

返回示例：

注明：下单成功，saleprice为当前订单扣款总额，resultMsg为平台订单号

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

订单状态查询接口

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://inquery.kp-api.com/ms/queryOrderStatusAPI

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

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
orderid string 否 系统订单ID orderid为空可以不加入签名计算
bizid string 否 商户订单ID bizid为空可以不加入签名计算
key string 是 数字签名(32位，小写) MD5(userid+orderid+bizid+sign);注：orderid和bizid为空可以不加入签名计算，但是两者必须存在一个有值；如果两个都有值，则使用orderid字段签名

详细说明：

查询成功,resultCode为T00002

resultMsg为订单状态：0，未充值；1：充值中；2：充值成功；3：充值失败；

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

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

返回示例：

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

订单状态通知

请求方式：POST 参数为json格式

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

详细说明：

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

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

余额查询接口

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://account.kp-api.com/ms/queryBalanceAPI

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

返回示例：

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

京东直充/卡密

京东下单流程

1），调用京东验证码跟短信凭证发送接口,相同号码一分钟之内只允许调用一次，请控制流速

2），调用京东验证码回填验证接口

3），成功验证之后，调用下单接口

注：短信有效期为5分钟

京东验证码发送接口

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/sendShortMessage

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID 用户id
productid string 是 商品ID 京东E卡直冲ID：9200101001，京东E卡卡密ID：9200001001
mobile string 是 充值帐号 1520xxx
timestamp string 是 请求时间 当前调用时间，格式为 yyyy-MM-dd HH:mm:ss
key string 是 数字签名(32位，小写) MD5(userid + mobile +productid+ timestamp + sign);

返回示例：

                                {"resultCode":"T00001","resultMsg":"发送成功"},当resultCode为T00001为成功，其他都为失败，resultMsg成功或者失败原因

京东验证码回填验证接口

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/checkShortMessage

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
mobile string 是 充值帐号 152xxxx
productid string 是 商品ID 京东E卡直冲ID：9200101001，京东E卡卡密ID：9200001001
verifyCode string 是 客户收到的验证码 445566
timestamp string 是 请求时间 当前调用时间，格式为 yyyy-MM-dd HH:mm:ss
key string 是 数字签名(32位，小写) MD5(userid + mobile +productid+ timestamp+verifyCode + sign)

返回示例：

                                {"resultCode":"T00001","resultMsg":"验证成功"},当resultCode为T00001为成功，其他都为失败

京东提交接口

请求方式：POST，参数格式为form-data

请求地址：http://open.kp-api.com/ms/sendFlowOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
mobile string 是 充值帐号 15205201314（充值号码）
bizid string 是 商户订单ID（注 : 订单号必须唯一） 只支持最长36位字符串
productid string 是 商品ID 京东E卡直冲ID：9200101001，京东E卡卡密ID：9200001001
notifyurl string 是 本条充值的状态报告推送地址 http://yourreceiveurl_address
buynum string 是 充值数量 例如56元，就传入56
infomsg string 是 短信验证码 手机收到的短信验证码
key string 是 数字签名 MD5加密串(32位，小写)

详细说明：

签名规则:

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

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

返回示例：

注明：下单成功，saleprice为扣款总额，resultMsg为平台订单号

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

前向产品直充

前向产品下单流程

1），调用前向产品验证码跟短信凭证发送接口,相同号码一分钟之内只允许调用一次，请控制流速

2），调用前向产品验证码回填验证接口

3），成功验证之后，调用下单接口

注：短信有效期为5分钟

前向产品验证码发送接口

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/sendShortMessage

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID 用户id
productid string 是 商品ID 跟商务索取
mobile string 是 充值帐号 1520xxx
timestamp string 是 请求时间 当前调用时间，格式为 yyyy-MM-dd HH:mm:ss
key string 是 数字签名(32位，小写) MD5(userid + mobile +productid+ timestamp + sign);

返回示例：

                                {"resultCode":"T00001","resultMsg":"发送成功"},当resultCode为T00001为成功，其他都为失败，resultMsg成功或者失败原因

前向产品验证码回填验证接口

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://open.kp-api.com/ms/checkShortMessage

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
mobile string 是 充值帐号 152xxxx
productid string 是 商品ID 00101010010
verifyCode string 是 客户收到的验证码 445566
timestamp string 是 请求时间 当前调用时间，格式为 yyyy-MM-dd HH:mm:ss
key string 是 数字签名(32位，小写) MD5(userid + mobile +productid+ timestamp+verifyCode + sign)

返回示例：

                                {"resultCode":"T00001","resultMsg":"验证成功"},当resultCode为T00001为成功，其他都为失败

前向产品提交接口

请求方式：POST，参数格式为form-data

请求地址：http://open.kp-api.com/ms/sendFlowOrderAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
mobile string 是 充值帐号 15205201314（充值号码）
bizid string 是 商户订单ID（注 : 订单号必须唯一） 只支持最长36位字符串
productid string 是 商品ID 产品id跟商务索取
notifyurl string 是 本条充值的状态报告推送地址 http://yourreceiveurl_address
buynum string 是 充值数量 默认为1
infomsg string 是 短信验证码 手机收到的短信验证码
key string 是 数字签名 MD5加密串(32位，小写)

详细说明：

签名规则:

MD5(userid + mobile + productid + 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
quanstatus string 是 卡券状态 值为1时，已使用；值为2时，已过期；其他未知
kaquanno string 是 微信/支付宝卡券号 41950922667
consumetime string 否 消费时间 2022-12-12 23:12:12
transactionid string 是 交易单号 4200001968202308144873552801
key string 是 数字签名(32位，小写) MD5(orderid+userid + mobile +sign);

详细说明：

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

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

立减金核销记录查询

请求方式：POST 参数请不要转json，application/x-www-form-urlencoded格式

请求地址：http://inquery.kp-api.com/ms/queryActivityRecordAPI

请求参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
bizid string 是 商户订单ID xxxx
mobile string 是 充值帐号 支付宝id/微信openid
infomsg string 是 批次号 我方提供，详细联系商务
key string 是 数字签名(32位，小写) MD5(userid+infomsg+sign);
返回主要参数 类型 必需 描述 示例 e.g.
quanstatus string 是 卡券状态 值为1时，已使用；值为2时，已过期；其他未知
consumetime string 否 消费时间 2022-12-12 23:12:12
transactionid string 是 交易单号 4200001968202308144873552801
mobile string 是 充值帐号 支付宝账户/微信openid
kaquanno string 是 微信/支付宝卡券号 41950922667

详细说明：

查询成功,resultCode为T00002

data为立减金核销记录数组类型。数组对象说明：orderid：我方系统订单ID，consumetime：核销时间，transactionid：交易单号。其他同请求参数名说明

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

返回示例：

            {"data": [{"kaquanno": "41950482716","orderid": "D123020620140234618","infomsg": "17189564","mobile": "oVjij5BZOzUinlRcpwOkeHarHXpo","bizid": "D123020620140234618","userid": "P44238","quanstatus": 0,"consumetime": null}],"resultCode": "T00002"}

支付宝吱口令

请求方式：POST 参数为x-www-form-urlencoded格式

请求地址：http://inquery.kp-api.com/ms/createShareTokenCodec

Body参数名 类型 必需 描述 示例 e.g.
userid string 是 会员ID P160
icon string 是 展示在吱口令解码面板上的图标 https://xxxx
day string 否 有效期多少天，默认1天，最多30天 1，表1天
desc string 是 展示在吱口令解码的面板上的描述文案 快来参与活动吧
title string 是 展示在吱口令解码的面板上的标题字段 吱口令
btntitle string 是 吱口令解码面板上的右下方按钮文案，默认 点击参与 点击参与
url string 是 吱口令解码面板上右下方按钮的链接,该链接必须是小程序地址 alipays://platformapi/startapp?appId=xxxx&page=xxx
ts string 是 时间戳 17021021
sign string 是 数字签名(32位，小写)

详细说明：

签名规则:

MD5(userid + ts +sign)，加密方式为MD5 (32位，小写)

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

返回示例：

            {"data":{"guiderStr":"长按复制此条消息，去吱f.u保首页进行搜索 y:/xxx k:/7 CZ4683 2020/06/24","expireDate":"2024-05-07 16:22:31","shareToken":"xxx"},"resultCode":"T00002"}

附录

下单接口返回码

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

订单查询接口返回码

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

回调接口返回码

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