開發(fā)指引-連鎖品牌分賬 | 微信支付合作伙伴平臺文檔中心

連鎖品牌分賬開發(fā)指引

1. 接口規(guī)則

為了在保證支付安全的前提下，帶給商戶簡單、一致且易用的開發(fā)體驗，我們推出了全新的微信支付APIv3接口。該版本API的具體規(guī)則請參考“APIv3接口規(guī)則”

2. 開發(fā)準備

2.1. 搭建和配置開發(fā)環(huán)境

為了幫助開發(fā)者調(diào)用開放接口，我們提供了JAVA、PHP、GO三種語言版本的開發(fā)庫，封裝了簽名生成、簽名驗證、敏感信息加/解密、媒體文件上傳等基礎(chǔ)功能（更多語言版本的開發(fā)庫將在近期陸續(xù)提供）

測試步驟：

1、根據(jù)自身開發(fā)語言，選擇對應的開發(fā)庫并構(gòu)建項目，具體配置請參考下面鏈接的詳細說明：

? wechatpay-java（推薦）wechatpay-apache-httpclient，適用于Java開發(fā)者。

? wechatpay-php（推薦）、wechatpay-guzzle-middleware，適用于PHP開發(fā)者

注：當前開發(fā)指引接口PHP示例代碼采用wechatpay-guzzle-middleware版本

? wechatpay-go，適用于Go開發(fā)者

更多資源可前往微信支付開發(fā)者社區(qū)搜索查看

2、創(chuàng)建加載商戶私鑰、加載平臺證書、初始化httpClient的通用方法

JAVA
PHP


@Before
public void setup() throws IOException {
    // 加載商戶私鑰（privateKey：私鑰字符串）
    PrivateKey merchantPrivateKey = PemUtil
            .loadPrivateKey(new ByteArrayInputStream(privateKey.getBytes("utf-8")));
 
    // 加載平臺證書（mchId：商戶號,mchSerialNo：商戶證書序列號,apiV3Key：V3密鑰）
    AutoUpdateCertificatesVerifier verifier = new AutoUpdateCertificatesVerifier(
            new WechatPay2Credentials(mchId, new PrivateKeySigner(mchSerialNo, merchantPrivateKey)),apiV3Key.getBytes("utf-8"));
 
    // 初始化httpClient
    httpClient = WechatPayHttpClientBuilder.create()
            .withMerchant(mchId, mchSerialNo, merchantPrivateKey)
            .withValidator(new WechatPay2Validator(verifier)).build();
}
 
@After
public void after() throws IOException {
    httpClient.close();
}


use GuzzleHttp\Exception\RequestException;
use WechatPay\GuzzleMiddleware\WechatPayMiddleware;
use WechatPay\GuzzleMiddleware\Util\PemUtil;
use GuzzleHttp\HandlerStack;
 
// 商戶相關(guān)配置，
$merchantId = '1000100'; // 商戶號
$merchantSerialNumber = 'XXXXXXXXXX'; // 商戶API證書序列號
$merchantPrivateKey = PemUtil::loadPrivateKey('./path/to/mch/private/key.pem'); // 商戶私鑰文件路徑
 
// 微信支付平臺配置
$wechatpayCertificate = PemUtil::loadCertificate('./path/to/wechatpay/cert.pem'); // 微信支付平臺證書文件路徑
 
// 構(gòu)造一個WechatPayMiddleware
$wechatpayMiddleware = WechatPayMiddleware::builder()
    ->withMerchant($merchantId, $merchantSerialNumber, $merchantPrivateKey) // 傳入商戶相關(guān)配置
    ->withWechatPay([ $wechatpayCertificate ]) // 可傳入多個微信支付平臺證書，參數(shù)類型為array
    ->build();
 
// 將WechatPayMiddleware添加到Guzzle的HandlerStack中
$stack = GuzzleHttp\HandlerStack::create();
$stack->push($wechatpayMiddleware, 'wechatpay');
 
// 創(chuàng)建Guzzle HTTP Client時，將HandlerStack傳入，接下來，正常使用Guzzle發(fā)起API請求，WechatPayMiddleware會自動地處理簽名和驗簽
$client = new GuzzleHttp\Client(['handler' => $stack]);


/*
    Package core 微信支付api v3 go http-client 基礎(chǔ)庫，你可以使用它來創(chuàng)建一個client，并向微信支付發(fā)送http請求
    只需要你在初始化客戶端的時候，傳遞credential以及validator
    credential用來生成http header中的authorization信息
    validator則用來校驗回包是否被篡改
    如果http請求返回的err為nil，一般response.Body 都不為空，你可以嘗試對其進行序列化
    請注意及時關(guān)閉response.Body
    注意：使用微信支付apiv3 go庫需要引入相關(guān)的包，該示例代碼必須引入的包名有以下信息

    "context"
    "crypto/x509"
    "fmt"
    "io/ioutil"
    "log"
    "github.com/wechatpay-apiv3/wechatpay-go/core"
    "github.com/wechatpay-apiv3/wechatpay-go/core/option"
    "github.com/wechatpay-apiv3/wechatpay-go/utils"

    */
func SetUp() (opt []option.ClientOption, err error) {
    //商戶號
    mchID := ""
    //商戶證書序列號
    mchCertSerialNumber := ""
    //商戶私鑰文件路徑
    privateKeyPath := ""
    //平臺證書文件路徑
    wechatCertificatePath := ""

    // 加載商戶私鑰
    privateKey, err := utils.LoadPrivateKeyWithPath(privateKeyPath)
    if err != nil {
        log.Printf("load private err:%s", err.Error())
        return nil, err
    }
    // 加載微信支付平臺證書
    wechatPayCertificate, err := utils.LoadCertificateWithPath(wechatCertificatePath)
    if err != nil {
        log.Printf("load certificate err:%s",err)
        return nil, err
    }
    //設(shè)置header頭中authorization信息
    opts := []option.ClientOption{
        option.WithMerchant(mchID, mchCertSerialNumber, privateKey), // 設(shè)置商戶相關(guān)配置
        option.WithWechatPay([]*x509.Certificate{wechatPayCertificate}), // 設(shè)置微信支付平臺證書，用于校驗回包信息用
    }
    return opts, nil
}

3、基于接口的示例代碼，替換請求參數(shù)后可發(fā)起測試

說明：

? 上面的開發(fā)庫為微信支付官方開發(fā)庫，其它沒有審核或者控制下的第三方工具和庫，微信支付不保證它們的安全性和可靠性

通過包管理工具引入SDK后，可根據(jù)下面每個接口的示例代碼替換相關(guān)參數(shù)后進行快速測試

? 開發(fā)者如果想詳細了解簽名生成、簽名驗證、敏感信息加/解密、媒體文件上傳等常用方法的具體代碼實現(xiàn)，可閱讀下面的詳細說明：

1.簽名生成

2.簽名驗證

3.敏感信息加解密

4.merchantPrivateKey（私鑰）

5.wechatpayCertificates（平臺證書）

6.APIV3Key（V3 key）

? 如想更詳細的了解我們的接口規(guī)則，可查看我們的接口規(guī)則指引文檔

2.2. 業(yè)務開發(fā)配置

2.2.1. 服務商開通連鎖品牌工具箱

服務商可登錄【服務商平臺-合作工具箱】申請開通【連鎖品牌工具箱】。進行品牌申請、查看品牌申請進度、邀請品牌總部授權(quán)、品牌門店管理、品牌流量場景管理等日常管理。

2.2.2. 設(shè)置分賬比例

連鎖工具箱開通后，品牌主在商戶平臺進入：“品牌專區(qū)-品牌交易-品牌供應鏈分賬-供應鏈分賬管理”中可進行分賬比例的調(diào)整。

3. 快速接入

3.1. 業(yè)務流程圖

業(yè)務流程時序圖：

步驟4 分賬前需調(diào)用《添加分賬接收方》接口添加分賬接收方。

步驟6 分賬訂單發(fā)起分賬需調(diào)用《請求分賬》接口進行分賬，微信支付將會把結(jié)算資金分給分賬接收方。

步驟8 分賬完成后，微信會通過《分賬動賬通知》接口，主動通知商戶。商戶也可以通過《查詢分賬結(jié)果》接口，主動查詢分賬結(jié)果。

步驟12分賬后若產(chǎn)生退款，則需先調(diào)用《請求分賬回退》接口，請求將已經(jīng)分給分賬方的資金回退，再處理退款。

步驟13分賬回退完成后，微信同樣會通過《分賬動賬通知》接口，主動通知商戶。商戶也可以通過《查詢分賬回退結(jié)果》接口，主動查詢分賬結(jié)果。

步驟17分賬結(jié)束后，商戶需調(diào)用《完結(jié)分賬》接口結(jié)束分賬訂單。

3.2. API接入（含示例代碼）

文檔展示了如何使用微信支付服務端 SDK 快速接入連鎖品牌分賬產(chǎn)品，完成與微信支付對接的部分。

注意：

文檔中的代碼示例是用來闡述 API 基本使用方法，代碼中的示例參數(shù)需替換成商戶自己賬號及請求參數(shù)才能跑通。
以下接入步驟僅提供參考，請商戶結(jié)合自身業(yè)務需求進行評估、修改。

3.2.1. 【服務端】請求分賬

步驟說明：微信訂單支付成功后，由服務商發(fā)起分賬請求，將結(jié)算后的資金分給分賬接收方。

示例代碼：

JAVA
PHP


public void ProfitSharing() throws Exception{
    //請求URL
    HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders");
    // 請求body參數(shù)
    String reqdata = "{"
            + "\"brand_mchid\":\"1900000108\","
            + "\"sub_mchid\":\"1900000109\","
            + "\"appid\":\"wx8888888888888888\","
            + "\"sub_appid\":\"wx8888888888888889\","
            + "\"transaction_id\":\"4208450740201411110007820472\","
            + "\"out_order_no\":\"P20150806125346\","
            + "\"receivers\": ["
            + "{"
            + "\"type\":\"MERCHANT_ID\","
            + "\"account\":\"1900000110\","
            + "\"amount\":100,"
            + "\"description\":\"1900000109分給商戶1900000110\""
            + "}"
            + "],"
            + "\"finish\":true"
            + "}";
    StringEntity entity = new StringEntity(reqdata,"utf-8");
    entity.setContentType("application/json");
    httpPost.setEntity(entity);
    httpPost.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpPost);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'POST',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders', //請求URL
        [
            // JSON請求體
            'json' => [
                "brand_mchid" => "1900000108", 
                "sub_mchid" => "1900000109", 
                "appid" => "wx8888888888888888", 
                "sub_appid" => "wx8888888888888889", 
                "transaction_id" => "4208450740201411110007820472", 
                "out_order_no" => "P20150806125346", 
                "receivers" => [
                    [
                        "type" => "MERCHANT_ID", 
                        "account" => "1900000110", 
                        "amount" => 100, 
                        "description" => "1900000109分給商戶1900000110", 
                    ],
                ],
                "finish" => true,
            ],
            'headers' => [ 'Accept' => 'application/json' ]
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func ProfitSharing() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
 //設(shè)置請求地址
  URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders"
  //設(shè)置請求信息,此處也可以使用結(jié)構(gòu)體來進行請求
  mapInfo := map[string]interface{}{
    "brand_mchid": "1900000108",
    "sub_mchid": "1900000109",
    "appid": "wx8888888888888888",
    "sub_appid": "wx8888888888888889",
    "transaction_id": "4208450740201411110007820472",
    "out_order_no": "P20150806125346",
    "receivers": []map[string]interface{}{
      map[string]interface{}{
        "type": "MERCHANT_ID",
        "account": "1900000110",
        "amount": 100,
        "description": "1900000109分給商戶1900000110",
     },
    },
    "finish": true,
  }

  // 發(fā)起請求
  response, err := client.Post(ctx, URL, mapInfo)
  if err != nil{
    log.Printf("client post err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}

重要入?yún)⒄f明：

? brand_mchid：品牌主商戶號，填寫微信支付分配的商戶號。? coupon_code：券code，券的唯一標識。

? sub_mchid：子商戶號，訂單收款方商戶號，可以是品牌主商戶號，也可以是門店商戶號，填寫微信支付分配的商戶號。

? appid：公眾賬號ID，微信分配的公眾賬號ID，這里指服務商的appid

? out_order_no：商戶分賬單號，商戶系統(tǒng)內(nèi)部的分賬單號，在商戶系統(tǒng)內(nèi)部唯一（單次分賬、多次分賬、完結(jié)分賬應使用不同的商戶分賬單號），同一分賬單號多次請求等同一次，只能是數(shù)字、大小寫字母_-|*@。

注意：

更多參數(shù)、響應詳情及錯誤碼請參見請求分賬接口文檔

3.2.2. 【服務端】查詢分賬結(jié)果

步驟說明：發(fā)起分賬請求后，可調(diào)用此接口查詢分賬結(jié)果。發(fā)起分賬完結(jié)請求后，可調(diào)用此接口查詢分賬完結(jié)的結(jié)果。

示例代碼：

JAVA
PHP


public void QueryProfitSharing() throws Exception{
    //請求URL
    HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders?sub_mchid=1900000109&transaction_id=4208450740201411110007820472&out_order_no=P20150806125346");
    httpGet.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpGet);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'GET',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders?sub_mchid=1900000109&transaction_id=4208450740201411110007820472&out_order_no=P20150806125346', //請求URL
        [
            'headers' => [ 'Accept' => 'application/json']
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func QueryProfitSharing() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
   //設(shè)置請求地址
   URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders?sub_mchid=1900000109&transaction_id=4208450740201411110007820472&out_order_no=P20150806125346"
  // 發(fā)起請求
  response, err := client.Get(ctx, URL)
  if err != nil{
    log.Printf("client get err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}

重要入?yún)⒄f明：

? transaction_id：微信訂單號，微信支付訂單號

? sub_mchid：子商戶號，訂單收款方商戶號，可以是品牌主商戶號，也可以是門店商戶號，填寫微信支付分配的商戶號。

注意：

更多參數(shù)、響應詳情及錯誤碼請參見查詢分賬結(jié)果接口文檔

3.2.3.【服務端】分賬動賬通知

步驟說明：此功能僅針對分賬接收方，當分賬動賬金額發(fā)生變動時，微信會把相關(guān)變動結(jié)果發(fā)送給需要實時關(guān)注的分賬接收方

注意：

分賬動賬通知是以POST 方法訪問商戶設(shè)置的通知url，通知的數(shù)據(jù)以JSON 格式通過請求主體（BODY）傳輸。通知的數(shù)據(jù)包括了加密的支付結(jié)果詳情
加密不能保證通知請求來自微信。微信會對發(fā)送給商戶的通知進行簽名，并將簽名值放在通知的HTTP頭Wechatpay-Signature。商戶應當驗證簽名，以確認請求來自微信，而不是其他的第三方。簽名驗證的算法請參考《微信支付API v3簽名驗證》。
分賬動賬通知http應答碼為200或204才會當作正常接收，當回調(diào)處理異常時，應答的HTTP狀態(tài)碼應為500，或者4xx
商戶成功接收到回調(diào)通知后應返回成功的http應答碼為200或204
同樣的通知可能會多次發(fā)送給商戶系統(tǒng)。商戶系統(tǒng)必須能夠正確處理重復的通知。推薦的做法是，當商戶系統(tǒng)收到通知進行處理時，先檢查對應業(yè)務數(shù)據(jù)的狀態(tài)，并判斷該通知是否已經(jīng)處理。如果未處理，則再進行處理；如果已處理，則直接返回結(jié)果成功。在對業(yè)務數(shù)據(jù)進行狀態(tài)檢查和處理之前，要采用數(shù)據(jù)鎖進行并發(fā)控制，以避免函數(shù)重入造成的數(shù)據(jù)混亂。

更多參數(shù)、響應詳情及錯誤碼請參見分賬動賬通知接口文檔

3.2.4. 【服務端】請求分賬回退

步驟說明：如果訂單已經(jīng)分賬，在退款時，可以先調(diào)此接口，將已分賬的資金從商戶類型的分賬接收方的賬戶回退給分賬方，再發(fā)起退款。

示例代碼：

JAVA
PHP


public void ReturnProfitSharing() throws Exception{
    //請求URL
    HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/brand/profitsharing/returnorders");
    // 請求body參數(shù)
    String reqdata = "{"
            + "\"sub_mchid\":\"1900000109\","
            + "\"order_id\":\"3008450740201411110007820472\","
            + "\"out_order_no\":\"P20150806125346\","
            + "\"out_return_no\":\"R20190516001\","
            + "\"return_mchid\":\"86693852\","
            + "\"amount\":10,"
            + "\"description\":\"分賬回退\""
            + "}";
    StringEntity entity = new StringEntity(reqdata,"utf-8");
    entity.setContentType("application/json");
    httpPost.setEntity(entity);
    httpPost.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpPost);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'POST',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/returnorders', //請求URL
        [
            // JSON請求體
            'json' => [
                "sub_mchid" => "1900000109", 
                "order_id" => "3008450740201411110007820472", 
                "out_order_no" => "P20150806125346", 
                "out_return_no" => "R20190516001", 
                "return_mchid" => "86693852", 
                "amount" => 10, 
                "description" => "分賬回退",
            ],
            'headers' => [ 'Accept' => 'application/json' ]
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func ReturnProfitSharing() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
   //設(shè)置請求地址
  URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/returnorders"
  //設(shè)置請求信息,此處也可以使用結(jié)構(gòu)體來進行請求
  mapInfo := map[string]interface{}{
    "sub_mchid": "1900000109",
    "order_id": "3008450740201411110007820472",
    "out_return_no": "R20190516001",
    "return_mchid": "86693852",
    "amount": 10,
    "description": "分賬回退",
  }

  // 發(fā)起請求
  response, err := client.Post(ctx, URL, mapInfo)
  if err != nil{
    log.Printf("client post err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}

重要入?yún)⒄f明：

? sub_mchid：子商戶號，訂單收款方商戶號，可以是品牌主商戶號，也可以是門店商戶號，填寫微信支付分配的商戶號。

? out_return_no：商戶回退單號，此回退單號是商戶在自己后臺生成的一個新的回退單號，在商戶后臺唯一，只能是數(shù)字、大小寫字母_-|*@。

? return_mchid：回退商戶號，回退商戶號只能填寫原分賬請求中接收分賬的商戶號

注意：

更多參數(shù)、響應詳情及錯誤碼請參見請求分賬回退接口文檔

3.2.5. 【服務端】查詢分賬回退結(jié)果

步驟說明：商戶需要核實回退結(jié)果，可調(diào)用此接口查詢回退結(jié)果。如果分賬回退接口返回狀態(tài)為處理中，可調(diào)用此接口查詢回退結(jié)果

示例代碼：

JAVA
PHP


public void QueryReturnOrder() throws Exception{
    //請求URL
    HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/brand/profitsharing/returnorders?sub_mchid=1900000109&out_return_no=R20190516001&order_id=4208450740201411110007820472");
    httpGet.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpGet);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'GET',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/returnorders?sub_mchid=1900000109&out_return_no=R20190516001&order_id=4208450740201411110007820472', //請求URL
        [
            'headers' => [ 'Accept' => 'application/json']
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func QueryReturnOrder() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
    URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/returnorders?sub_mchid=1900000109&out_return_no=R20190516001&order_id=4208450740201411110007820472"
  // 發(fā)起請求
  response, err := client.Get(ctx, URL)
  if err != nil{
    log.Printf("client get err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}

重要入?yún)⒄f明：

? sub_mchid：子商戶號，訂單收款方商戶號，可以是品牌主商戶號，也可以是門店商戶號，填寫微信支付分配的商戶號。

? out_return_no：商戶回退單號，調(diào)用回退接口提供的商戶系統(tǒng)內(nèi)部的回退單號。

注意：

更多參數(shù)、響應詳情及錯誤碼請參見查詢分賬回退結(jié)果接口文檔

3.2.6. 【服務端】完結(jié)分賬

步驟說明：不需要進行分賬的訂單，可直接調(diào)用本接口將訂單的金額全部解凍給分賬方商戶

示例代碼：

JAVA
PHP


public void FinishProfitSharing() throws Exception{
    //請求URL
    HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/brand/profitsharing/finish-order");
    // 請求body參數(shù)
    String reqdata = "{"
            + "\"sub_mchid\":\"1900000109\","
            + "\"transaction_id\":\"4208450740201411110007820472\","
            + "\"out_order_no\":\"P20150806125346\","
            + "\"description\":\"分賬完結(jié)\""
            + "}";
    StringEntity entity = new StringEntity(reqdata,"utf-8");
    entity.setContentType("application/json");
    httpPost.setEntity(entity);
    httpPost.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpPost);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'POST',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/finish-order', //請求URL
        [
            // JSON請求體
            'json' => [
                "sub_mchid" => "1900000109", 
                "transaction_id" => "4208450740201411110007820472", 
                "out_order_no" => "P20150806125346", 
                "description" => "分賬完結(jié)",
            ],
            'headers' => [ 'Accept' => 'application/json' ]
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func FinishProfitSharing() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
    //設(shè)置請求地址
  URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/finish-order"
  //設(shè)置請求信息,此處也可以使用結(jié)構(gòu)體來進行請求
  mapInfo := map[string]interface{}{
    "sub_mchid": "1900000109",
    "transaction_id": "4208450740201411110007820472",
    "out_order_no": "P20150806125346",
    "description": "分賬完結(jié)",
  }

  // 發(fā)起請求
  response, err := client.Post(ctx, URL, mapInfo)
  if err != nil{
    log.Printf("client post err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}

重要入?yún)⒄f明：

? transaction_id：微信訂單號，微信支付訂單號

? sub_mchid：子商戶號，訂單收款方商戶號，可以是品牌主商戶號，也可以是門店商戶號，填寫微信支付分配的商戶號。

注意：

更多參數(shù)、響應詳情及錯誤碼請參見完結(jié)分賬接口文檔

3.2.7. 【服務端】查詢訂單剩余待分金額

步驟說明：可調(diào)用此接口查詢訂單剩余待分金額

示例代碼：

JAVA
PHP


public void QueryRemainAmounts() throws Exception{
    //請求URL
    HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders/4208450740201411110007820472/amounts");
    httpGet.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpGet);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'GET',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders/4208450740201411110007820472/amounts', //請求URL
        [
            'headers' => [ 'Accept' => 'application/json']
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func QueryRemainAmounts() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
   //設(shè)置請求地址
   URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders/4208450740201411110007820472/amounts"
  // 發(fā)起請求
  response, err := client.Get(ctx, URL)
  if err != nil{
    log.Printf("client get err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}

重要入?yún)⒄f明：

? transaction_id：微信訂單號，微信支付訂單號

注意：

更多參數(shù)、響應詳情及錯誤碼請參見查詢訂單剩余待分金額接口文檔

3.2.8. 【服務端】查詢最大分賬比例

步驟說明：服務商可通過此接口添加分賬接收方，建立分賬接收方列表。連鎖加盟模式下，服務商添加的分賬接收方統(tǒng)一在品牌主商戶號維度進行管理。

示例代碼：

JAVA
PHP


public void QueryBrandConfigs() throws Exception{
    //請求URL
    HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/brand/profitsharing/brand-configs/1900000109");
    httpGet.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpGet);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'GET',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/brand-configs/1900000109', //請求URL
        [
            'headers' => [ 'Accept' => 'application/json']
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func QueryBrandConfigs() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
   //設(shè)置請求地址
    URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/brand-configs/1900000109"
  // 發(fā)起請求
  response, err := client.Get(ctx, URL)
  if err != nil{
    log.Printf("client get err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}

重要入?yún)⒄f明：

? brand_mchid：品牌主商戶號，通過微信支付認證的品牌主商戶號，填寫微信支付分配的商戶號

注意：

更多參數(shù)、響應詳情及錯誤碼請參見查詢最大分賬比例接口文檔

3.2.9. 【服務端】添加分賬接收方

示例代碼：

JAVA
PHP


public void AddReceivers() throws Exception{
    //請求URL
    HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/brand/profitsharing/receivers/add");
    // 請求body參數(shù)
    String reqdata = "{"
            + "\"brand_mchid\":\"1900000108\","
            + "\"appid\":\"wx8888888888888888\","
            + "\"sub_appid\":\"wx8888888888888889\","
            + "\"type\":\"MERCHANT_ID\","
            + "\"account\":\"1900000109\","
            + "\"name\":\"張三網(wǎng)絡公司\","
            + "\"relation_type\":\"SUPPLIER\""
            + "}";
    StringEntity entity = new StringEntity(reqdata,"utf-8");
    entity.setContentType("application/json");
    httpPost.setEntity(entity);
    httpPost.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpPost);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'POST',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/receivers/add', //請求URL
        [
            // JSON請求體
            'json' => [
                "brand_mchid" => "1900000108", 
                "appid" => "wx8888888888888888", 
                "sub_appid" => "wx8888888888888889", 
                "type" => "MERCHANT_ID", 
                "account" => "1900000109", 
                "name" => "張三網(wǎng)絡公司", 
                "relation_type" => "SUPPLIER",
            ],
            'headers' => [ 'Accept' => 'application/json' ]
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func AddReceivers() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
    //設(shè)置請求地址
  URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/receivers/add"
  //設(shè)置請求信息,此處也可以使用結(jié)構(gòu)體來進行請求
  mapInfo := map[string]interface{}{
    "brand_mchid": "1900000108",
    "appid": "wx8888888888888888",
    "sub_appid": "wx8888888888888889",
    "type": "MERCHANT_ID",
    "account": "1900000109",
    "name": "張三網(wǎng)絡公司",
    "relation_type": "SUPPLIER",
  }

  // 發(fā)起請求
  response, err := client.Post(ctx, URL, mapInfo)
  if err != nil{
    log.Printf("client post err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}
本系統(tǒng)由微信支付聯(lián)合產(chǎn)品部承擔策劃建設(shè)

重要入?yún)⒄f明：

? brand_mchid：品牌主商戶號，通過微信支付認證的品牌主商戶號，填寫微信支付分配的商戶號

? appid：公眾賬號ID，微信分配的公眾賬號ID，這里指服務商的appid

? type：分賬接收方類型，枚舉值：

MERCHANT_ID：商戶號（mch_id或者sub_mch_id）

PERSONAL_OPENID：個人openid（由服務商的APPID轉(zhuǎn)換得到）

PERSONAL_SUB_OPENID：個人sub_openid（由品牌主的APPID轉(zhuǎn)換得到）

? account：分賬接收方賬號

分賬接收方類型為：MERCHANT_ID時，分賬接收方賬號為商戶號（mch_id或者sub_mch_id）

分賬接收方類型為：PERSONAL_OPENID時，分賬接收方賬號為個人openid

分賬接收方類型為：PESONAL_SUB_OPENID時，分賬接收方賬號為個人sub_openid

注意：

更多參數(shù)、響應詳情及錯誤碼請參見添加分賬接收方接口文檔

3.2.10. 【服務端】刪除分賬接收方

步驟說明：服務商發(fā)起刪除分賬接收方請求。刪除后，不再支持品牌主或門店分到該分賬接收方。

示例代碼：

JAVA
PHP


public void DelReceivers() throws Exception{
    //請求URL
    HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/brand/profitsharing/receivers/delete");
    // 請求body參數(shù)
    String reqdata = "{"
            + "\"brand_mchid\":\"1900000108\","
            + "\"appid\":\"wx8888888888888888\","
            + "\"sub_appid\":\"wx8888888888888889\","
            + "\"type\":\"MERCHANT_ID\","
            + "\"account\":\"1900000109\""
            + "}";
    StringEntity entity = new StringEntity(reqdata,"utf-8");
    entity.setContentType("application/json");
    httpPost.setEntity(entity);
    httpPost.setHeader("Accept", "application/json");

    //完成簽名并執(zhí)行請求
    CloseableHttpResponse response = httpClient.execute(httpPost);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //處理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //處理成功，無返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}


try {
    $resp = $client->request(
        'POST',
        'https://api.mch.weixin.qq.com/v3/brand/profitsharing/receivers/delete', //請求URL
        [
            // JSON請求體
            'json' => [
                "brand_mchid" => "1900000108", 
                "appid" => "wx8888888888888888", 
                "sub_appid" => "wx8888888888888889", 
                "type" => "MERCHANT_ID", 
                "account" => "1900000109",
            ],
            'headers' => [ 'Accept' => 'application/json' ]
        ]
    );
    $statusCode = $resp->getStatusCode();
    if ($statusCode == 200) { //處理成功
        echo "success,return body = " . $resp->getBody()->getContents()."\n";
    } else if ($statusCode == 204) { //處理成功，無返回Body
        echo "success";
    }
} catch (RequestException $e) {
    // 進行錯誤處理
    echo $e->getMessage()."\n";
    if ($e->hasResponse()) {
        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
    }
    return;
}


func DelReceivers() {
       // 初始化客戶端
    ctx := context.TODO()
    opts, err := SetUp()
    if err != nil {
        return
    }
    client, err := core.NewClient(ctx, opts...,)
    if err != nil{
        log.Printf("init client err:%s",err)
        return
    }
    //設(shè)置請求地址
  URL := "https://api.mch.weixin.qq.com/v3/brand/profitsharing/receivers/delete"
  //設(shè)置請求信息,此處也可以使用結(jié)構(gòu)體來進行請求
  mapInfo := map[string]interface{}{
    "brand_mchid": "1900000108",
    "appid": "wx8888888888888888",
    "sub_appid": "wx8888888888888889",
    "type": "MERCHANT_ID",
    "account": "1900000109",
  }

  // 發(fā)起請求
  response, err := client.Post(ctx, URL, mapInfo)
  if err != nil{
    log.Printf("client post err:%s",err)
    return
  }
  // 校驗回包內(nèi)容是否有邏輯錯誤
  err = core.CheckResponse(response)
  if err != nil{
    log.Printf("check response err:%s",err)
    return
  }
  // 讀取回包信息
  body, err := ioutil.ReadAll(response.Body)
  if err != nil{
    log.Printf("read response body err:%s",err)
    return
  }
  fmt.Println(string(body))
}

重要入?yún)⒄f明：

? brand_mchid：品牌主商戶號，通過微信支付認證的品牌主商戶號，填寫微信支付分配的商戶號

? appid：公眾賬號ID，微信分配的公眾賬號ID，這里指服務商的appid

? type：分賬接收方類型，枚舉值：

MERCHANT_ID：商戶號（mch_id或者sub_mch_id）

PERSONAL_OPENID：個人openid（由服務商的APPID轉(zhuǎn)換得到）

PERSONAL_SUB_OPENID：個人sub_openid（由品牌主的APPID轉(zhuǎn)換得到）

? account：分賬接收方賬號

分賬接收方類型為：MERCHANT_ID時，分賬接收方賬號為商戶號（mch_id或者sub_mch_id）

分賬接收方類型為：PERSONAL_OPENID時，分賬接收方賬號為個人openid

分賬接收方類型為：PESONAL_SUB_OPENID時，分賬接收方賬號為個人sub_openid

注意：

更多參數(shù)、響應詳情及錯誤碼請參見刪除分賬接收方接口文檔

4. 常見問題

Q：分賬調(diào)用“請求分賬接口”返回“非分賬訂單不支持分賬”

A：請按照以下幾點檢查：

1. 微信訂單號填寫錯誤

2. 下單的時候未傳分賬標識（profit_sharing）的訂單，是沒有分賬權(quán)限的

Q：分賬調(diào)用“請求分賬接口”返回“分賬金額不足”

A：請按照以下幾點檢查：

1. 該訂單已全額退款，沒有資金可以分賬

2. 已經(jīng)調(diào)用過“請求單次分賬”，訂單剩余的待分賬金額已經(jīng)解凍，已無分賬資金

2. 超過訂單可分賬金額或者該訂單已無可分賬金額，請檢查確認

Q：分賬調(diào)用“請求分賬接口”返回“訂單處理中，暫時無法分賬，請稍后再試”

A：請按照以下幾點檢查：

1. 請在訂單支付成功1分鐘后再調(diào)用分賬接口

2. 未結(jié)算的訂單，請在結(jié)算后再調(diào)用分賬接口請求分賬

3. 老資金流商戶的訂單，不支持分賬

4. 商戶開通了收支分離但手續(xù)費賬戶余額不足（手續(xù)費賬戶最低余額要求是100元以上，在充值手續(xù)費賬戶1小時后，訂單會正常結(jié)算，即可正常調(diào)用分賬接口）

Q：分賬調(diào)用“請求分賬接口”返回“分賬接收商戶全稱不匹配”

A：請按照以下幾點檢查：

1. 分賬接收商戶全稱填寫錯誤，請?zhí)顚懻_的商戶全稱

2. 接口需要使用UTF-8編碼

Q：分賬調(diào)用“添加分賬接收方接口”返回“系統(tǒng)繁忙，請稍后重試”

A：receiver中的參數(shù)account錯誤，參數(shù)account的規(guī)則如下：

1. 類型是MERCHANT_ID時，是商戶ID

2. 類型是PERSONAL_OPENID時，是個人openid

3. 類型是PERSONAL_SUB_OPENID時，是個人sub_openid

4. APPID與mchid不匹配也會報該錯誤，請檢查確認

5. 簽名類型錯誤，分賬接口簽名類型目前只支持HMAC-SHA256

CONTENT
1.接口規(guī)則
2. 開發(fā)準備
2.1. 搭建和配置開發(fā)環(huán)境
2.2. 業(yè)務開發(fā)配置
3.快速接入
3.1. 業(yè)務流程圖
3.2. API接入（含示例代碼）
4. 常見問題

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

微信支付合作伙伴平臺

連鎖品牌分賬開發(fā)指引

1. 接口規(guī)則

2. 開發(fā)準備

2.1. 搭建和配置開發(fā)環(huán)境

2.2. 業(yè)務開發(fā)配置

2.2.1. 服務商開通連鎖品牌工具箱

2.2.2. 設(shè)置分賬比例

3. 快速接入

3.1. 業(yè)務流程圖

業(yè)務流程時序圖：

3.2. API接入（含示例代碼）

3.2.1. 【服務端】請求分賬

3.2.2. 【服務端】查詢分賬結(jié)果

3.2.3.【服務端】分賬動賬通知

3.2.4. 【服務端】請求分賬回退

3.2.5. 【服務端】查詢分賬回退結(jié)果

3.2.6. 【服務端】完結(jié)分賬

3.2.7. 【服務端】查詢訂單剩余待分金額

3.2.8. 【服務端】查詢最大分賬比例

3.2.9. 【服務端】添加分賬接收方

3.2.10. 【服務端】 刪除分賬接收方

4. 常見問題

Q：分賬調(diào)用“請求分賬接口”返回“非分賬訂單不支持分賬”

Q：分賬調(diào)用“請求分賬接口”返回“分賬金額不足”

Q：分賬調(diào)用“請求分賬接口”返回“訂單處理中，暫時無法分賬，請稍后再試”

Q：分賬調(diào)用“請求分賬接口”返回“分賬接收商戶全稱不匹配”

Q：分賬調(diào)用“添加分賬接收方接口”返回“系統(tǒng)繁忙，請稍后重試”

3.2.10. 【服務端】刪除分賬接收方