微信支付-跨境開發(fā)者中心

1. 接口說明

適用對象:機構(gòu)模式

請求URL: https://apihk.mch.weixin.qq.com/v3/global/merchants/{sub_mchid}

請求方式: PATCH

Path指該參數(shù)為路徑參數(shù)

Query指該參數(shù)為URL參數(shù)

Body指該參數(shù)需在請求JSON傳參

2. 請求參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

機構(gòu)appid

sp_appid

string[1,32]

是

Body機構(gòu)在微信公眾平臺申請服務(wù)號對應(yīng)的APPID
注意：僅適用于機構(gòu)模式
示例值：wx8888888888888888

機構(gòu)商戶號

sp_mchid

string[1,32]

是

Body微信支付分配的機構(gòu)商戶號
注意：僅適用于機構(gòu)模式
示例值：3200000001

子商戶全稱

name

string[1,128]

是

Body子商戶公司注冊的名稱
示例值：Merchant name

子商戶號

sub_mchid

string[1,32]

是

path Sub-merchant ID
示例值: 20000100

子商戶簡稱

shortname

string[1,64]

是

Body子商戶簡稱，用于微信訂單詳情和支付成功頁展示
示例值：Merchant shortname

公司電話

office_phone

string[1,32]

是

Body公司電話
示例值：075586010000

聯(lián)系人信息

contact

object

是

Body聯(lián)系人信息，詳細說明見

參數(shù)名	變量	類型[長度限制]	必填	描述
聯(lián)系人名稱	name	string[1,64]	是	聯(lián)系人名稱，該字段需進行加密處理，加密方法詳見下面說明示例值：李先生
聯(lián)系人電話	phone	string[1,32]	是	聯(lián)系人電話，該字段需進行加密處理，加密方法詳見下面說明示例值：075586010000
聯(lián)系人郵箱	email	string[1,256]	是	聯(lián)系人郵箱，該字段需進行加密處理，加密方法詳見下面說明示例值：test@test.com

類目

business_category

int

是

Body參考附錄，詳見商業(yè)類目列表
示例值：644

渠道號

channel_id

string[1,20]

否

Body機構(gòu)在微信商戶管理后臺創(chuàng)建的渠道號，如有渠道號請?zhí)顚?
示例值：3200000001

注冊國家或區(qū)域

merchant_country_code

string[1,3]

是

Body子商戶公司注冊的國家或區(qū)域
示例值：344

商戶類型

merchant_type

string[1,10]

是

Body 取值ENTERPRISE或INDIVIDUAL
若商戶為自然人或獨資經(jīng)營者，請選擇INDIVIDUAL。
示例值：ENTERPRISE

公司注冊文件編號

registration_certificate_number

string[1,50]

是

Body 公司注冊文件編號。
若商戶為自然人，請?zhí)峁┒禄蜇撠熑说腎D號。
若商戶為獨資經(jīng)營者，請?zhí)峁┆氋Y經(jīng)營的業(yè)務(wù)資質(zhì)證書編號。
示例值：5555-8888

公司注冊文件過期時間

registration_certificate_date

string[1,10]

是

Body 公司注冊文件過期時間。
取值為過期的日期或取值為“PERMANENT”，“N/A”, 若取值為日期，格式為YYYY-MM-DD，比如2020-10-16。
若商戶為自然人，請?zhí)峁┒禄蜇撠熑说腎D號過期日期。
若商戶為獨資經(jīng)營者，請?zhí)峁┆氋Y經(jīng)營的業(yè)務(wù)資質(zhì)證書編號過期日期。
示例值：2020-10-16

公司注冊文件照片

registration_certificate_copy

string[1,128]

否

Body公司注冊文件的照片，取值為《上傳圖片API（For HK）》返回的media ID.
示例值：w7yQFawBtja5uEdm_aoXokv2SDoEmHIPs

子商戶銀行結(jié)算賬戶信息

settlement_bank_number

string[1,128]

否

Body子商戶的結(jié)算銀行賬戶信息
示例值：555588889999

業(yè)務(wù)信息

business

object

是

Body業(yè)務(wù)信息，具體請參考business對象列表

參數(shù)名	變量	類型[長度限制]	必填	描述
業(yè)務(wù)類型	business_type	string[1,7]	是	業(yè)務(wù)類型為ONLINE，OFFLINE或BOTH 示例值：BOTH
APP下載鏈接	app_download	string[1,128]	是/否	商戶APP的下載地址，當業(yè)務(wù)類型取值為ONLINE或BOTH時，app_download, bus_website，office_account, mini_program四項中至少選擇一項傳入示例值：https://download.qq.com
業(yè)務(wù)網(wǎng)站	website	string[1,128]	是/否	當業(yè)務(wù)類型取值為ONLINE或BOTH時，app_download, bus_website，office_account, mini_program四項中至少選擇一項傳入示例值：https://www.qq.com
公眾號	office_account	string[1,128]	是/否	當業(yè)務(wù)類型取值為ONLINE或BOTH時，app_download, bus_website，office_account, mini_program四項中至少選擇一項傳入示例值：wx8888888888888888
小程序	mini_program	string[1,128]	是/否	當業(yè)務(wù)類型取值為ONLINE或BOTH時，app_download, bus_website，office_account, mini_program四項中至少選擇一項傳入示例值：wx8888888888888888
門店地址	store_address	string[1,128]	是/否	商戶門店地址，當業(yè)務(wù)類型取值為OFFLINE或BOTH時必傳示例值：10F World Finance Centre (South Office), 11 Canton Road, Tsim Sha Tsui, Hong Kong
門店照片	store_photos	string[1,1024]	否	商戶門店照片，當業(yè)務(wù)類型取值為OFFLINE或BOTH時建議填寫（非必填）。至少上傳三張門店照片，取值為上傳圖片API返回的media ID。多個圖片，使用Json數(shù)組格式提交。示例值：["1beSM1UtWFrTTtCNYOrlllzaoIwc-RjARO-AP_QprCc", "1beSM1UtWFrTTtCNYOrlliXeq8spgRNG46iLYGMaeqc", "1beSM1UtWFrTTtCNYOrllooH4tOjn3F-NKYa_K6dAV8"]
MCC碼	mcc	string[1,4]	是/否	Mcc碼，詳見商戶行業(yè)編碼示例值：4214

董事信息

director

object

是/否

Body董事信息，當商戶類型為ENTERPRISE必傳，具體請參考director對象列表

參數(shù)名	變量	類型[長度限制]	必填	描述
董事姓名	name	string[1,128]	否	董事姓名，當商戶類型為ENTERPRISE時選擇填入示例值：Bob
董事證件號	number	string[1,128]	否	董事證件號碼，當商戶類型為ENTERPRISE時選擇填入示例值：5555-8888

負責人信息

principal

object

是/否

Body負責人信息，當商戶類型為INDIVIDUAL必傳，具體請參考principal對象列表

參數(shù)名	變量	類型[長度限制]	必填	描述
負責人姓名	name	string[1,128]	否	負責人姓名，當商戶類型為INDIVIDUAL時選擇填入示例值：Bob
負責人證件號	number	string[1,128]	否	負責人證件號，當商戶類型為INDIVIDUAL時選擇填入示例值：5555-8888

是否申請H5支付權(quán)限

apply_h5_payment

boolean

否

是否為子商戶申請H5支付權(quán)限。需要申請H5支付權(quán)限時此字段為true。
如已有H5支付權(quán)限但需要修改H5支付域名，需要填寫為true。
示例值：true

H5支付申請資料資料

h5_payment_apply_info

object

否

BodyH5申請資料，需要申請H5支付權(quán)限時填寫。

參數(shù)名	變量	類型[長度限制]	必填	描述
H5經(jīng)營網(wǎng)址	website_url	string[1,128]	否	apply_h5_payment為true時必填。包含該子商戶的主營業(yè)務(wù)、銷售商品/服務(wù)及價格、用戶可在線下單購買的網(wǎng)址。示例值：https://qq.com
H5支付域名	domains	array	否	apply_h5_payment為true時必填。拉起H5支付的域名，不超過5個；以json數(shù)組格式提交。注意：提交的修改的域名列表會覆蓋已有支付域名列表。示例值：["www.qq.com","www.weixin.com"]

敏感字段加密說明：對于包含了敏感信息的參數(shù)，如聯(lián)系方式等，我們增加了“字段加密”的安全機制，保護敏感信息只能被數(shù)據(jù)的接收方看到。

加密步驟：

1、獲取微信支付平臺證書和對應(yīng)的平臺證書序列號，獲取微信支付平臺證書。本接口請求http頭的“Wechatpay-Serial”需要傳平臺證書序列號。

2、使用微信支付平臺證書的公鑰，對于需要加密的參數(shù)值進行RSA加密。Java語言的加密方法的填充方案使用 RSA/ECB/PKCS1Padding ;PHP填充方式為OPENSSL_PKCS1_PADDING。

3、加密后的密文，使用base64編碼后，作為請求中相應(yīng)參數(shù)的值。

請求示例

JSOM


{
  "sp_appid": "wx82ec4jy334ner1",
  "sp_mchid": "2422128905",
  "name": "Merchant name",
  "shortname": "Merchant shortname",
  "office_phone": "+86075586010000",
  "contact": {
    "name": "yuhZiIh1C8x2UQ9FZY9ojV65HmpttQUSeOi3MdWy52ZoQUSpBUb52dJ+puGkzeGzjuXxJHbD0EGMDOfikdsAr7sqXhqfJexJKN7TSrwewbJqOEJ7fFjB3fqGVu6b/gfq6HduulBgaAlwZ5RcxpEVrAVM54mY3Z9HiX21fcqs65bti/QjEVCg0e1LlypKR3eqdW/XZi3q0gQ3hI0J9crA9OekIGc3M6OZ34aue5VdOd0PTCT99rIcI6N1VuapH2a7hY3fpgGAGxnYgNhUGsTgNoKso0pVCLEl0OlwvYCqmht3foyXtU/4WwwkpK8oFW1yQP3X7D1jXInEakWDFRAcUw==",
    "phone": "XuafjSrgtiqsSzq4QdPEfrfspphyNnVSp9EKg9gM2/szy6ai+q5geSVE5VRRoQlVfiPYK/cFyTk009Cb8GDQilhL0X0HoxcBpcuRIaaW1+LOfMz0POAonG22yER/0486MhQrfNGaCb8QBTfeiIjZT2RPIpvTNyz6cESDV+Y1cD2JKOfK73MU3XKmgQz4mulb9sKdbNtGJV4wc03cR0Md/lnz9QnW5RulHu3bEwVRwtTSGJuMoZntkYhkn4KMRh/z93ri7wKd+DkIfIDMDTzvA2MUn4LW/PJtiKaNP5sOdpmpsw63kOsx5J32mTU7+0qz654MGayTFMW+fSgHBBNYVw==",
    "email": "m+6RSfdEWSAZfrSfrP+FAPzh+jrFPQDPVCaslWwN3EdmsTliLvrUdcYnYuiILHpkZv1E6NNo592KOeznsDrKKWio00qfrurMhTAlneucHfU64yTvIsA6YqeBf8Uqfdad2BG0mYqbIn7AunnE2xqCoqS4W/lJPPROP7VU2/rFzkJx0KMInCo9FErktmN9nNQfhK5dpVis+YNv5SBQ7xSaVAUkTio4xNap1CWpVUIn8CjMgaSa7XJAOwNrNE6+ohU3pA/wlPALNIzYnNu/tktVYnuCm7yA+6wmCrzlWoIC68EgrzzaHZ6Yu59kvibfsMWerSkXRuYT9QNHN8Oe9MdcAQ=="
  },
  "business_category": 644,
  "merchant_country_code": "344",
  "merchant_type": "INDIVIDUAL",
  "registration_certificate_number": "5555-8888",
  "registration_certificate_date": "2025-08-27",
  "registration_certificate_copy": "w7yQFawBtja5uEdm_aoXokv2SDoEmHIPs",
  "business": {
    "business_type": "BOTH",
    "website": "http://www.qq.com",
    "store_address": "shenzhen nanshan tencent",
    "mcc": "5045"
  },
  "apply_h5_payment": true,
  "h5_payment_apply_info": {
    "website_url": "http://www.qq.com",
    "domains": ["www.qq.com", "www.wechat.com"]
  }
}


{
    "appid": "wx2421b1c4370ec43b",
    "m",
      "device_id" : "013467007045764",
      "operator_id": "P001",
      "store_info" : {
        "id": "SZTX001"
      }
    }
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回參數(shù)

正常返回

參數(shù)名	變量	類型[長度限制]	必填	描述
子商戶號	sub_mchid	string[1,32]	是	微信支付分配的子商戶號注意：僅適用于機構(gòu)模式示例值：1900000109
H5支付權(quán)限狀態(tài)	h5_authorization_state	string[1, 32]	否	apply_h5_payment為YES時返回，描述子商戶的H5支付權(quán)限狀態(tài)： APPROVED：已有H5權(quán)限 UNAUTHORIZED：未獲得H5權(quán)限，也未申請過H5權(quán)限 UNDER_REVIEW：H5權(quán)限申請當前在審核中 REJECTED：H5權(quán)限申請被駁回 UNDER_PUNISHMENT：曾經(jīng)申請并獲得H5權(quán)限，但當前權(quán)限被處罰，請聯(lián)系BD處理； APPLICATION_FAILED：H5權(quán)限申請單創(chuàng)建失敗示例值：APPROVED

異常返回

參數(shù)名

變量

類型[長度限制]

必填

描述

返回狀態(tài)碼

code

string[1, 32]

是

錯誤碼，枚舉值見錯誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，為錯誤原因
示例值：參數(shù)格式校驗錯誤

詳細的錯誤描述

detail

object

否

當code為PARAM_ERROR時返回，詳細說明見下

參數(shù)名	變量	類型[長度限制]	必填	描述
指示錯誤參數(shù)的位置	field	string[1, 256]	是	當錯誤參數(shù)位于請求body的JSON時，填寫指向參數(shù)的JSON Pointer 當錯誤參數(shù)位于請求的url或者querystring時，填寫參數(shù)的變量名示例值：#/properties/payer
錯誤參數(shù)的值	value	string[1, 256]	是	錯誤參數(shù)的值示例值：1346177081915535577
具體錯誤原因	issue	string[1, 256]	是	具體錯誤原因示例值：與ALLOF schema不符
錯誤參數(shù)的位置	location	string[1, 256]	否	body：錯誤參數(shù)位于請求body的JSON中 url：錯誤參數(shù)位于請求url中 query：錯誤參數(shù)位于請求的querystring中示例值：body

返回示例

正常示例異常示例增加申請H5支付權(quán)限選項卡

{
    "sub_mchid": "20000100"
}

{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "與ALLOF schema不符",
		"location": "body"
	}
}

{
  "h5_authorization_state": "APPROVED",
  "sub_mchid": "20000100"
}

4. 錯誤碼

錯誤碼	描述	解決方案
PARAM_ERROR	請求參數(shù)未按指引進行填寫	具體參數(shù)格式可以查看文檔
SYSTEM_ERROR	后臺系統(tǒng)返回錯誤	系統(tǒng)異常，請使用原參數(shù)重新發(fā)起
INVALID_REQUEST	商戶系統(tǒng)異常導致，商戶權(quán)限異常、重復請求支付、證書錯誤、頻率限制、商戶號不存在、appid和mchid不存在綁定關(guān)系、渠道號不對等	請根據(jù)接口返回的詳細錯誤描述信息檢查您的程序，具體可以查詢detail 字段返回的詳細信息
INVALID_REQUEST	沒有api創(chuàng)建子商戶的權(quán)限	?請登錄商戶管理后臺人工錄入子商戶信息
INVALID_REQUEST	商戶唯一標識已經(jīng)存在，請更換	針對不同的子商戶，請定義唯一的標識
INVALID_REQUEST	子商戶未通過審核，無法修改。	請耐心等待，在審核通過后再次提交。
INVALID_REQUEST	商戶被處罰，不允許申請開通H5支付權(quán)限。	商戶支付權(quán)限被處罰，請先聯(lián)系運營人員解除。
INVALID_REQUEST	提交的H5經(jīng)營網(wǎng)址或支付域名存在風險，請聯(lián)系對接BD處理。	經(jīng)營網(wǎng)址或者H5支付域名命中黑名單，請聯(lián)系運營人員申請豁免。

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類產(chǎn)品

其他產(chǎn)品

修改子商戶API

1. 接口說明

2. 請求參數(shù)

請求示例

3. 返回參數(shù)

正常返回

異常返回

返回示例

4. 錯誤碼