5.2 创建充值申请

简要描述:

  • 企业在结算之前,可以进行预充值,往服务公司指定的账户进行汇款,获取服务商指定汇款账户信息,请访问查看5.5 预充值汇款账号查询接口。
  • 企业可以先创建预充值再汇款,也可以汇款后再创建预充值,平台系统检测充值到账后,会进行结果回传通知(详情见5.3 预充值结果回调接口)。
  • 请确保预充值里的企业付款账号信息与企业实际付款账号信息一致,否则充值将无法自动到账。
  • 该接口会做IP白名单限制。

请求头参数:

Authorization: Bearer [accessToken]

请求URL:

  • /account/prestore/add

请求方式:

  • POST

参数:

请求参数说明

参数类型是否必须说明
参数类型是否必须说明
projectIdstring关联的项目,基于哪个项目进行的汇款充值,请确保在SAAS系统里有可用的项目
providerIdstring服务商公司Id
payTimestring汇款日期2021-08-10,请确保实际汇款日期一致,否则将无法自动充值到账
bankNostring企业付款方的银行卡号,例如77777888888
bankNamestring企业付款方的银行户名,例如xxxx公司
bankstring企业付款方的银行,例如 工商银行
amountBigDecimal汇款金额,例如20202.12,单位元,请确保实际汇款金额跟提交回单单金额一致,否则无法自动到账。
payTypeint充值类型:0银行转账,1支付宝
payImgstring可选项,企业线下汇款回单图片文件的base64字符串,请base64字符串前面增加data描述信息,例如data:image/jpeg;base64,/9j/4...
serialNumberstring流水号,企业可以使用该编号作为企业平台的充值唯一单号,预充值结果回调时,我方也会将该参数传回。
noncestring随机字符串,长度要求在32位以内。推荐随机数生成算法
signstring过签名算法计算得出的签名值,详见签名生成算法

返回结果示例

成功示例
{
    "id": "12345678"
}

失败示例
{
    "error": "BadRequest",
    "message": "项目不能为空"
}

响应参数说明

参数类型是否必须说明
参数类型是否必须说明
idstring我方平台,预充值单的唯一编号
projectIdstring关联的项目,基于哪个项目进行的汇款充值,请确保在SAAS系统里有可用的项目
providerIdstring服务商公司Id
payTimestring汇款日期2021-08-10,请确保实际汇款日期一致,否则将无法自动充值到账
bankNostring企业付款方的银行卡号,例如77777888888
bankNamestring企业付款方的银行户名,例如xxxx公司
bankstring企业付款方的银行,例如 工商银行
amountBigDecimal汇款金额,例如20202.12,单位元,请确保实际汇款金额跟提交回单单金额一致,否则无法自动到账。
statusint充值单状态:0到账检查中,1余额审查中,2充值成功,3审核不通过,9充值失败,99充值作废
serialNumberstring流水号,企业可以使用该编号作为企业平台的充值唯一单号,预充值结果回调时,我方也会将该参数传回。

results matching ""

    No results matching ""