2.6 提现结果回调
简要描述:
- 我方平台在提现完成后,会将提现结果通知到企业指定的回调链接。
- 请在SAAS后台,开发者信息配置处,配置回调链接。如果未配置回调链接,系统将不会发起回调。
注意事项:
- 由于银行的原因,已经回调通知支付成功的订单,也可能会发生二次回调,二次回调时给的status状态值为99,此时意味着这笔订单最开始银行系统通知我方系统该笔支付成功了,但是随后(时间间隔可能是几秒、几分钟、几个小时甚至几天),银行又通知我方系统该笔订单实际支付失败了,这时该笔订单记录在我方系统状态值为作废状态,值为99,我方系统会发起二次回调。
请求URL:
- 开发者设置的全局回调地址,或者添加订单时指定的回调链接。
请求方式:
- POST
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
providerId | 是 | string | 服务商ID |
corpId | 是 | string | 企业id |
noticeType | 是 | int | 回调通知类型,1业务签约,2:提现订单状态 |
content | 否 | string | 回调说明 |
nonce | 是 | string | 校验用的随机校验码 |
sign | 是 | string | 校验用的签名值 |
id | 是 | string | 我方平台订单唯一id |
tradeNo | 是 | string | 企业订单号,订单唯一标示 |
rate | 否 | BigDecimal | 执行费率 |
totalAmount | 否 | BigDecimal | 总费用 |
baseFee | 否 | BigDecimal | 基础服务费 |
bizFee | 是 | BigDecimal | 业务经营费用(个人到手) |
bizBeforeFee | 否 | BigDecimal | 经营服务费税前,税前金额 |
tradeFee | 否 | BigDecimal | 交易手续费 |
status | 是 | Integer | 订单状态:0:支付中,1:支付成功,9:支付失败,99:作废(可能由支付成功到作废,所以可能会二次发起回调) |
created | 是 | Date | 创建时间 |
name | 否 | string | 自由职业者姓名 |
employeeNo | 是 | string | 自由职业者工号 |
employeeId | 是 | string | 自由职业者在我方平台唯一编号 |
bankPhone | 否 | string | 银行卡预留手机 |
bankCardNo | 否 | string | 银行卡号 |
remarks | 否 | string | 备注,交易失败时,会将失败原因体现在该字段 |
请求参数示例:
{
"noticeType": 1,
"corpId": "aaa",
"providerId": "aaa",
"employeeId": "xxxx",
"employeeNo": "自由职业者在企业编号",
"extra": "extra",
"contractStatus": 1,
"nonce": "5f0981ee-1d2f-438d-8c49-8c22c4fff507",
"sign": "D25E6874714F14DE680BC452BC6ADD20FB68E12FB86BC4DE5F1D979276DD415B",
"name":"姓名",
"bankPhone":"手机",
"rate": 10,
"totalAmount": 1.1,
"totalFee": 1.1,
"baseFee": 0.1,
"bizFee": 1,
"bizBeforeFee": 1.01,
"tradeFee": 0,
"status":1,
"created":"2019-04-18 12:00:00",
"bankCardPhone":"*********",
"bankCardNo":"**********"
}
返回参数说明
请返回json格式的任何结果,表明已成功接收
备注
- 如需要验签,请参照请求接口规范中的签名方式进行验证