二级商户进件场景

更新时间:2025.03.21

1. 接口规则

为了在保证支付安全的前提下,带给商户简单、一致且易用的开发体验,我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考APIv3接口规则

2. 开发准备

2.1. 搭建和配置开发环境

开发者应当依据自身的编程语言来构建并配置相应的开发环境。

2.2. 业务开发配置-二级商户进件

  1. 平台需确认是否已开通平台工具箱,详细可前往平台收付通介绍查看。

  2. 待进件的二级商户是否符合进件要求,相关要求可以前往二级商户入驻介绍查看。

3. 快速接入

3.1. 业务流程图-二级商户进件

重要步骤说明:

步骤1 平台通过请求二级商户进件接口帮助二级商户提交商户进件资料。进件参数中包含了敏感信息参数,此类参数要求进行加密,详见 接口规则

步骤2 提交进件资料后,平台需通过微信支付返回的微信支付申请单号和业务申请编号来请求查询申请状态API接口查询二级商户进件状态。

步骤3 进件成功后,若二级商户需修改结算账号时,平台可通过请求修改商户结算账号API接口来帮助二级商户修改账号信息。

步骤4 平台通过请求查询商户结算账号API接口来查询修改情况。

3.2. API接入-二级商户进件

本文档展示了如何使用微信支付服务端 SDK 快速接入平台收付通产品,完成与微信支付对接的部分。

注意

  • 文档中的代码示例是用来阐述 API 基本使用方法,代码中的示例参数需替换成商户自己账号及请求参数才能跑通。

  • 以下接入步骤仅提供参考,请商户结合自身业务需求进行评估、修改。

3.2.1.【服务端】二级商户进件申请

步骤说明: 平台,可使用该接口,帮助其二级商户进件成为微信支付商户。

示例代码

JAVA

1public void Applyments() throws Exception{
2  //请求URL
3  HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/ecommerce/applyments/");
4  // 请求body参数
5  String reqdata = "{"
6          + "\"organization_type\":\"2\","
7          + "\"business_license_info\": {"
8          + "\"business_license_copy\":\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4\","
9          + "\"business_license_number\":\"123456789012345678\","
10          + "\"merchant_name\":\"腾讯科技有限公司\","
11          + "\"legal_person\":\"张三\""
12          + "},"
13          + "\"organization_cert_info\": {"
14          + "\"organization_copy\":\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4\","
15          + "\"organization_time\":\"[\"2014-01-01\","\"长期\"]\","
16          + "\"organization_number\":\"12345679-A\""
17          + "},"
18          + "\"id_card_info\": {"
19          + "\"id_card_copy\":\"jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\","
20          + "\"id_card_national\":\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4\","
21          + "\"id_card_name\":\"pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+C1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==\","
22          + "\"id_card_number\":\"UZFETyabYFFlgvGh6R4vTzDELiPas3jC94/srAbSaPaWSM+1rhGLcsybPLeJdVOpCeDxNBMDK+/N0nOiZZ4ka9+5RgzvA2rJx+NztYUbN209rq0Y/NP50T9yk0m6A4xUoFWgk/8qteRHtP5VHahNhSh8nHo31V33t8edSlN9HJG6diRj7p5JPImDyM1q56+p25edl3+cOtuZtj8TJDl/hB+GaWve9X1WUpkZbKlJgBxp+XhaW707k9XrILvfD+rSGTOeU/ev4/OiEb5W4WPGJ+3iLoQvhnz3+aQZX9+gn9uRzWcHu2Kr17fhsM+MRkgVcwzI2UqhR9iuGTunRPRVFg==\","
23          + "\"id_card_valid_time\":\"2026-06-06\""
24          + "},"
25          + "\"need_account_info\":true,"
26          + "\"account_info\": {"
27          + "\"bank_account_type\":\"74\","
28          + "\"account_name\":\"fTA4TXc8yMOwFCYeGPktOOSbOBei3KA8RAMO9h/5Y0ZMR46viedrDurCbQTC/sCC9BWuG5oeR8flymK/Z4dN0/7XDSDfqT5Nggq9WwTL+OZdMorqTE6Z0G3f3Bi3c+GVvYOCZyVdoinksPEUwyosEtwupM3ufXSZT36DvsS8K9jOBnIXjGaQtP94FFlh58WR0GuEkMt9KT2NuA+fE4KDScRzSZn3TL5Izdt+7anPS6Uh4K7wPnUWHGxCQdZu0G4B4YjP7ync8UeLu4jAkCziq4lngnU3rKfFiqwMtyOA179x15za7+kWmo2hfaC7xumTqXR7/NyRHpFKXURQFcmmw==\","
29          + "\"account_bank\":\"工商银行\","
30          + "\"bank_address_code\":\"110000\","
31          + "\"bank_branch_id\":\"402713354941\","
32          + "\"bank_name\":\"施秉县农村信用合作联社城关信用社\","
33          + "\"account_number\":\"d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==\""
34          + "},"
35          + "\"contact_info\": {"
36          + "\"contact_type\":\"65\","
37          + "\"contact_name\":\"pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==\","
38          + "\"contact_id_card_number\":\"UZFETyabYFFlgvGh6R4vTzDELiPas3jC94/srAbSaPaWSM+1rhGLcsybPLeJdVOpCeDxNBMDK+/N0nOiZZ4ka9+5RgzvA2rJx+NztYUbN209rq0Y/NP50T9yk0m6A4xUoFWgk/8qteRHtP5VHahNhSh8nHo31V33t8edSlN9HJG6diRj7p5JPImDyM1q56+p25edl3+cOtuZtj8TJDl/hB+GaWve9X1WUpkZbKlJgBxp+XhaW707k9XrILvfD+rSGTOeU/ev4/OiEb5W4WPGJ+3iLoQvhnz3+aQZX9+gn9uRzWcHu2Kr17fhsM+MRkgVcwzI2UqhR9iuGTunRPRVFg==\","
39          + "\"mobile_phone\":\"Uy5Hb0c5Se/orEbrWze/ROHu9EPAs/CigDlJ2fnyzC1ppJNBOYGyc89xUgZZoPIRnPWsvJ5oevXNdBK3IUz9WHs9iQKpeUksvoLQMsykc8LDu7MMpayKWNVozldcRugH++MltTBKWTkv/oOcwkZattMGgP4CtpbN6djDK1PcAmIDgdFD2ZvCIDCtJg1V/YafUBJdBTvNLXa/jNzjZaypsUn1BRO6fx8aaNn7XyTv7JrfQZE4UDH4gfMFOj8YDqQ+IvDbkuNhaLZExOEz/UcnxeN5mfGr2MdkPrOzF+xJmUZUn1nafZxENrqcBszhYQUlu5zn6o2uZpBhAsQwd3QAjw==\","
40          + "\"contact_email\":\"Uy5Hb0c5Se/orEbrWze/ROHu9EPAs/CigDlJ2fnyzC1ppJNBOYGyc89xUgZZoPIRnPWsvJ5oevXNdBK3IUz9WHs9iQKpeUksvoLQMsykc8LDu7MMpayKWNVozldcRugH++MltTBKWTkv/oOcwkZattMGgP4CtpbN6djDK1PcAmIDgdFD2ZvCIDCtJg1V/YafUBJdBTvNLXa/jNzjZaypsUn1BRO6fx8aaNn7XyTv7JrfQZE4UDH4gfMFOj8YDqQ+IvDbkuNhaLZExOEz/UcnxeN5mfGr2MdkPrOzF+xJmUZUn1nafZxENrqcBszhYQUlu5zn6o2uZpBhAsQwd3QAjw==\""
41          + "},"
42          + "\"sales_scene_info\": {"
43          + "\"store_name\":\"爱烧烤\","
44          + "\"store_url\":\"http://www.qq.com\","
45          + "\"store_qr_code\":\"jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\""
46          + "},"
47          + "\"merchant_shortname\":\"爱烧烤\","
48          + "\"out_request_no\":\"APPLYMENT_00000000001\","
49          + "\"qualifications\":\"[\"jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\","\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"]\","
50          + "\"business_addition_pics\":\"["jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ","47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"]\","
51          + "\"business_addition_desc\":\"特殊情况,说明原因\""
52          + "}";
53  StringEntity entity = new StringEntity(reqdata,"utf-8");
54  entity.setContentType("application/json");
55  httpPost.setEntity(entity);
56  httpPost.setHeader("Accept", "application/json");
57  //完成签名并执行请求
58  CloseableHttpResponse response = httpClient.execute(httpPost);
59  try {
60      int statusCode = response.getStatusLine().getStatusCode();
61      if (statusCode == 200) { //处理成功
62          System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
63      } else if (statusCode == 204) { //处理成功,无返回Body
64          System.out.println("success");
65      } else {
66          System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
67          throw new IOException("request failed");
68      }
69  } finally {
70      response.close();
71  }
72}

PHP

1try {
2    $resp = $client-request(
3        'POST',
4        'https://api.mch.weixin.qq.com/v3/ecommerce/applyments/', //请求URL
5        [
6            // JSON请求体
7            'json' = [
8                "organization_type" = "2",
9                "business_license_info" = [
10                    "business_license_copy" = "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZmAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
11                    "business_license_number" = "123456789012345678",
12                    "merchant_name" = "腾讯科技有限公司",
13                    "legal_person" = "张三",
14                ],
15                "organization_cert_info" = [
16                    "organization_copy" = "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
17                    "organization_time" = [
18                        "0" = "2014-01-01",
19                        "1" = "长期",
20                    ],
21                    "organization_number" = "12345679-A",
22                ],
23                "id_card_info" = [
24                    "id_card_copy" = "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
25                    "id_card_national" = "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
26                    "id_card_name" = "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0nOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+t0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
27                    "id_card_number" = "UZFETyabYFFlgvGh6R4vTzDELiPas3jC94/srAbSaPaWSM+1rhLcsybPLeJdVOpCeDxNBMDK+/N0nOiZZ4ka9+5RgzvA2rJx+NztYUbN09rq0Y/NP50T9yk0m6A4xUoFWgk/8qteRHtP5VHahNhSh8nHo31V33t8edSlN9HJG6diRj75JPImDyM1q56+p25edl3+cOtuZtj8TJDl/hB+GaWve9X1WUpkZbKlJgBp+XhaW707k9XrILvfD+rSGTOeU/ev4/OiEb5W4WPGJ+3iLoQvhnz3+aQZX9+gn9uRzcHu2Kr17fhsM+MRkgVcwzI2UqhR9iuGTunRPRVFg==",
28                    "id_card_valid_time" = "2026-06-06",
29                ],
30                "need_account_info" = true,
31                "account_info" = [
32                    "bank_account_type" = "74",
33                    "account_name" = "fTA4TXc8yMOwFCYeGPktOOSbOBei3KA8RAMO9h/5Y0ZM46viedrDurCbQTC/sCC9BWuG5oeR8flymK/Z4dN0/7XDSDfqT5Nggq9WwTL+OdMorqTE6Z0G3f3Bi3c+GVvYOCZyVdoinksPEUwyosEtwupM3ufXSZT36DvsS8K9jOBnIjGaQtP94FFlh58WR0GuEkMt9KT2NuA+fE4KDScRzSZn3TL5Izdt+7anPS6h4K7wPnUWHGxCQdZu0G4B4YjP7ync8UeLu4jAkCziq4lngnU3rKfFiqwMtyOA19x15za7+kWmo2hfaC7xumTqXR7/NyRHpFKXURQFcmmw==",
34                    "account_bank" = "工商银行",
35                    "bank_address_code" = "110000",
36                    "bank_branch_id" = "402713354941",
37                    "bank_name" = "施秉县农村信用合作联社城关信用社",
38                    "account_number" = "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRgli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0EB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli38ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==",
39                ],
40                "contact_info" = [
41                    "contact_type" = "65",
42                    "contact_name" = "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x87Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+C1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjO/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
43                    "contact_id_card_number" = "UZFETyabYFFlgvGh6R4vTzDELiPas3jC94/srAbSaPaSM+1rhGLcsybPLeJdVOpCeDxNBMDK+/N0nOiZZ4ka9+5RgzvA2rJx+NztYUb209rq0Y/NP50T9yk0m6A4xUoFWgk/8qteRHtP5VHahNhSh8nHo31V33t8edSlN9HJG6diRj7pJPImDyM1q56+p25edl3+cOtuZtj8TJDl/hB+GaWve9X1WUpkZbKlJgBxp+Xha707k9XrILvfD+rSGTOeU/ev4/OiEb5W4WPGJ+3iLoQvhnz3+aQZX9+gn9uRWcHu2Kr17fhsM+MRkgVcwzI2UqhR9iuGTunRPRVFg==",
44                    "mobile_phone" = "Uy5Hb0c5Se/orEbrWze/ROHu9EPAs/CigDlJ2fnyzC1ppJNBOYGy9xUgZZoPIRnPWsvJ5oevXNdBK3IUz9WHs9iQKpeUksvoLQMsykc8LDMMpayKWNVozldcRugH++MltTBKWTkv/oOcwkZattMGgP4CtpbN6djDK1PcAmIDgdFD2ZvCIDCt1V/YafUBJdBTvNLXa/jNzjZaypsUn1BRO6fx8aaNn7XyTv7JrfQZEDH4gfMFOj8YDqQ+IvDbkuNhaLZExOEz/UcnxeN5mfGr2MdkPzF+xJmUZUn1nafZxENrqcBszhYQUlu5zn6o2uZpBhAsQwd3QAjw==",
45                    "contact_email" = "Uy5Hb0c5Se/orEbrWze/ROHu9EPAs/CigDlJ2fnyzC1ppJNBOyc89xUgZZoPIRnPWsvJ5oevXNdBK3IUz9WHs9iQKpeUksvoLQMsykc8LDu7MMpaWNVozldcRugH++MltTBKWTkv/oOcwkZattMGgP4CtpbN6djDK1PcAmIDgdFD2ZvCIDCtJg1YafUBJdBTvNLXa/jNzjZaypsUn1BRO6fx8aaNn7XyTv7JrfQZE4UDH4gfMFOj8YQ+IvDbkuNhaLZExOEz/UcnxeN5mfGr2MdkPrOzF+xJmUZUn1nafZxENrqcBszhYQUlu5zn6o2uZpBhAsQwd3QAjw==",
46                ],
47                "sales_scene_info" = [
48                    "store_name" = "爱烧烤",
49                    "store_url" = "http://www.qq.com",
50                    "store_qr_code" = "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3In001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
51                ],
52                "merchant_shortname" = "爱烧烤",
53                "out_request_no" = "APPLYMENT_00000000001",
54                "qualifications" = [
55                    "0" = "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ","4C6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUfKGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
56                ],
57                "business_addition_pics" = [
58                    "0" = "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ","47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
59                ],
60                "business_addition_desc" = "特殊情况,说明原因",
61            ],
62            'headers' = [ 'Accept' = 'application/json' ]
63        ]
64    );
65    $statusCode = $resp-getStatusCode();
66    if ($statusCode == 200) { //处理成功
67        echo "success,return body = " . $resp-getBody()-getContents()."\n";
68    } else if ($statusCode == 204) { //处理成功,无返回Body
69        echo "success";
70    }
71} catch (RequestException $e) {
72    // 进行错误处理
73    echo $e-getMessage()."\n";
74    if ($e-hasResponse()) {
75        echo "failed,resp code = " . $e-getResponse()-getStatusCode() . " return body = " . $e-getResponse()-getBody() . "\n";
76    }
77    return;
78}

 

更多参数、响应详情及错误码请参见二级商户进件申请API接口文档。

3.2.2.【服务端】查询进件申请状态

步骤说明: 平台,可使用该接口,帮助其二级商户查询进件状态。

示例代码

JAVA

1public void QueryApplyments() throws Exception{
2  //请求URL
3  HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/ecommerce/applyments/out-request-no/APPLYMENT_00000000001");
4  httpGet.setHeader("Accept", "application/json");
5  //完成签名并执行请求
6  CloseableHttpResponse response = httpClient.execute(httpGet);
7  try {
8      int statusCode = response.getStatusLine().getStatusCode();
9      if (statusCode == 200) { //处理成功
10          System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
11      } else if (statusCode == 204) { //处理成功,无返回Body
12          System.out.println("success");
13      } else {
14          System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
15          throw new IOException("request failed");
16      }
17  } finally {
18      response.close();
19  }
20}

PHP

1try {
2    $resp = $client-request(
3        'GET',
4        'https://api.mch.weixin.qq.com/v3/ecommerce/applyments/out-request-no/APPLYMENT_00000000001', //请求URL
5        [
6            'headers' = [ 'Accept' = 'application/json']
7        ]
8    );
9    $statusCode = $resp-getStatusCode();
10    if ($statusCode == 200) { //处理成功
11        echo "success,return body = " . $resp-getBody()-getContents()."\n";
12    } else if ($statusCode == 204) { //处理成功,无返回Body
13        echo "success";
14    }
15} catch (RequestException $e) {
16    // 进行错误处理
17    echo $e-getMessage()."\n";
18    if ($e-hasResponse()) {
19        echo "failed,resp code = " . $e-getResponse()-getStatusCode() . " return body = " . $e-getResponse()-getBody() . "\n";
20    }
21    return;
22}

更多参数、响应详情及错误码请参见查询进件申请状态API接口文档。

3.2.3.【服务端】修改结算账号

步骤说明: 二级商户结算账号错误或者变更,平台可通过该接口进行修改。

示例代码

JAVA

1public void UpdataSettlement() throws Exception{
2  //请求URL
3  HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/modify-settlement");
4  // 请求body参数
5  String reqdata = "{"
6          + "\"account_type\":\"ACCOUNT_TYPE_BUSINESS\","
7          + "\"account_bank\":\"工商银行\","
8          + "\"bank_address_code\":\"110000\","
9          + "\"bank_name\":\"施秉县农村信用合作联社城关信用社\","
10          + "\"bank_branch_id\":\"402713354941\","
11          + "\"account_number\":\"d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmi385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaQE8ZRGYoeorwC+w==\""
12          + "}";
13  StringEntity entity = new StringEntity(reqdata,"utf-8");
14  entity.setContentType("application/json");
15  httpPost.setEntity(entity);
16  httpPost.setHeader("Accept", "application/json");
17  //完成签名并执行请求
18  CloseableHttpResponse response = httpClient.execute(httpPost);
19  try {
20      int statusCode = response.getStatusLine().getStatusCode();
21      if (statusCode == 200) { //处理成功
22          System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
23      } else if (statusCode == 204) { //处理成功,无返回Body
24          System.out.println("success");
25      } else {
26          System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
27          throw new IOException("request failed");
28      }
29  } finally {
30      response.close();
31  }
32}

PHP

1try {
2    $resp = $client-request(
3        'POST',
4        'https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/modify-settlement', //请求URL
5        [
6            // JSON请求体
7            'json' = [
8                "account_type" = "ACCOUNT_TYPE_BUSINESS",
9                "account_bank" = "工商银行",
10                "bank_address_code" = "110000",
11                "bank_name" = "施秉县农村信用合作联社城关信用社",
12                "bank_branch_id" = "402713354941",
13                "account_number" = "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNg
14Ktxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiO
15kJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYm
16li385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEa
17YQE8ZRGYoeorwC+w==",
18            ],
19            'headers' = [ 'Accept' = 'application/json' ]
20        ]
21    );
22    $statusCode = $resp-getStatusCode();
23    if ($statusCode == 200) { //处理成功
24        echo "success,return body = " . $resp-getBody()-getContents()."\n";
25    } else if ($statusCode == 204) { //处理成功,无返回Body
26        echo "success";
27    }
28} catch (RequestException $e) {
29    // 进行错误处理
30    echo $e-getMessage()."\n";
31    if ($e-hasResponse()) {
32        echo "failed,resp code = " . $e-getResponse()-getStatusCode() . " return body = " . $e-getResponse()-getBody() . "\n";
33    }
34    return;
35}

更多参数、响应详情及错误码请参见修改结算账号API接口文档。

3.2.4.【服务端】查询结算账号

步骤说明: 平台可使用该接口,帮助其二级商户查询结算账号。

示例代码

JAVA

1public void GetSettlement() throws Exception{
2  //请求URL
3  HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/1900006491/settlement");
4  httpGet.setHeader("Accept", "application/json");
5  //完成签名并执行请求
6  CloseableHttpResponse response = httpClient.execute(httpGet);
7  try {
8      int statusCode = response.getStatusLine().getStatusCode();
9      if (statusCode == 200) { //处理成功
10          System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
11      } else if (statusCode == 204) { //处理成功,无返回Body
12          System.out.println("success");
13      } else {
14          System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
15          throw new IOException("request failed");
16      }
17  } finally {
18      response.close();
19  }
20}

PHP

1try {
2    $resp = $client-request(
3        'GET',
4        'https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/1900006491/settlement', //请求URL
5        [
6            'headers' = [ 'Accept' = 'application/json']
7        ]
8    );
9    $statusCode = $resp-getStatusCode();
10    if ($statusCode == 200) { //处理成功
11        echo "success,return body = " . $resp-getBody()-getContents()."\n";
12    } else if ($statusCode == 204) { //处理成功,无返回Body
13        echo "success";
14    }
15} catch (RequestException $e) {
16    // 进行错误处理
17    echo $e-getMessage()."\n";
18    if ($e-hasResponse()) {
19        echo "failed,resp code = " . $e-getResponse()-getStatusCode() . " return body = " . $e-getResponse()-getBody() . "\n";
20    }
21    return;
22}

更多参数、响应详情及错误码请参见查询结算账号API接口文档。