收款助手个人免签支付使用文档

一、简介

收款助手是一款辅助开发者完成支付功能的工具，使用免签支付技术，实现在网站或者App接入支付功能。具有以下优点：

• 简单方便：无需注册公司，无需营业执照，无需缴纳微信认证年费，只要有收款二维码即可接入。

• 安全可靠：使用自己的收款码，买家直接点对点转账给卖家，不经过任何第三方清算机构。

• 没有成本：没有提现、认证等手续费，接入完全免费。

二、环境和参数配置

收款助手需要配合安卓App来使用，接下来的操作需要有一定的网络知识和动手能力。

1.安装App

请访问 收款助手 下载并安装App。

2.开启通知使用权的权限

下载打开后，请根据提示开启通知使用权的权限。

3.注册并登录

在软件弹框中输入要使用的用户名和密码，点击登录，一键完成注册和登录。

4.设置收款参数

登录成功后，点击收款参数后边的设置按钮，在新打开的页面中，填写商户名称、支付通知地址、支付回退地址以及上传微信和支付宝的个人收款二维码。各个参数说明如下：

• 商户账号：注册时候填写的用户名，用户的唯一ID

• 商户名称：在支付页面，显示给买家的中文名称

• 支付通知地址：买家支付后，会把支付信息发送到这个地址（用于在服务器端写入买家的支付信息）

• 支付回退地址：买家支付成功或失败后，支付页面要跳转的地址（一般是商品页面或者订单页面的地址）

• 支付码：上传微信、支付宝等个人收款码后，在支付页面显示给买家进行付款

• 授权码：用于调用支付相关接口，复制下来备用

5.测试收款

至此，已完成所有配置，可以访问 测试地址  测试收款功能。

三、开发集成

如果要集成支付到自己的业务系统中，请参考以下接口Api。

1.预支付接口

在打开支付页面前，需要调用预支付接口，生成支付信息。

请求URL

• https://easypay.wisg.cn/service/prepare-pay

请求Header

• auth-key （在收款参数中复制的授权码）

请求方式

• post

body参数

参数名	必选	类型	说明
account	是	string	商户账号，在平台注册的商户ID
orderId	是	string	自定义订单编号
productName	是	string	商品名称
total	是	string	商品金额
extra	是	string	附加信息，支付成功原样传回

返回示例

  {
    "status": true,
    "msg": "" ,
    "data": {
      "key": "U2FsdGVk2g",
      "total": "0.1",
      "discount": "0.01"
    }
  }

返回参数说明

参数名	类型	说明
status	bool	请求是否成功
msg	string	错误信息
key	string	稍后调用支付页面要传递的参数
total	string	商品金额
discount	string	支付系统给买家设定的折扣信息

2.调起支付页面

拿到上一步生成的key，就可以直接调起支付页面：

https://easypay.wisg.cn/service/pay/index.html?key=U2FsdGVk2g

考虑到用户的使用场景，提供以下两种使用方式：

直接打开支付页面（推荐）
使用 window.location.href 或者 window.open 方式打开支付页面。

iframe嵌套支付页面
使用iframe方式，支付成功或失败后，不会跳转支付回退地址，需要在父页面添加事件，监听支付结果，自己处理后续逻辑。

window.addEventListener("message", function (e) {
  const response = JSON.parse(e.data);
  switch (response.type) {
    case "pay-success":
      // 支付成功
      // 其它参数参考下方支付成功的回调
      break;
    case "pay-timeout":
      // 支付超时
      break;
    default:
      // 其它原因未支付
      break;
  }
});

指定支付类型
通过添加payType参数，可以指定支付类型：

https://easypay.wisg.cn/service/pay/index.html?key=U2FsdGVk2g&payType=alipay

3.支付成功的回调

支付成功后，会通知收款参数中配置的【支付通知地址】。

请求URL

• 收款参数中配置的【支付通知地址】

请求方式

• post

body参数

参数名	必选	类型	说明
type	是	string	消息类型，pay-success/pay-fail
account	是	string	商户账号，在平台注册的商户ID
orderId	是	string	自定义订单编号
productName	是	string	商品名称
total	是	string	商品金额
payType	是	string	支付方式 wxpay / alipay
discount	是	string	支付系统给买家设定的折扣信息
extra	是	string	附加信息，支付成功原样传回