已接入收付通的商戶,在已完成支付分權(quán)限開(kāi)通及服務(wù)入駐后,可通過(guò)該能力為關(guān)聯(lián)的子商戶完成與支付分服務(wù)的綁定。
# 接口說(shuō)明
支持商戶: 【普通服務(wù)商】
請(qǐng)求URL:/v3/payscore/partner/service-account-applications
請(qǐng)求方式:POST
前置條件:服務(wù)商已開(kāi)通收付通工具箱,子商戶號(hào)已完成收付通入駐;服務(wù)商已完成支付分入駐并與服務(wù)ID存在綁定關(guān)系
# 請(qǐng)求參數(shù)
- service_id 必填 string(32)【服務(wù)ID】 該服務(wù)ID有本接口對(duì)應(yīng)產(chǎn)品的權(quán)限
- appid 必填 string(32)【服務(wù)商應(yīng)用ID】 服務(wù)商申請(qǐng)的公眾號(hào)或移動(dòng)應(yīng)用AppID
- sub_mchid 必填 string(32)【子商戶商戶號(hào)】 子商戶商戶號(hào),由微信支付生成并下發(fā)
- sub_appid 選填 string(32)【子商戶應(yīng)用ID】 子商戶申請(qǐng)的公眾號(hào)或移動(dòng)應(yīng)用AppID
- out_apply_no 必填 string(32)【商戶申請(qǐng)綁定單號(hào)】 商戶系統(tǒng)內(nèi)部服務(wù)訂單號(hào)(不是交易單號(hào)),要求32個(gè)字符內(nèi),只能是數(shù)字、大小寫(xiě)字母_-
- result_notify_url 選填 string(255)**【綁定結(jié)果回調(diào)通知地址】**商戶接收綁定結(jié)果回調(diào)通知的地址若不填寫(xiě)則無(wú)法收到服務(wù)賬戶綁定通知
Body 包體參數(shù)
# 返回參數(shù)
- service_id 必填 string(32)【服務(wù)ID】 該服務(wù)ID有本接口對(duì)應(yīng)產(chǎn)品的權(quán)限
- mchid 必填 string(32)【服務(wù)商商戶號(hào)】 服務(wù)商商戶號(hào),由微信支付生成并下發(fā)
- appid 必填 string(32)【服務(wù)商應(yīng)用ID】 服務(wù)商申請(qǐng)的公眾號(hào)或移動(dòng)應(yīng)用AppID
- sub_mchid 必填 string(32)【子商戶商戶號(hào)】 子商戶商戶號(hào),由微信支付生成并下發(fā)
- sub_appid 選填 string(32)【子商戶應(yīng)用ID】 子商戶申請(qǐng)的公眾號(hào)或移動(dòng)應(yīng)用AppID
- out_apply_no 必填 string(32)【申請(qǐng)單號(hào)】 商戶系統(tǒng)內(nèi)部服務(wù)訂單號(hào)(不是交易單號(hào)),要求32個(gè)字符內(nèi),只能是數(shù)字、大小寫(xiě)字母_-|* 且在同一個(gè)商戶號(hào)下唯一。
- result_notify_url 選填 string(255)【綁定結(jié)果回調(diào)通知地址】 商戶接收綁定結(jié)果回調(diào)通知的地址
- apply_state 必填 string(32)【受理狀態(tài)】 枚舉值:PROCESSING:處理中;APPROVED:綁定成功;REJECTED:綁定失敗
- reject_reason 選填 string(256)【拒絕原因】 拒絕原因(僅REJECTED時(shí)返回)
請(qǐng)求示例
1{2 "service_id": "2002000000000558128851361561536",3 "appid": "wxd678efh567hg6787",4 "sub_mchid": "1900000109",5 "sub_appid": "wxd678efh567hg6787",6 "out_apply_no": "1234323JKHDFE1243252",7 "result_notify_url": "https://api.test.com"8}
返回示例
1{2 "service_id": "2002000000000558128851361561536",3 "mchid": "1900000104",4 "appid": "wxd678efh567hg6787",5 "sub_mchid": "1900000109",6 "sub_appid": "wxd678efh567hg6787",7 "out_apply_no": "1234323JKHDFE1243252",8 "result_notify_url": "https://api.test.com",9 "apply_state": "APPROVED",10 "reject_reason": "賬戶異常,綁定失敗"11}
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 | 請(qǐng)參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過(guò) | 請(qǐng)參閱 簽名常見(jiàn)問(wèn)題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請(qǐng)稍后重試 | 請(qǐng)稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
403 | NO_AUTH | 商戶暫無(wú)權(quán)限使用此功能 | 登錄商戶平臺(tái)核對(duì),傳入正確信息 |
404 | NOT_FOUND | 訂單不存在 | 確認(rèn)入?yún)ⅲ瑐魅胝_單據(jù) |
400 | INVALID_REQUEST | 請(qǐng)求參數(shù)符合參數(shù)格式,但不符合業(yè)務(wù)規(guī)則 | 請(qǐng)確認(rèn)相同單號(hào)是否使用了不同的參數(shù) |
429 | FREQUENCY_LIMITED | 頻率超限 | 請(qǐng)降低頻率重試 |