5.3 预充值回调【待上线】
简要描述:
- 此处回调是指后端接口异步回调预充值单到账进展。请在SAAS后台,开发者信息配置处,配置回调链接。如果未配置回调链接,系统将不会发起回调。
- 开发者也可以在调用5.2 创建预充值接口时,通过传入notifyUrl来指定该笔预充值的回调链接
请求URL:
- 开发者设置的全局回调地址,或者5.2 创建预充值接口时,传入的notifyUrl
请求方式:
- POST
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
id | string | 是 | 预充值单唯一id |
projectId | string | 是 | 关联的项目,基于哪个项目进行的汇款充值 |
corpId | string | 是 | 企业id |
providerId | string | 是 | 服务商公司Id |
payTime | string | 是 | 汇款日期2021-08-10 |
bankNo | string | 是 | 企业付款方的银行卡号,例如77777888888 |
bankName | string | 是 | 企业付款方的银行户名,例如xxxx公司 |
bank | string | 是 | 企业付款方的银行,例如 工商银行 |
amount | BigDecimal | 是 | 汇款金额,例如20202.12 |
nonce | string | 是 | 校验用的随机校验码 |
sign | string | 是 | 校验用的签名值 |
serialNumber | string | 否 | 流水号 |
status | int | 是 | 预充值单状态:到账检查中;充值成功;审核未通过;充值失败;已中断;充值作废;其中审核未通过、充值失败、已中断、充值作废都可以认为是充值失败。 |
请求参数示例:
{
"id": "555555555555555",
"projectId": "666666666666666666666",
"providerId": "88888888888888888888",
"nonce": "5f0981ee-1d2f-438d-8c49-8c22c4fff507",
"sign": "D25E6874714F14DE680BC452BC6ADD20FB68E12FB86BC4DE5F1D979276DD415B",
"payTime": "2021-08-12",
"bankNo": "362280333166510000",
"bankName": "xxxx公司",
"bank": "工商银行",
"serialNumber": "xxxxxxxxxxxxxx",
"status": 1
}
返回参数说明
请确保回调响应的http状态码为200,并且按照下方指定的json格式进行响应。否则我方系统将认定为企业方未接收到回调结果,我方系统将自动进行二次回调(1、2、4、8、16、32、64、128分钟后分别再次回调,直到正确返回,最多再多回调8次)。
回调响应结果示例
成功示例
{
"code": "SUCCESS"
}
备注
- 如需要验签,请参照请求接口规范中的签名方式进行验证