10.1.1 分账提现申请

正式环境

https://openapi.3ypay.com

POST

/mchShare/withdrawal/commit

对分账接收方账号发起提现申请，将分账接收的资金提现到对应的结算卡。

调用前提： 接入方需提前获取平台分配的 appId，完成 RSA2 密钥配置；分账接收方须已完成分账关系绑定并完成入网报备。

业务规则：

mchSerialNo 为商户自定义提现单号，需全局唯一，长度不超过 64 字符

accountNo 为分账接收方的渠道账号，资金从该账号提现

amount 为提现金额，单位为元，不能小于 0

提现为异步流程，提交后需通过「分账提现查询」接口轮询 status 确认最终状态，或等待提现结果异步通知

请求参数

Body 参数application/json必填

示例

{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101001",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "mchSerialNo": "WD_20250101000001",
        "accountNo": "RECV_ACCOUNT_001",
        "amount": 100,
        "remark": "服务费提现",
        "notifyUrl": "https://example.com/notify/withdrawal"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/mchShare/withdrawal/commit' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101001",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "mchSerialNo": "WD_20250101000001",
        "accountNo": "RECV_ACCOUNT_001",
        "amount": 100,
        "remark": "服务费提现",
        "notifyUrl": "https://example.com/notify/withdrawal"
    }
}'

返回响应

🟢200

application/json

提现申请提交成功，返回提现单信息及当前状态

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "请求成功",
    "appId": "APP20250101001",
    "signType": "RSA2",
    "timestamp": 1700000001000,
    "sign": "base64encodedSignature==",
    "data": {
        "sn": "MCH20250101001",
        "appChannelSn": "AC20250101001",
        "accountNo": "RECV_ACCOUNT_001",
        "serialNo": "SN20250101000001",
        "mchSerialNo": "WD_20250101000001",
        "amount": 100,
        "fee": 0,
        "remark": "服务费提现",
        "status": 1,
        "date": "2025-01-01",
        "successTime": null,
        "failCode": "",
        "failMsg": "",
        "notifyUrl": "https://example.com/notify/withdrawal"
    }
}

🟠400

结算变更通知

10.1.2 分账提现查询