2.实时发放数据上报（单笔）

接口描述：

实时提现数据上报

概述：

接口适用场景：小额服务费发放、无需审核、由用户主动发起。
月累计上限统计以结算公司（税源地）为单位
理账狮SaaS系统接口收到上报请求，执行发放时使用【姓名+结算账号】，张冠李戴的形式银行或支付宝等渠道将发放失败，请传递真实有效信息。
请根据自身业务场景选用接口。生产环境平均到账时间在1-3分钟左右，测试环境不能真实到账。
当接口连接超时或者反馈ERROR时，请不要更换业务流水号，一定要使用原业务流水号重试，否则可能造成重复支付等资金风险。同一个流水号只能上报一次，重复上报接口将提示订单号重复错误。
请您在自身系统中合理设置付款频次并做好并发控制，防范错付风险，因您自身系统设置存在问题导致的资金损失，由您自行承担。
企业余额扣减计算公式：接口上报金额（用户实际到账金额）+ （接口上报金额服务费比例）；例，打包价6%，张三提现1000 ，则余额扣减 = 1000+(10000.06)=1060

Tips:
单笔付款区间：0.3-50000
微信收款单日笔数最大次数为10次
微信用户单日收款最大金额为：50000元

请求URL：

{{host}}/api/pay/singleSubmit

请求方式：POST

公共请求参数

参数名	必选	类型	说明
plat	是	string	来源，本接口固定值：api
version	是	string	接口版本，本接口固定值：100000
access_key	是	string	平台分配给商户唯一ID
timestamp	是	string	请求时的时间戳，示例：1625590924
signature	是	string	签名字符串见签名说明
content	string	不可空	业务参数需要通过AES加密

content 业务参数说明，子项不需要参与签名计算，AES加密完成后整体参与计算

(示例值在表格行尾，表格比较宽，往后拉一下)

参数	类型（长度）	是否必填	描述
notifyUrl	string(100)	不可空	回调地址，不能携带参数
taxFundId	string(32)	不可空	税源地id([见税源地信息查询接口])
month	string(32)	不可空	提现月份
outerTradeNo	string(32)	不可空	商户业务流水号（商户自行生成，全局唯一）
empNum	string(32)	可空	自定义员工编号（商户系统中用户唯一编号）
empName	string(32)	不可空	收款人户名
empPhone	string(11)	不可空	收款人手机号（税务局报税要求必填）
licenseType	string(10)	不可空	收款人证件类型[见附录【证件类型】]
licenseId	string(32)	不可空	收款人证件号码
settleType	string(10)	不可空	交易类型（bankcard：银行卡，alipay：支付宝，wechatpay：微信）目前仅支持alipay
payAccount	string(32)	不可空	收款账号，交易类型为支付宝时，为支付宝账号；交易类型为银行卡时，为银行卡号
bankName	string(32)	可空	收款人银行名称（无需细到支行名称）
positionName	string(32)	不可空	服务类型 (您实际的业务场景说明)
payAmount	Number(12)	不可空	交易金额（实际到账金额，单位元，精确两位小数）
remarks	string(10)	可空	业务备注说明：若需要对每笔提现区分业务来源，可自行定义，后续可在SaaS后台查看，与用户到账说明无关（不能超过10个字）
bankRemo	string(10)	可空	银行摘要备注（可在收款行交易明细中查看到，默认："服务费收入"）
wechatAppId	string(32)	可空	商户自己的微信APPID，交易类型为微信时，必填

业务响应参数

参数	类型（长度）	是否必填	描述
outerTradeNo	string(32)	不可空	商户业务流水号

content 参与加密的数据集示例：

MWZQ0QY3P6N26q9dlmyhmWKLI7VSf4z1bplyrz9gjilMofo02I3W2X%2FLnGYk%2F9mYmPySdHvJbzwT7kOiAUOKMsYByhJltg4XbOAaEezufja99sIMWxmiK1K6oL8RNmYs1txGaoO5VOfXd%2BR6PnPf6Bn5QtNnMHvfF%2B7qbKYCke%2BZrhAELKN03cFntjk5ozZmCwKWrJ9uReYwknRVYlkMg16%2Bu%2BVMKyQTb8SLFcJd7cDwm31sawm5SnjU18DJkJwbDIIzx7zDYcDJW9sRh5BbBca7u%2BOJ%2BB03tFphfzdp6VnMrx%2BrsYkdWUKPg27yknZdFjldoRQaREbpwEY2i5Zlcd0l1wg%2FnCIkg%2BKg4LQjtPJiVOXcSibAL%2FKuwSMKho7bK1QbbpaazRTV9C69N9HrkldXRF7Nsa9osB6yYe44BkjNLPzBvIgQjM4PltCfYVJbzmaHpKu1dvZYwS3RX9V%2BIj8U5tjYPM1ioVndCYs3S9g%3D

{
    "notifyUrl":"https://dev.workersaas.com/api/pay/notifyTest",
    "taxFundId":"0",
    "month":"2020-07",
    "outerTradeNo":"f2cb9c91f3c3637fb41ea5b647836dfe",
    "empName":"aloqog7355",
    "empPhone":"18801270000",
    "licenseType":"ID_CARD",
    "licenseId":"990809198508017900",
    "settleType":"alipay",
    "payAccount":"aloqog7355@sandbox.com",
    "positionName":"音视频服务费",
    "payAmount":10.01
}

响应示例

正常：

{
    "code":200,
    "msg":"success",
    "data":{
        "outerTradeNo":"f2cb9c91f3c3637fb41ea5b647836dfe"
    }
}

异常：

{
    "code":500,
    "msg":"重复的业务订单号",
    "errcode":"DUPLICATE_REQUEST_NO"
}

一、文档说明

二、安全认证与签名

三、结算公司和资金余额

四、实时发放

五、业务级错误代码

六、枚举类型

接口描述：

概述：

公共请求参数

content 业务参数说明，子项不需要参与签名计算，AES加密完成后整体参与计算

业务响应参数

响应示例