主题
商业委托代扣签约申请
接口描述
- 商业委托代扣签约申请。
请求URL
/trustPay/signApply
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| bankAccountName | 是 | string | 32 | 银行账户名(密文) | |
| certType | 是 | string | 32 | 证件类型;ID_CARD:身份证；BUSI_LIC：营业执照 | |
| certNo | 是 | string | 32 | 证件号(密文) | |
| cardNo | 是 | string | 32 | 卡号(密文) | |
| phoneNo | 是 | string | 32 | 预留手机号(密文) | - |
| payerLegalName | 否 | string | 128 | 签约方法人姓名(密文),对公不能为空 | - |
| payerLegalCertType | 否 | string | 20 | 签约方法人证件类型;ID_CARD:身份证，对公不能为空 | - |
| payerLegalCertNo | 否 | string | 128 | 签约方法人证件号(密文)，对公不能为空 | - |
| merchantNo | 是 | string | 32 | 商户号不可为空 | - |
| bankAccountType | 是 | string | 2 | 银行账户类型;BC:对公,BU:对私 | - |
| entrustAuthNo | 是 | string | 32 | 授权号 | - |
| entrustAmtLimit | 是 | number | 单笔代收业务最高金额，单位：分 | - | |
| entrustStartTime | 是 | string | 生效时间，格式：yyyy-MM-dd'T'HH:mm:ss 例如：2025-10-25T12:50:00 | - | |
| entrustEndTime | 是 | string | 失效时间，格式：yyyy-MM-dd'T'HH:mm:ss | - | |
| entrustTimeUnit | 是 | string | 时间单位;07：日，04：月 | - | |
| entrustTimeStep | 是 | number | 时间步长,不小于1的整数 | - | |
| entrustFrqcy | 否 | number | 扣款频次,不小于1的整数 | - | |
| entrustBizType | 是 | number | 委托代扣业务类型，见附录 | - | |
| entrustTimeDesc | 是 | string | 时间描述 | - | |
| signNotifyUrl | 否 | string | 签约通知地址，不为空时会推送签约结果信息 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signNo | 是 | string | 签约协议号 | ||
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"signNo": "adadasdasdas",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}签约通知
- 请求方式：POST
通知参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
| signNo | 是 | string | 64 | 签约编号 | |
| merchantNo | 是 | string | 32 | 商户编号 | |
| signKind | 是 | string | 32 | 签约类型，TRUST-商业委托代扣 | |
| signStatus | 是 | string | 32 | 签约状态;SIGNED:已签约 |
注意事项
- 同样的通知可能会多次发送给接入方系统。接入方系统必须能够正确处理重复的通知。
- 接入方系统对于开启结果通知的内容一定要做签名验证，并校验通知的信息的正确性，防止数据泄露导致出现“假通知”，造成损失。
- 当接入方系统收到甬易的推送通知时，必须输出 SUCCESS ，甬易收到 SUCCESS ，便认为接入方已收到；否则将继续发送通知，以递增的时间间隔再次重发 5 次；时间间隔分别为 5/10/20/40/80秒，总时长 155 秒
__
备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述