> # **支付接口介绍** > 使用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={商户订单号}&notify\_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&notify_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={商户订单号}&notify\_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