查询结算账户 API
普通服务商(支付机构、银行不可用）, 可使用本接口查询其进件、已签约的特约商户-结算账户信息(敏感信息掩码）。 该接口可用于核实是否成功修改结算账户信息、及查询系统汇款验证结果。
接口说明
适用对象: 普通服务商
请求 URL: https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/settlement
请求方式: GET
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3
path 指该参数需在请求 URL 传参query 指该参数需在请求 JSON 传参
请求参数
| 参数名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 特约商户号 | sub_mchid | string(10) | 是 | path 请输入本服务商进件、已签约的特约商户号。特殊规则: 长度最小 8 个字节 示例值: 1900006491 |
请求示例
URL https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/1900006491/settlement
返回参数
| 参数名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 账户类型 | account_type | enum | 是 | 返回特约商户的结算账户类型。 枚举值: ACCOUNT_TYPE_BUSINESS: 对公银行账户 ACCOUNT_TYPE_PRIVATE: 经营者个人银行卡 |
| 示例值: ACCOUNT_TYPE_BUSINESS | ||||
| 开户银行 | account_bank | string(128) | 是 | 返回特约商户的结算账户-开户银行全称。 |
| 示例值: 工商银行 | ||||
| 开户银行全称(含支行) | bank_name | string(128) | 是 | 返回特约商户的结算账户-开户银行全称(含支行）。 |
| 示例值: 施秉县农村信用合作联社城关信用社 | ||||
| 开户银行联行号 | bank_branch_id | string(128) | 是 | 返回特约商户的结算账户-联行号。 |
| 示例值: 402713354941 | ||||
| 银行账号 | account_number | string(128) | 是 | 返回特约商户的结算账户-银行账号, 掩码显示。 |
| 示例值: 62*************78 | ||||
| 汇款验证结果 | verify_result | enum | 是 | 返回特约商户的结算账户-汇款验证结果。 VERIFYING: 系统汇款验证中, 商户可发起提现尝试。 VERIFY_SUCCESS: 系统成功汇款, 该账户可正常发起提现。 VERIFY_FAIL: 系统汇款失败, 该账户无法发起提现, 请检查修改。 |
| 示例值: VERIFY_SUCCESS |
返回示例
正常示例
{
"account_type": "ACCOUNT_TYPE_BUSINESSACCOUNT_TYPE_PRIVATE",
"account_bank": "工商银行",
"bank_name": "施秉县农村信用合作联社城关信用社",
"bank_branch_id": "402713354941",
"account_number": "***************8678",
"verify_result": "VERIFY_SUCCESSVERIFY_FAILVERIFYING"
}
错误码公共错误码
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| SYSTEMERROR | 系统错误 | 系统异常, 请使用相同参数稍后重新调用 |
| PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
| INVALID_REQUEST | 无效请求 | 请查看返回的错误信息, 根据错误信息进行操作 |
| NOAUTH | 商户权限异常 | 请确认是否已经开通相关权限 |
Feedback
Was this page helpful?
很高兴听到！ 请告诉我们，我们如何才能改善.
很遗憾听到这个消息。 请告诉我们，我们如何才能改善.
最后修改 April 12, 2020: 整理文档 (f36b91e)