5.2 创建充值申请
简要描述:
- 企业在结算之前,可以进行预充值,往服务公司指定的账户进行汇款,获取服务商指定汇款账户信息,请访问查看5.5 预充值汇款账号查询接口。
- 企业可以先创建预充值再汇款,也可以汇款后再创建预充值,平台系统检测充值到账后,会进行结果回传通知(详情见5.3 预充值结果回调接口)。
- 请确保预充值里的企业付款账号信息与企业实际付款账号信息一致,否则充值将无法自动到账。
- 该接口会做IP白名单限制。
请求头参数:
Authorization: Bearer [accessToken]
请求URL:
- /account/prestore/add
请求方式:
- POST
参数:
请求参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
参数 | 类型 | 是否必须 | 说明 |
projectId | string | 否 | 关联的项目,基于哪个项目进行的汇款充值,请确保在SAAS系统里有可用的项目 |
providerId | string | 是 | 服务商公司Id |
payTime | string | 是 | 汇款日期2021-08-10,请确保实际汇款日期一致,否则将无法自动充值到账 |
bankNo | string | 是 | 企业付款方的银行卡号,例如77777888888 |
bankName | string | 是 | 企业付款方的银行户名,例如xxxx公司 |
bank | string | 是 | 企业付款方的银行,例如 工商银行 |
amount | BigDecimal | 是 | 汇款金额,例如20202.12,单位元,请确保实际汇款金额跟提交回单单金额一致,否则无法自动到账。 |
payType | int | 是 | 充值类型:0银行转账,1支付宝 |
payImg | string | 否 | 可选项,企业线下汇款回单图片文件的base64字符串,请base64字符串前面增加data描述信息,例如data:image/jpeg;base64,/9j/4... |
serialNumber | string | 否 | 流水号,企业可以使用该编号作为企业平台的充值唯一单号,预充值结果回调时,我方也会将该参数传回。 |
nonce | string | 是 | 随机字符串,长度要求在32位以内。推荐随机数生成算法 |
sign | string | 是 | 过签名算法计算得出的签名值,详见签名生成算法 |
返回结果示例
成功示例
{
"id": "12345678"
}
失败示例
{
"error": "BadRequest",
"message": "项目不能为空"
}
响应参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
参数 | 类型 | 是否必须 | 说明 |
id | string | 是 | 我方平台,预充值单的唯一编号 |
projectId | string | 否 | 关联的项目,基于哪个项目进行的汇款充值,请确保在SAAS系统里有可用的项目 |
providerId | string | 是 | 服务商公司Id |
payTime | string | 是 | 汇款日期2021-08-10,请确保实际汇款日期一致,否则将无法自动充值到账 |
bankNo | string | 是 | 企业付款方的银行卡号,例如77777888888 |
bankName | string | 是 | 企业付款方的银行户名,例如xxxx公司 |
bank | string | 是 | 企业付款方的银行,例如 工商银行 |
amount | BigDecimal | 是 | 汇款金额,例如20202.12,单位元,请确保实际汇款金额跟提交回单单金额一致,否则无法自动到账。 |
status | int | 是 | 充值单状态:0到账检查中,1余额审查中,2充值成功,3审核不通过,9充值失败,99充值作废 |
serialNumber | string | 否 | 流水号,企业可以使用该编号作为企业平台的充值唯一单号,预充值结果回调时,我方也会将该参数传回。 |