> # **支付接口介绍**
> 使用KP码支付平台接口可以实现支付宝、QQ钱包、微信支付的即时到账,免签约,无需企业认证。
本文阅读对象:商户系统(在线购物平台、人工收银系统、自动化智能收银系统或其他)集成KP码支付涉及的技术架构师,研发工程师,测试工程师,系统运维工程师。
## 接口申请方式与特权
本平台免费开放申请接口:
(一)普通支付商户
可以获得一个支付商户,申请费用是0元,在KP官方支付平台申请开通即可。有问题请联系人工申请QQ:[2257110,](http://wpa.qq.com/msgrd?v=3&uin=2257110&site=qq&menu=yes),申请之后会将商户ID和商户KEY发给你!
普通支付商户特权:
可使用平台的易支付与码支付功能!
## 协议规则
传输方式:HTTP
数据格式:JSON
签名算法:MD5
字符编码:UTF-8
* * *
## \[API\]创建商户
API权限:该API只能合作支付商户调用
URL地址:[http://77jl.cn/api.php?act=apply&token={合作者身份TOKEN}&url={商户域名}](http://77jl.cn/api.php?act=apply&token=%7B%E5%90%88%E4%BD%9C%E8%80%85%E8%BA%AB%E4%BB%BDTOKEN%7D&url=%7B%E5%95%86%E6%88%B7%E5%9F%9F%E5%90%8D%7D)
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 操作类型 | act | 是 | String | apply | 此API固定值 |
| 合作者TOKEN | token | 是 | String | 9ddab6c4f2c87ce442de371b04f36d68 | 需要事先申请 |
| 商户域名 | url | 是 | String | [77jl.cn](http://77jl.cn/) | |
返回结果:
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| 返回状态码 | code | Int | 1 | 1为成功,其它值为失败 |
| 返回信息 | msg | String | 添加支付商户成功! | |
| 商户ID | pid | Int | 1001 | 所创建的商户ID |
| 商户密钥 | key | String(32) | 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i | 所创建的商户密钥 |
| 商户类型 | type | Int | 1 | 此值暂无用 |
## \[API\]查询商户信息与结算规则
URL地址:http:/77jl.cn/api.php?act=query&pid={商户ID}&key={商户密钥}
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 操作类型 | act | 是 | String | query | 此API固定值 |
| 商户ID | pid | 是 | Int | 1001 | |
| 商户密钥 | key | 是 | String | 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i | |
返回结果:
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| 返回状态码 | code | Int | 1 | 1为成功,其它值为失败 |
| 商户ID | pid | Int | 1001 | 所创建的商户ID |
| 商户密钥 | key | String(32) | 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i | 所创建的商户密钥 |
| 商户类型 | type | Int | 1 | 此值暂无用 |
| 商户状态 | active | Int | 1 | 1为正常,0为封禁 |
| 商户余额 | money | String | 0.00 | 商户所拥有的余额 |
| 结算账号 | account | String | [2257110@qq.com](mailto:2257110@qq.com) | 结算的支付宝账号 |
| 结算姓名 | username | String | 张三 | 结算的支付宝姓名 |
| 满多少自动结算 | settle\_money | String | 30 | 此值为系统预定义 |
| 手动结算手续费 | settle\_fee | String | 1 | 此值为系统预定义 |
| 每笔订单分成比例 | money\_rate | String | 98 | 此值为系统预定义 |
## \[API\]修改结算账号
URL地址:[http://77jl.cn/api.php?act=change&pid={商户ID}&key={商户密钥}&account={结算账号}&username={结算姓名}](http://77jl.cn/api.php?act=change&pid=%7B%E5%95%86%E6%88%B7ID%7D&key=%7B%E5%95%86%E6%88%B7%E5%AF%86%E9%92%A5%7D&account=%7B%E7%BB%93%E7%AE%97%E8%B4%A6%E5%8F%B7%7D&username=%7B%E7%BB%93%E7%AE%97%E5%A7%93%E5%90%8D%7D)
注:为了保障资金安全,已经设置结算账号的无法再进行修改,如需修改请联系客服
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 操作类型 | act | 是 | String | change | 此API固定值 |
| 商户ID | pid | 是 | Int | 1001 | |
| 商户密钥 | key | 是 | String | 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i | |
| 结算账号 | account | 是 | String | [2257110@qq.com](mailto:2257110@qq.com) | 结算的支付宝账号 |
| 结算姓名 | username | 是 | String | 张三 | 结算的支付宝姓名 |
返回结果:
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| 返回状态码 | code | Int | 1 | 1为成功,其它值为失败 |
| 返回信息 | msg | String | 修改收款账号成功! | |
## \[API\]查询结算记录
URL地址:[http://77jl.cn/api.php?act=settle&pid={商户ID}&key={商户密钥}](http://77jl.cn/api.php?act=settle&pid=%7B%E5%95%86%E6%88%B7ID%7D&key=%7B%E5%95%86%E6%88%B7%E5%AF%86%E9%92%A5%7D)
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 操作类型 | act | 是 | String | settle | 此API固定值 |
| 商户ID | pid | 是 | Int | 1001 | |
| 商户密钥 | key | 是 | String | 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i | |
返回结果:
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| 返回状态码 | code | Int | 1 | 1为成功,其它值为失败 |
| 返回信息 | msg | String | 查询结算记录成功! | |
| 结算记录 | data | Array | 结算记录列表 | |
## \[API\]查询单个订单
URL地址:[http://77jl.cn/api.php?act=order&pid={商户ID}&key={商户密钥}&out\_trade\_no={商户订单号}](http://77jl.cn/api.php?act=order&pid=%7B%E5%95%86%E6%88%B7ID%7D&key=%7B%E5%95%86%E6%88%B7%E5%AF%86%E9%92%A5%7D&out_trade_no=%7B%E5%95%86%E6%88%B7%E8%AE%A2%E5%8D%95%E5%8F%B7%7D)
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 操作类型 | act | 是 | String | order | 此API固定值 |
| 商户ID | pid | 是 | Int | 1001 | |
| 商户密钥 | key | 是 | String | 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i | |
| 商户订单号 | out\_trade\_no | 是 | String | 20160806151343349 | |
返回结果:
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| 返回状态码 | code | Int | 1 | 1为成功,其它值为失败 |
| 返回信息 | msg | String | 查询订单号成功! | |
| 易支付订单号 | trade\_no | String | 2016080622555342651 | 彩虹易支付订单号 |
| 商户订单号 | out\_trade\_no | String | 20160806151343349 | 商户系统内部的订单号 |
| 支付方式 | type | String | alipay | alipay:支付宝,tenpay:财付通, |
| qqpay:QQ钱包,wxpay:微信支付 | | | | |
| 商户ID | pid | Int | 1001 | 发起支付的商户ID |
| 创建订单时间 | addtime | String | 2016-08-06 22:55:52 | |
| 完成交易时间 | endtime | String | 2016-08-06 22:55:52 | |
| 商品名称 | name | String | VIP会员 | |
| 商品金额 | money | String | 1.00 | |
| 支付状态 | status | Int | 0 | 1为支付成功,0为未支付 |
## \[API\]批量查询订单
URL地址:[http://77jl.cn/api.php?act=orders&pid={商户ID}&key={商户密钥}](http://77jl.cn/api.php?act=orders&pid=%7B%E5%95%86%E6%88%B7ID%7D&key=%7B%E5%95%86%E6%88%B7%E5%AF%86%E9%92%A5%7D)
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 操作类型 | act | 是 | String | orders | 此API固定值 |
| 商户ID | pid | 是 | Int | 1001 | |
| 商户密钥 | key | 是 | String | 89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i | |
| 查询订单数量 | limit | 否 | Int | 20 | 返回的订单数量,最大50 |
| 页码 | page | 否 | Int | 1 | 当前查询的页码 |
返回结果:
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| 返回状态码 | code | Int | 1 | 1为成功,其它值为失败 |
| 返回信息 | msg | String | 查询结算记录成功! | |
| 订单列表 | data | Array | | 订单列表 |
## \[API\]二维码下单接口
此接口可用于服务器后端发起支付请求,会返回支付二维码链接
URL地址:[http://77jl.cn/qrcode.php?pid={商户ID}&type={支付方式}&out\_trade\_no={商户订单号}¬ify\_url={服务器异步通知地址}&name={商品名称}&money={金额}&sign={签名字符串}&sign\_type=MD5](http://77jl.cn/qrcode.php?pid=%7B%E5%95%86%E6%88%B7ID%7D&type=%7B%E6%94%AF%E4%BB%98%E6%96%B9%E5%BC%8F%7D&out_trade_no=%7B%E5%95%86%E6%88%B7%E8%AE%A2%E5%8D%95%E5%8F%B7%7D¬ify_url=%7B%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%BC%82%E6%AD%A5%E9%80%9A%E7%9F%A5%E5%9C%B0%E5%9D%80%7D&name=%7B%E5%95%86%E5%93%81%E5%90%8D%E7%A7%B0%7D&money=%7B%E9%87%91%E9%A2%9D%7D&sign=%7B%E7%AD%BE%E5%90%8D%E5%AD%97%E7%AC%A6%E4%B8%B2%7D&sign_type=MD5)
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 商户ID | pid | 是 | Int | 1001 | |
| 支付方式 | type | 是 | String | alipay | qqpay:QQ钱包,wxpay:微信支付 |
| 商户订单号 | out\_trade\_no | 是 | String | 20160806151343349 | |
| 异步通知地址 | notify\_url | 是 | String | [http://77jl.cn/user/notify\_url.php](http://77jl.cn/user/notify_url.php) | 服务器异步通知地址 |
| 商品名称 | name | 是 | String | VIP会员 | |
| 商品金额 | money | 是 | String | 1.00 | |
| 签名字符串 | sign | 是 | String | 202cb962ac59075b964b07152d234b70 | 签名算法与[支付宝签名算法](https://doc.open.alipay.com/docs/doc.htm?treeId=62&articleId=104741&docType=1)相同 |
| 签名类型 | sign\_type | 是 | String | MD5 | 默认为MD5 |
返回结果:
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| 返回状态码 | code | Int | 1 | 1为成功,其它值为失败 |
| 返回信息 | msg | String | 下单成功! | |
| 订单号 | trade\_no | String | 20160806151343349 | |
| 商户订单号 | out\_trade\_no | String | 20160806151343349 | |
| 二维码链接 | code\_url | String | weixin://wxpay/bizpayurl?pr=04IPMKM | |
* * *
## 发起支付请求
URL地址:[http://77jl.cn/submit.php?](http://77jl.cn/submit.php?)
POST数据:pid={商户ID}&type={支付方式}&out\_trade\_no={商户订单号}¬ify\_url={服务器异步通知地址}&return\_url={页面跳转通知地址}&name={商品名称}&money={金额}&sitename={网站名称}&sign={签名字符串}&sign\_type=MD5
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 商户ID | pid | 是 | Int | 1001 | |
| 支付方式 | type | 是 | String | alipay | alipay:支付宝,tenpay:财付通, |
| qqpay:QQ钱包,wxpay:微信支付 | | | | | |
| 商户订单号 | out\_trade\_no | 是 | String | 20160806151343349 | |
| 异步通知地址 | notify\_url | 是 | String | [http://77jl.cn/user/notify\_url.php](http://77jl.cn/user/notify_url.php) | 服务器异步通知地址 |
| 跳转通知地址 | return\_url | 是 | String | [http://77jl.cn/user/return\_url.php](http://77jl.cn/user/return_url.php) | 页面跳转通知地址 |
| 商品名称 | name | 是 | String | VIP会员 | |
| 商品金额 | money | 是 | String | 1.00 | |
| 网站名称 | sitename | 否 | String | KP云任务 | |
| 签名字符串 | sign | 是 | String | 202cb962ac59075b964b07152d234b70 | 签名算法与[支付宝签名算法](https://doc.open.alipay.com/docs/doc.htm?treeId=62&articleId=104741&docType=1)相同 |
| 签名类型 | sign\_type | 是 | String | MD5 | 默认为MD5 |
## 支付结果通知
通知类型:服务器异步通知(notify\_url)、页面跳转通知(return\_url)
请求方式:GET
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 商户ID | pid | 是 | Int | 1001 | |
| 易支付订单号 | trade\_no | 是 | String | 20160806151343349021 | KP码支付订单号 |
| 商户订单号 | out\_trade\_no | 是 | String | 20160806151343349 | 商户系统内部的订单号 |
| 支付方式 | type | 是 | String | alipay | alipay:支付宝,tenpay:财付通, |
qqpay:QQ钱包,wxpay:微信支付,
alipaycode:支付宝扫码,jdpay:京东支付 |
| 商品名称 | name | 是 | String | VIP会员 | |
| 商品金额 | money | 是 | String | 1.00 | |
| 支付状态 | trade\_status | 是 | String | TRADE\_SUCCESS | |
| 签名字符串 | sign | 是 | String | 202cb962ac59075b964b07152d234b70 | 签名算法与[支付宝签名算法](https://doc.open.alipay.com/docs/doc.htm?treeId=62&articleId=104741&docType=1)相同 |
| 签名类型 | sign\_type | 是 | String | MD5 | 默认为MD5 |
* * *
## SDK下载
> [Sdk.zip](http://77jl.cn/user/down/SDK.zip)
> SDK版本:V1.1