第一步: 注册KosPay

注册KosPay:

注册地址:

https://www.kos.org.cn/login.xhtml

注意:

注册时填写的姓名必须真实,且与手机号的姓名匹配

第二步: 个人支付开户

「KosPay 个人收款」 的原理是直接调用的企业支付接口 ,通过KOS支付平台转发接口参数,用户支付成功,金额直接到个人支付宝或者个人微信余额,无需结算,立即到账,实时通知(回调)。

  • 注册并且登陆 KosPay
  • 支付配置 页面,右上方点击开户按钮
  • 支付宝收款ID/微信收款ID获取:点击获取ID按钮 弹出二维码手机扫码自动获取收款ID。
  • 密钥获取方式,鼠标点击输入框,再点其他地方会自动获取32位十六进制数,请勿泄露。
  • 注意:收款姓名必须真实,与支付宝和微信的收款id对应的姓名必须一致。

第三步: API接入

发起付款接口

接口地址:https://wx.kos.org.cn:880
请求方法:POST
请求格式:00 8 1.00 a4f2053f9bf071a5a504bec05f537ebc 测试商品 透传参数 http://baidu.com https://www.baidu.com/
说明:post数据中没有参数名,参数值按照以上顺序以空格隔开。
请求参数:
第一个参数(支付方式):取值:00代表支付宝pc支付,01支付宝手机支付,10微信pc支付,11微信手机端支付,12微信浏览器内部支付
第二个参数(应用ID(appid)):在支付配置里面可以查看。
第三个参数(金额):支付金额,取值最多保留两位有效小数,每个订单最小金额1元。
第四个参数(订单号):商户订单号,32位十六进制,且订单号不可以重复,生成方式推荐用appid+时间戳进行MD5计算
第五个参数(产品名称):用户支付的时候显示的商品名称
第六个参数(自定义参数):回调通知的时候原样返回给回调通知地址
第七个参数(回调通知地址):这个地址必须外网能访问
第八个参数(同步通知地址):支付方式为01才有效,由于支付宝H5支付地址由阿里云提供,此地址是在手机H5支付成功前端跳转地址。

返回参数:
返回参数的位置有两个地方:
  • header里面获取“ztm”这个参数的值,表示返回数据的类型
  • ztm取值为‘data’时返回的文本需要通过js转为二维码
  • ztm取值为‘http’时返回的数据则直接用a标签或者location.href直接打开
  • ztm取值为‘jsapi’时location.href直接到开(仅限微信)
  • 参数示例可以参考:https://bbs.kos.org.cn/thread-77.htm

    成功支付后 KosPay 通知回调

    当订单支付成功后 KosPay 会立即向你的服务器发起回调通知
    接口地址:你传入的 回调通知地址 参数
    请求方法:GET
    请求参数:
    appid:商户应用ID
    cash_fee:实际到账金额
    extend:透传的自定义参数,发起支付时传递的值原样返回
    pay_type:用户采用的支付方式
    time_end:用户支付成功的时间
    total_fee:用户实际支付的金额
    trade_no:发起支付时的订单号
    trade_status:支付状态成功则返回'success'
    tz_time:通知时间
    sign:对参数的签名值
    
  • 通知参数示例:
  • appid=1&cash_fee=0.99&extend=123321&pay_type=01&time_end=2019-04-12 12:12:12&total_fee=1.00&trade_no=62e2db6b3b56af518ff78006a728256d&trade_status=success&tz_time=1555046436&sign=1fe5c9e5f2b1fce6ab09c892be5e3cba 当你收到 KosPay 的回调请求后,则返回“success”这七个小写字母,那么 KosPay 会认为通知成功, 否则会再次通知 15 次,间隔为 (5*次数) 分钟。

    验签方法

    通知参数验签(非常重要,防止他人模拟传入数据,导致损失)
    整个签名过程请勿在前端处理,商户密钥注重保密
    验签方式: MD5
    数据拼接方式:获取到的参数去掉sign按照字母顺序排列+商户密钥(KEY)
    示例
    md5('appid=1&cash_fee=0.99&extend=123321&pay_type=01&time_end=2019-04-12 12:12:12&total_fee=1.00&trade_no=62e2db6b3b56af518ff78006a728256d&trade_status=success&tz_time=1555046436'+'3b0c872b7f97a3182e42eb9159b719d2')
    经过MD5签名后的值与sign对比相同则签名正确 传入参数有效,反之传入参数无效.
                  

    Demo下载

    暂无

    FAQ

    • 「KosPay 个人收款」需要安装app吗?
    • KosPay使用的是企业支付接口,无需安装app。

    • 用「KosPay 个人收款」收款安全吗?
    • 肯定安全,KosPay是正规企业接口,每笔交易都是秒到支付宝或者微信余额,不存在T+1的说法,没有资金池,只做接口转发。

    • 「KosPay 个人收款」稳定吗?会不会掉单?
    • KosPay 用的是支付宝/微信的企业支付接口,只要支付宝/微信这两家公司没问题,无一漏单。

    • KosPay 目前支付哪几种支付方式?
    • 支持微信H5支付、微信扫码支付、微信JSAPI支付、支付宝H5支付、支付宝扫码支付。

    • KosPay 对接入平台的用户有限制吗?
    • 「KosPay 个人收款」是正规的企业接口。不允许支付宝和微信明令禁止的行业,如棋牌、博彩、色情等行业坚决禁止接入。

    • 我用于收款的微信或支付宝账号会不会有什么风险?
    • 没有风险,这个支付过程和平常支付一样,合理合规合法。

    • 你们平台如何扣费呢?
    • KosPay直接在每笔交易接口调用的时候就已经扣除了手续费,不需要向平台预充值费用,也不存在结算,每笔交易事实到账。

    • 订单未支付成功会扣除手续费吗?
    • 不会,KosPay 扣除手续费是在调用接口时用户支付成功后才会扣除。

    • 用户已经扫码付款,但是我没有收到回调是什么情况呢?
    • 只要支付成功100%的会有回调通知你的服务器,若是没收到请检查你的接收接口。如果 KosPay 调用你的服务器失败,KosPay 会每隔(5*第几次)分钟通知你的服务器,直到通知15次就会停止通知。所以接收异步通知得做到万无一失。

    • 为什么收取开户费100元?
    • KosPay采用的是无限制开户模式,即一个账号下面可以无限制开户,收取20为了防止恶意开户行为。同时也是为了筛选出真正需要个人收款业务的人。

    • 开户的费率可以调整吗?
    • 免费版无需开户费,费率8%,包含支付宝/微信收取的手续费0.6%-1%、增值税6%、平台服务费1%。

      标准版100元开户费,费率7%,包含支付宝/微信收取的手续费0.6%-1%、增值税6%。

    • KosPay 收款有限额吗?
    • 没有。

    • KosPay 个人收款账户有要求吗?
    • 1.必须是正常状态的支付宝或者微信。2必须是实名认证,用户信息合法并且绑定了银行卡。

    • 对接入的网站有要求吗?
    • 接入的网站必须经过备案、且备案信息与收款人的信息一致,即网站备案人与收款人为同一人。

    • KosPay以后会收取月费吗?
    • 不会。KosPay 开户后就会按照开户时的费率一直不变。