Weixin Pay APIv3 Partner Documentation

https://pay.weixin.qq.com/wiki/doc/apiv3_partner/
Admin
This documentation provides guidance on the Weixin Pay APIv3 for partners, specifically detailing...
Tokens:96,225
Snippets:424
Trust Score:9.5
Update:3 months ago
Show doc for...
Tokens:
Raw
### GET /v3/smartguide/guides

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter3_4_3.shtml

服务人员查询接口用于商户开发者查询已注册的服务人员ID等信息。

```APIDOC
## GET /v3/smartguide/guides

### Description
服务人员查询接口用于商户开发者查询已注册的服务人员ID等信息。

### Method
GET

### Endpoint
https://api.mch.weixin.qq.com/v3/smartguide/guides

### Parameters
#### Query Parameters
- **store_id** (string) - Optional - 门店ID
- **sub_mchid** (string) - Optional - 子商户号
- **userid** (string) - Optional - 员工在商户企业微信通讯录使用的唯一标识
```

--------------------------------

### Partner API v3 Go Implementation

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter2_5_3.shtml

Example of initializing merchant configuration and executing a prepay request using the wxpay_utility library.

```go
package main

import (
	"bytes"
	"demo/wxpay_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/v3/partner/4015119446
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"time"
)

func main() {
	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
	config, err := wxpay_utility.CreateMchConfig(
		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
	)
	if err != nil {
		fmt.Println(err)
		return
	}

	request := &PartnerApiv3CommonPrepayRequest{
		SpAppid:     wxpay_utility.String("wx8888888888888888"),
		SpMchid:     wxpay_utility.String("1230000109"),
		SubAppid:    wxpay_utility.String("wxd678efh567hg6999"),
		SubMchid:    wxpay_utility.String("1900000109"),
		Description: wxpay_utility.String("Image形象店-深圳腾大-QQ公仔"),
		OutTradeNo:  wxpay_utility.String("1217752501201407033233368018"),
		TimeExpire:  wxpay_utility.Time(time.Now()),
		Attach:      wxpay_utility.String("自定义数据说明"),
		NotifyUrl:   wxpay_utility.String(" https://www.weixin.qq.com/wxpay/pay.php"),
		GoodsTag:    wxpay_utility.String("WXG"),
		SettleInfo: &PartnerSettleInfo{
			ProfitSharing: wxpay_utility.Bool(true),
		},
		SupportFapiao: wxpay_utility.Bool(false),
		Amount: &CommonAmountInfo{
			Total:    wxpay_utility.Int64(100),
			Currency: wxpay_utility.String("CNY"),
		},
		Detail: &CouponInfo{
			CostPrice: wxpay_utility.Int64(608800),
			InvoiceId: wxpay_utility.String("微信123"),
			GoodsDetail: []GoodsDetail{
				GoodsDetail{
					MerchantGoodsId:  wxpay_utility.String("1246464644"),
					WechatpayGoodsId: wxpay_utility.String("1001"),
					GoodsName:        wxpay_utility.String("iPhoneX 256G"),
					Quantity:         wxpay_utility.Int64(1),
					UnitPrice:        wxpay_utility.Int64(528800),
				},
			},
		},
		SceneInfo: &CommonSceneInfo{
			PayerClientIp: wxpay_utility.String("14.23.150.211"),
			DeviceId:      wxpay_utility.String("013467007045764"),
			StoreInfo: &StoreInfo{
				Id:       wxpay_utility.String("0001"),
				Name:     wxpay_utility.String("腾讯大厦分店"),
				AreaCode: wxpay_utility.String("440305"),
				Address:  wxpay_utility.String("广东省深圳市南山区科技中一道10000号"),
			},
		},
	}

	response, err := PartnerAppPrepay(config, request)
	if err != nil {
		fmt.Printf("请求失败: %+v\n", err)
		// TODO: 请求失败，根据状态码执行不同的处理
		return
	}

	// TODO: 请求成功，继续业务逻辑
```

--------------------------------

### Go Implementation for Creating BusiFavorStock

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter5_2_4.shtml

Example of initializing merchant configuration and constructing a CreateBusiFavorStockRequest using the wxpay_utility library.

```go
package main

import (
	"bytes"
	"demo/wxpay_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/v3/partner/4015119446
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"time"
)

func main() {
	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
	config, err := wxpay_utility.CreateMchConfig(
		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
	)
	if err != nil {
		fmt.Println(err)
		return
	}

	request := &CreateBusiFavorStockRequest{
		StockName:      wxpay_utility.String("8月1日活动券"),
		BelongMerchant: wxpay_utility.String("10000098"),
		Comment:        wxpay_utility.String("活动使用"),
		GoodsName:      wxpay_utility.String("填写商家券可适用的商品或服务"),
		StockType:      BUSIFAVORSTOCKTYPE_NORMAL.Ptr(),
		CouponUseRule: &CouponUseRule{
			CouponAvailableTime: &FavorAvailableTime{
				AvailableBeginTime:       wxpay_utility.Time(time.Now()),
				AvailableEndTime:         wxpay_utility.Time(time.Now()),
				AvailableDayAfterReceive: wxpay_utility.Int64(3),
				AvailableWeek: &AvailableWeek{
					WeekDay: []int64{int64(1)},
					AvailableDayTime: []AvailableCurrentDayTime{AvailableCurrentDayTime{
						BeginTime: wxpay_utility.Int64(3600),
						EndTime:   wxpay_utility.Int64(86399),
					}},
				},
				IrregularyAvaliableTime: []IrregularAvailableTime{IrregularAvailableTime{
					BeginTime: wxpay_utility.Time(time.Now()),
					EndTime:   wxpay_utility.Time(time.Now()),
				}},
				WaitDaysAfterReceive: wxpay_utility.Int64(7),
			},
			FixedNormalCoupon: &FixedValueStockMsg{
				DiscountAmount:     wxpay_utility.Int64(5),
				TransactionMinimum: wxpay_utility.Int64(100),
			},
			DiscountCoupon: &DiscountMsg{
				DiscountPercent:    wxpay_utility.Int64(88),
				TransactionMinimum: wxpay_utility.Int64(100),
			},
			ExchangeCoupon: &ExchangeMsg{
				ExchangePrice:      wxpay_utility.Int64(100),
				TransactionMinimum: wxpay_utility.Int64(100),
			},
			UseMethod:         COUPONUSEMETHOD_OFF_LINE.Ptr(),
			MiniProgramsAppid: wxpay_utility.String("wx23232232323"),
			MiniProgramsPath:  wxpay_utility.String("/path/index/index"),
		},
		StockSendRule: &StockSendRule{
			MaxAmount:          wxpay_utility.Int64(100000),
			MaxCoupons:         wxpay_utility.Int64(100),
			MaxCouponsPerUser:  wxpay_utility.Int64(5),
			MaxAmountByDay:     wxpay_utility.Int64(1000),
			MaxCouponsByDay:    wxpay_utility.Int64(100),
			NaturalPersonLimit: wxpay_utility.Bool(false),
			PreventApiAbuse:    wxpay_utility.Bool(false),
			Transferable:       wxpay_utility.Bool(false),
			Shareable:          wxpay_utility.Bool(false),
		},
		OutRequestNo: wxpay_utility.String("100002322019090134234sfdf"),
		CustomEntrance: &CustomEntrance{
			MiniProgramsInfo: &MiniAppInfo{
				MiniProgramsAppid: wxpay_utility.String("wx234545656765876"),
				MiniProgramsPath:  wxpay_utility.String("/path/index/index"),
				EntranceWords:     wxpay_utility.String("欢迎选购"),
				GuidingWords:      wxpay_utility.String("获取更多优惠"),
			},
			Appid:           wxpay_utility.String("wx324345hgfhfghfg"),
			HallId:          wxpay_utility.String("233455656"),
			StoreId:         wxpay_utility.String("233554655"),
			CodeDisplayMode: CODEDISPLAYMODE_NOT_SHOW.Ptr(),
		},
		DisplayPatternInfo: &DisplayPatternInfo{
			Description:     wxpay_utility.String("xxx门店可用"),
			MerchantLogoUrl: wxpay_utility.String("https://xxx"),
			MerchantName:    wxpay_utility.String("微信支付"),
			BackgroundColor: wxpay_utility.String("xxxxx"),
			CouponImageUrl:  wxpay_utility.String("图片cdn地址"),
			FinderInfo: &FinderInfo{
				FinderId:                 wxpay_utility.String("sph6Rngt2T4RlUf"),
				FinderVideoId:            wxpay_utility.String("export/UzFfAgtgekIEAQAAAAAAb4MgnPInmAAAAAstQy6ubaLX4KHWvLEZgBPEwIEgVnk9HIP-zNPgMJofG6tpdGPJNg_ojtEjoT94"),
				FinderVideoCoverImageUrl: wxpay_utility.String("https://wxpaylogo.qpic.cn/xxx"),
			},
		},
	}
```

--------------------------------

### Create BusiFavor Stock Request and Execution

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter5_2_4.shtml

Example of preparing the request parameters and invoking the CreateBusifavorStock function.

```go
103		CouponCodeMode: COUPONCODEMODE_WECHATPAY_MODE.Ptr(),
104		NotifyConfig: &NotifyConfig{
105			NotifyAppid: wxpay_utility.String("wx23232232323"),
106		},
107		Subsidy: wxpay_utility.Bool(false),
108	}
109
110	response, err := CreateBusifavorStock(config, request)
111	if err != nil {
112		fmt.Printf("请求失败: %+v\n", err)
113		// TODO: 请求失败，根据状态码执行不同的处理
114		return
115	}
116
117	// TODO: 请求成功，继续业务逻辑
118	fmt.Printf("请求成功: %+v\n", response)
119}
```

--------------------------------

### APIv3 Success Response Example

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter5_2_4.shtml

Example of a successful 200 OK response containing the stock_id and creation timestamp.

```json
{
  "stock_id" : "98065001",
  "create_time" : "2015-05-20T13:29:35+08:00"
}
```

--------------------------------

### Profit Sharing Order API Implementation in Go

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter4_4_4.shtml

Example implementation of a profit sharing order request using the wxpay_utility library for configuration and request signing.

```go
package main

import (
	"bytes"
	"demo/wxpay_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/v3/partner/4015119446
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"time"
)

func main() {
	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
	config, err := wxpay_utility.CreateMchConfig(
		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
	)
	if err != nil {
		fmt.Println(err)
		return
	}

	request := &CreateOrderRequest{
		BrandMchid:    wxpay_utility.String("1900000108"),
		SubMchid:      wxpay_utility.String("1900000109"),
		Appid:         wxpay_utility.String("wx8888888888888888"),
		SubAppid:      wxpay_utility.String("wx8888888888888889"),
		TransactionId: wxpay_utility.String("4208450740201411110007820472"),
		OutOrderNo:    wxpay_utility.String("P20150806125346"),
		Receivers: []ReceiverEntity{ReceiverEntity{
			Type:        wxpay_utility.String("MERCHANT_ID"),
			Account:     wxpay_utility.String("1900000109"),
			Amount:      wxpay_utility.Int64(190),
			Description: wxpay_utility.String("分给商户1900000110"),
			Name:        wxpay_utility.String("hu89ohu89ohu89o"), /*请传入wxpay_utility.EncryptOAEPWithPublicKey 加密结果*/
		}},
		Finish: wxpay_utility.Bool(true),
	}

	response, err := CreateOrder(config, request)
	if err != nil {
		fmt.Printf("请求失败: %+v\n", err)
		// TODO: 请求失败，根据状态码执行不同的处理
		return
	}

	// TODO: 请求成功，继续业务逻辑
	fmt.Printf("请求成功: %+v\n", response)
}

func CreateOrder(config *wxpay_utility.MchConfig, request *CreateOrderRequest) (response *CreateOrderResponse, err error) {
	const (
		host   = "https://api.mch.weixin.qq.com"
		method = "POST"
		path   = "/v3/brand/profitsharing/orders"
	)

	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
	if err != nil {
		return nil, err
	}
	reqBody, err := json.Marshal(request)
	if err != nil {
		return nil, err
	}
	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
	if err != nil {
		return nil, err
	}
	httpRequest.Header.Set("Accept", "application/json")
	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
	httpRequest.Header.Set("Content-Type", "application/json")
	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
	if err != nil {
		return nil, err
	}
	httpRequest.Header.Set("Authorization", authorization)

	client := &http.Client{}
	httpResponse, err := client.Do(httpRequest)
	if err != nil {
		return nil, err
	}
	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
	if err != nil {
		return nil, err
	}
	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
		// 2XX 成功，验证应答签名
		err = wxpay_utility.ValidateResponse(
			config.WechatPayPublicKeyId(),
			config.WechatPayPublicKey(),
			&httpResponse.Header,
			respBody,
		)
		if err != nil {
			return nil, err
		}
		response := &CreateOrderResponse{}
```

--------------------------------

### Constructing Merchant Application Request

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter3_3_3.shtml

Example of initializing the request structure with merchant credentials and business information. Sensitive fields like ID card and bank account information require encryption using wxpay_utility.EncryptOAEPWithPublicKey.

```go
15		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
16		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
17		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
18		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
19		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
20	)
21	if err != nil {
22		fmt.Println(err)
23		return
24	}
25
26	request := &SubmitReq{
27		OutRequestNo:       wxpay_utility.String("APPLYMENT_00000000001"),
28		OrganizationType:   wxpay_utility.String("2"),
29		FinanceInstitution: wxpay_utility.Bool(true),
30		BusinessLicenseInfo: &BusinessLicense{
31			CertType:              CERTIFICATETYPE_CERTIFICATE_TYPE_2388.Ptr(),
32			BusinessLicenseCopy:   wxpay_utility.String("47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"),
33			BusinessLicenseNumber: wxpay_utility.String("123456789012345678"),
34			MerchantName:          wxpay_utility.String("腾讯科技有限公司"),
35			LegalPerson:           wxpay_utility.String("张三"),
36			CompanyAddress:        wxpay_utility.String("深圳南山区科苑路"),
37			BusinessTime:          wxpay_utility.String("[\"2014-01-01\",\"长期\"]"),
38		},
39		FinanceInstitutionInfo: &FinanceInstitutionInfo{
40			FinanceType:        FINANCETYPE_BANK_AGENT.Ptr(),
41			FinanceLicensePics: []string{"example_FinanceLicensePics"},
42		},
43		IdHolderType:        IDHOLDERTYPE_LEGAL.Ptr(),
44		IdDocType:           IDENTIFICATIONTYPE_IDENTIFICATION_TYPE_MACAO.Ptr(),
45		AuthorizeLetterCopy: wxpay_utility.String("47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"),
46		IdCardInfo: &IdCardInfo{
47			IdCardCopy:           wxpay_utility.String("jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"),
48			IdCardNational:       wxpay_utility.String("47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"),
49			IdCardName:           wxpay_utility.String("pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg=="), /*请传入 wxpay_utility.EncryptOAEPWithPublicKey 加密结果*/
50			IdCardNumber:         wxpay_utility.String("AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw=="), /*请传入 wxpay_utility.EncryptOAEPWithPublicKey 加密结果*/
51			IdCardValidTimeBegin: wxpay_utility.String("2019-06-06"),
52			IdCardValidTime:      wxpay_utility.String("2026-06-06"),
53		},
54		IdDocInfo: &IdDocInfo{
55			IdDocName:      wxpay_utility.String("jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"), /*请传入 wxpay_utility.EncryptOAEPWithPublicKey 加密结果*/
56			IdDocNumber:    wxpay_utility.String("jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"), /*请传入 wxpay_utility.EncryptOAEPWithPublicKey 加密结果*/
57			IdDocCopy:      wxpay_utility.String("47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"),
58			IdDocCopyBack:  wxpay_utility.String("47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"),
59			DocPeriodBegin: wxpay_utility.String("2019-06-06"),
60			DocPeriodEnd:   wxpay_utility.String("2020-01-02"),
61		},
62		Owner: wxpay_utility.Bool(true),
63		AccountInfo: &AccountInfo{
64			BankAccountType: wxpay_utility.String("75"),
65			AccountBank:     wxpay_utility.String("工商银行"),
66			AccountName:     wxpay_utility.String("AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw=="), /*请传入 wxpay_utility.EncryptOAEPWithPublicKey 加密结果*/
67			BankAddressCode: wxpay_utility.String("110000"),
68			BankBranchId:    wxpay_utility.String("402713354941"),
69			BankName:        wxpay_utility.String("施秉县农村信用合作联社城关信用社"),
```

--------------------------------

### GET /v3/apply4subject/applyment

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter6_1_3.shtml

查询申请单审核结果接口，支持通过申请单编号或业务申请编号查询。

```APIDOC
## GET /v3/apply4subject/applyment

### Description
查询申请单审核结果。申请单编号和业务申请编号至少传一个。

### Method
GET

### Endpoint
https://api.mch.weixin.qq.com/v3/apply4subject/applyment

### Parameters
#### Query Parameters
- **applyment_id** (string) - Optional - 微信支付分配的申请单号
- **business_code** (string) - Optional - 服务商自定义的唯一业务申请编号
```

--------------------------------

### POST /v3/smartguide/guides/{guide_id}/assign

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter3_4_3.shtml

服务人员分配接口用于商户开发者在顾客下单后为顾客分配服务人员使用。调用此接口需在完成支付之前。

```APIDOC
## POST /v3/smartguide/guides/{guide_id}/assign

### Description
服务人员分配接口用于商户开发者在顾客下单后为顾客分配服务人员使用。

### Method
POST

### Endpoint
https://api.mch.weixin.qq.com/v3/smartguide/guides/{guide_id}/assign

### Parameters
#### Path Parameters
- **guide_id** (string) - Required - 服务人员ID

#### Request Body
- **out_trade_no** (string) - Required - 商户系统内部订单号
- **sub_mchid** (string) - Required - 子商户号

### Request Example
{
  "out_trade_no": "20150806125346",
  "sub_mchid": "1234567890"
}
```

--------------------------------

### Initialize PartnerAppPrepay Client

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter2_5_3.shtml

Constructor for initializing the client with merchant credentials and security keys.

```java
private final String mchid;
  private final String certificateSerialNo;
  private final PrivateKey privateKey;
  private final String wechatPayPublicKeyId;
  private final PublicKey wechatPayPublicKey;

  public PartnerAppPrepay(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
    this.mchid = mchid;
    this.certificateSerialNo = certificateSerialNo;
    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
  }
```

--------------------------------

### GET /v3/apply4subject/applyment/merchants/{sub_mchid}/state

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter6_1_3.shtml

查询特约商户的开户意愿确认状态。

```APIDOC
## GET /v3/apply4subject/applyment/merchants/{sub_mchid}/state

### Description
查询微信支付子商户号的开户意愿确认状态。当服务商需要确认子商户是否完成确认时调用此接口，返回“已授权”状态说明商户号已完成开户意愿确认。

### Method
GET

### Endpoint
https://api.mch.weixin.qq.com/v3/apply4subject/applyment/merchants/{sub_mchid}/state

### Parameters
#### Path Parameters
- **sub_mchid** (string) - Required - 特约商户号，微信支付分配的特约商户的唯一标识。
```

--------------------------------

### GET /v3/apply4sub/sub_merchants/{sub_mchid}/settlement

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/devguidelines/chapter3_3_2.shtml

Queries the settlement account details for a specific sub-merchant.

```APIDOC
## GET /v3/apply4sub/sub_merchants/{sub_mchid}/settlement

### Description
Allows a platform to query the settlement account information for a specific secondary merchant.

### Method
GET

### Endpoint
https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/settlement

### Parameters
#### Path Parameters
- **sub_mchid** (string) - Required - The unique identifier of the sub-merchant.
```

--------------------------------

### Go Merchant Configuration Initialization

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter3_3_3.shtml

Initializes merchant configuration using the wxpay_utility library.

```go
package main

import (
	"bytes"
	"demo/wxpay_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/v3/partner/4015119446
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
)

func main() {
	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
	config, err := wxpay_utility.CreateMchConfig(
```

--------------------------------

### GET /v3/ecommerce/profitsharing/orders

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/devguidelines/chapter3_3_4.shtml

Query the status of profit sharing requests and completion for a specific order.

```APIDOC
## GET /v3/ecommerce/profitsharing/orders

### Description
Allows the platform to monitor profit sharing requests and completion status for an order in real-time.

### Method
GET

### Endpoint
https://api.mch.weixin.qq.com/v3/ecommerce/profitsharing/orders

### Parameters
#### Query Parameters
- **sub_mchid** (string) - Required - Sub-merchant ID
- **transaction_id** (string) - Required - WeChat transaction ID
- **out_order_no** (string) - Required - Out order number
```

--------------------------------

### Ecommerce Sub-merchant Application Request

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter3_3_3.shtml

Example of a POST request to the ecommerce sub-merchant application endpoint.

```curl
curl -X POST \
  https://api.mch.weixin.qq.com/v3/ecommerce/applyments/ \
  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
  -H "Accept: application/json" \
  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
  -H "Content-Type: application/json" \
  -d '{
    "out_request_no" : "APPLYMENT_00000000001",
    "organization_type" : "2",
    "finance_institution" : true,
    "business_license_info" : {
      "cert_type" : "CERTIFICATE_TYPE_2388",
      "business_license_copy" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
      "business_license_number" : "123456789012345678",
      "merchant_name" : "腾讯科技有限公司",
      "legal_person" : "张三",
      "company_address" : "深圳南山区科苑路",
      "business_time" : "[\"2014-01-01\",\"长期\"]"
    },
    "finance_institution_info" : {
      "finance_type" : "BANK_AGENT",
      "finance_license_pics" : [
        "example_finance_license_pics"
      ]
    },
    "id_holder_type" : "LEGAL",
    "id_doc_type" : "IDENTIFICATION_TYPE_MACAO",
    "authorize_letter_copy" : "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
    "id_card_info" : {
      "id_card_copy" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
      "id_card_national" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
      "id_card_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
      "id_card_number" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
      "id_card_valid_time_begin" : "2019-06-06",
      "id_card_valid_time" : "2026-06-06"
    },
    "id_doc_info" : {
      "id_doc_name" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
      "id_doc_number" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"
    }'
```

--------------------------------

### POST /v3/ecommerce/applyments/

Source: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/open/pay/chapter3_3_3.shtml

Submits an application for e-commerce merchant onboarding.

```APIDOC
## POST /v3/ecommerce/applyments/

### Description
Submits an application for e-commerce merchant onboarding.

### Method
POST

### Endpoint
/v3/ecommerce/applyments/

### Request Body
- **out_request_no** (string) - Optional - Business application request number
- **organization_type** (string) - Optional - Organization type
- **finance_institution** (bool) - Optional - Whether it is a financial institution
- **business_license_info** (object) - Optional - Business license information
- **finance_institution_info** (object) - Optional - Financial institution information
- **id_holder_type** (object) - Optional - ID holder type
- **id_doc_type** (object) - Optional - ID document type
- **authorize_letter_copy** (string) - Optional - Authorization letter copy
- **id_card_info** (object) - Optional - ID card information
- **id_doc_info** (object) - Optional - ID document information
- **owner** (bool) - Optional - Whether it is the owner
- **account_info** (object) - Optional - Account information
- **contact_info** (object) - Optional - Contact information
- **sales_scene_info** (object) - Optional - Sales scene information
- **settlement_info** (object) - Optional - Settlement information
- **merchant_shortname** (string) - Optional - Merchant short name
- **qualifications** (string) - Optional - Qualifications
- **business_addition_pics** (string) - Optional - Additional business pictures
- **business_addition_desc** (string) - Optional - Additional business description
- **ubo_info_list** (array) - Optional - List of Ultimate Beneficial Owner information

### Response
#### Success Response (200)
- **applyment_id** (int64) - Application ID
- **out_request_no** (string) - Business application request number
```
Tokens:
Raw