分账接收方变更

正式环境

https://openapi.3ypay.com

POST

/mchShare/nonMch/modify/mchCard

申请修改非收单商户的结算卡信息（开户行、银行卡号、结算周期等）。

调用前提： 商户入网报备已完成（reportStatus=3）。

业务规则：

mchModifyId 为商户自定义变更单号，需全局唯一

mchFundSn（商户进件单号）与 fundSn（平台进件单号）二选一必填，用于定位待变更的进件记录

变更申请为异步流程，需通过「商户变更查询」接口轮询审核状态

提交后旧结算信息仍有效，审核通过后才切换至新结算信息

请求参数

Body 参数application/json必填

示例

{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101003",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "mchModifyId": "MCH_MODIFY_20250101001",
        "mchFundSn": "MCH_FUND_20250101001",
        "fundSn": "",
        "notifyUrl": "https://example.com/notify",
        "mchCard": {
            "bankCode": "01040000",
            "bankName": "中国银行",
            "bankProvinceCode": "110000",
            "bankCityCode": "110100",
            "branchCode": "104100000004",
            "bankCardName": "张三",
            "bankCardNo": "6222021234567890456",
            "bankCardPhone": "13800138001",
            "bankCardUrl": "https://oss.example.com/bank_card_new.jpg",
            "settlementType": "T1",
            "shareAuthUrl": "https://oss.example.com/share_auth.pdf",
            "settlementMode": "AUTO",
            "settlementTime": ""
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/mchShare/nonMch/modify/mchCard' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101003",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "mchModifyId": "MCH_MODIFY_20250101001",
        "mchFundSn": "MCH_FUND_20250101001",
        "fundSn": "",
        "notifyUrl": "https://example.com/notify",
        "mchCard": {
            "bankCode": "01040000",
            "bankName": "中国银行",
            "bankProvinceCode": "110000",
            "bankCityCode": "110100",
            "branchCode": "104100000004",
            "bankCardName": "张三",
            "bankCardNo": "6222021234567890456",
            "bankCardPhone": "13800138001",
            "bankCardUrl": "https://oss.example.com/bank_card_new.jpg",
            "settlementType": "T1",
            "shareAuthUrl": "https://oss.example.com/share_auth.pdf",
            "settlementMode": "AUTO",
            "settlementTime": ""
        }
    }
}'

返回响应

🟢200

application/json

变更申请提交成功，返回变更单号

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "请求成功",
    "appId": "APP20250101001",
    "signType": "RSA2",
    "timestamp": 1700000001000,
    "data": {
        "mchFundSn": "MCH_FUND_20250101001",
        "fundSn": "FUND20250101001",
        "mchModifyId": "MCH_MODIFY_20250101001",
        "modifyId": "MODIFY20250101001",
        "msg": "变更申请已提交，请等待审核"
    }
}

🟠400

分账接收方查询

分账变更查询