主题
商户结算信息修改
接口描述
- 接入方通过该接口进行商户结算信息变更。
请求URL
/merchant/settleModify
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS241113000204 |
| requestNo | 是 | string | 32 | 请求流水号 | 123456789 |
| bankAccountNo | 是 | string | 64 | 结算账户(需要AES加密)，对私结算为结算卡卡号，对公结算为对公账号 | |
| bankPhoneNo | 否 | string | 64 | 银行预留手机号(需要AES加密)，对私结算必填 | |
| bankAccountType | 是 | string | 2 | 银行账户类型，小微商户仅支持对私，企业商户仅支持对公： BC-对公,BU-对私 | BU |
| bankAccountName | 是 | string | 32 | 银行账户名称(需要AES加密) | xxx公司 |
| bankNo | 是 | string | 32 | 总行联行号 | 102100099996 |
| bankName | 是 | string | 32 | 总行名称 | 中国工商银行 |
| bankBranchNo | 是 | string | 32 | 支行联行号 | 102290017292 |
| bankBranchName | 是 | string | 32 | 支行名称 | 中国工商银行上海市徐家汇支行 |
| bankAccountImageUrl | 是 | string | 64 | 结算账户图片，对私为银行卡照片，对公为开户许可证照片 | |
| bankProvinceCode | 是 | string | 6 | 银行所在省份 | 310000 |
| bankCityCode | 是 | string | 6 | 银行所在市 | 310100 |
| bankDistrictCode | 否 | string | 6 | 银行所在区 | 310101 |
| settleMode | 否 | string | 2 | 商户结算模式： D0-当日结算，D1-下一自然日结算，T1-下一工作日结算 | D0 |
请求报文示例
json
{
"appId": "202408554212370909",
"merchantNo": "XS241113000204",
"requestNo": "123456789",
"bankAccountImageUrl": "PRIf7784ece29b7497aac3bb21df63829a6.png",
"bankAccountName": "JRK97dTOVaSwU3smFZ2uUQ==",
"bankAccountNo": "c9pR1sdwHDXoY9XW8T/V3D6OvGyx1STeM8qir+6Xeak=",
"bankAccountType": "BU",
"bankBranchName": "招商银行股份有限公司武汉东西湖支行",
"bankBranchNo": "308521015284",
"bankName": "招商银行",
"bankNo": "308584000013",
"bankPhoneNo": "h6f9rFZAgtWiNqWzBIAZKw==",
"bankProvinceCode": "310000",
"bankCityCode": "310100",
"signature": "exCsFUiaSptDPtolFklsDx0yHrDGi5u1E9ujvoT/4mMPFW3Vq2criGow0fCh7ZyLRFe4CtYPrE/QH8RypiZtroofmlPytqbZKUX3cBCgOPkac/2Fhx1ffJdYrAhUeBSxtTNVC16kUSLjBn0wlcQr2AvFIj72nAj92MHUHeiQO3INuCYaA3cj8tWw5W5WoCBUWjYpdaxcIbOrJrHGu4yo+JcHoe/u/rxUN8crWXQvnSKdiMIPjigJeZ6S648Heui58ffhLrK7zuUOKwu4JdVBLOq+ta9Q1MUp3KkK6iR1ovqUuK0/lTk/F3QMZiBNdFq4yqMy8GRNSWAA7P99nC85qg==",
"transDate": "1731486017900",
"transNonce": "879df171f3de481d825e1e185638ee22"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| corpoAccountName | 否 | string | 公司账户名称，对公账户修改返回 | ||
| corpoAccountNo | 否 | string | 公司账户号，对公账户修改返回 | ||
| collectAccountName | 否 | string | 收款账户名称，对公账户修改返回 | ||
| collectAccountNo | 否 | string | 收款账户号 | ||
| collectCompanyName | 否 | string | 收款公司名称 | ||
| amount | 否 | string | 金额，单位：分 | ||
| payAuthEndTime | 否 | string | 认证截止时间，格式：yyyy-MM-dd HH:mm:ss | ||
| remark | 否 | string | 备注 |
响应示例
json
{
"corpoAccountName": "公司账户名称",
"corpoAccountNo": "公司账户号",
"collectAccountName": "收款账户名称",
"collectAccountNo": "收款账户号",
"collectCompanyName": "收款公司名称",
"amount": "18",
"payAuthEndTime":"2024-01-01 20:20:00",
"remark": "企业认证",
"signature": "XHCCWBbsF6w3ufItynP5cKsOPj8kn3hKdmu/y1JWB1oiulxME1XTr8MFZugkL7vIk6KZUbO3Qhc15Er4YXr4nwRNoRisHvn4BUe4K/i3JStCIkbst+x+3TVK0/t7OpNKIWtZqcd1XDfY35URJjgLPUlWWbXc4gcTWBjHhqa59pAgbwsg2d+URrr3Qd7UGHYNIsCbQ3jbZeL2AJqQS6KpPDc++pjwpLzjmtEqBp9k4gFX5p6gfR5XaeLm3PuKeAhiZyopAVTZxWpPooU5RDNIZkBsp4IJaVF1kassSDOoEGwG3ozmP85YcJ7TtiTew+WQAwZxG24Xppj433SBFP0BhQ==",
"transDate": "1731469987240",
"transNonce": "a33562a6-246b-4532-9bd7-74bb3e43b1c0"
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述