6.2.3 余额分账退款

正式环境

https://openapi.3ypay.com

POST

/mchShare/balance/refund

对已完成余额分账的批次发起退款，将分账资金从接收方退回至付款方账户余额。

调用前提： 分账批次须已完成分账（status=3）。

业务规则：

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

mchRefundOrderNo 为商户自定义退款订单号，需全局唯一，长度 18～64 字符

acctInfos 退款明细列表至少包含 1 条记录，accOrderNo（分账明细单号）和 amount 为必填

退款为异步流程，提交后需通过「余额退款查询」接口轮询 refundStatus 确认最终状态

请求参数

Body 参数application/json必填

示例

{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101003",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "batchNo": "1000000000001",
        "mchBatchNo": "",
        "mchRefundOrderNo": "BAL_REFUND_20250101000001",
        "notifyUrl": "https://example.com/notify/refund",
        "acctInfos": [
            {
                "accOrderNo": "ACC_ORDER_001",
                "amount": 100,
                "description": "余额分账退款"
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/mchShare/balance/refund' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101003",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "batchNo": "1000000000001",
        "mchBatchNo": "",
        "mchRefundOrderNo": "BAL_REFUND_20250101000001",
        "notifyUrl": "https://example.com/notify/refund",
        "acctInfos": [
            {
                "accOrderNo": "ACC_ORDER_001",
                "amount": 100,
                "description": "余额分账退款"
            }
        ]
    }
}'

返回响应

🟢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": 0,
                "failMsg": "",
                "successTime": null
            }
        ]
    }
}

🟠400

6.2.2 余额分账查询

6.2.4 余额退款查询