6.2.4 余额退款查询

正式环境

https://openapi.3ypay.com

POST

/mchShare/balance/refundQuery

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

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

业务规则：

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

可通过 mchRefundOrderNo 进一步精确查询指定退款单

通过 acctInfos 中每条明细的 refundStatus 字段判断退款进度：0=处理中，1=成功，2=失败

退款失败时可查看 failMsg 了解失败原因

请求参数

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200

application/json

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

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "请求成功",
    "appId": "APP20250101001",
    "signType": "RSA2",
    "timestamp": 1700000001000,
    "data": {
        "mchBatchNo": "BAL_BATCH_20250101000001",
        "batchNo": "1000000000001",
        "mchRefundOrderNo": "BAL_REFUND_20250101000001",
        "acctInfos": [
            {
                "accOrderNo": "ACC_ORDER_001",
                "accountNo": "RECV_ACCOUNT_001",
                "amount": 100,
                "description": "余额分账退款",
                "refundStatus": 1,
                "failMsg": "",
                "successTime": 1700000120000
            }
        ]
    }
}

🟠400

6.2.3 余额分账退款

6.2.5 余额分账异步通知