6.2.2 余额分账查询

正式环境

https://openapi.3ypay.com

POST

/mchShare/balance/shareQuery

根据分账批次号或商户分账订单号查询余额分账处理状态及明细结果。

调用前提： 需已提交余额分账申请。

业务规则：

batchNo（分账批次号）与 mchBatchNo（商户分账订单号）二选一必填

通过 acctInfos 中每条明细的 status 字段判断分账进度：1=待分账，2=分账中，3=已分账，5=订单关闭，7=分账失败

分账失败时可查看 failMsg 了解失败原因

请求参数

Body 参数application/json必填

示例

{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101002",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "batchNo": "1000000000001",
        "mchBatchNo": ""
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/mchShare/balance/shareQuery' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101002",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "batchNo": "1000000000001",
        "mchBatchNo": ""
    }
}'

返回响应

🟢200

application/json

查询成功，返回余额分账批次信息及明细状态

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "请求成功",
    "appId": "APP20250101001",
    "signType": "RSA2",
    "timestamp": 1700000001000,
    "data": {
        "mchBatchNo": "BAL_BATCH_20250101000001",
        "batchNo": "1000000000001",
        "accountNo": "PAY_ACCOUNT_001",
        "appChannelSn": "AC20250101001",
        "acctInfos": [
            {
                "accOrderNo": "ACC_ORDER_001",
                "accountNo": "RECV_ACCOUNT_001",
                "amount": 100,
                "description": "余额分账-服务费",
                "feeRate": 0,
                "isRtc": 0,
                "status": 3,
                "failMsg": "",
                "successTime": 1700000060000
            }
        ]
    }
}

🟠400

6.2.1 余额分账申请

6.2.3 余额分账退款