入网报备通知

分账接收方入网报备完成后，平台主动向商户 notifyUrl 推送报备结果通知。

触发条件：

报备状态变为最终状态：3=报备完成或 99=驳回

商户在录入时提供了 notifyUrl

同一笔报备仅通知一次

通知机制：

通知方式：HTTP POST，Content-Type: application/json

重试策略：失败后最多重试 20 次，采用延迟递增策略

签名验证：商户收到通知后应使用平台公钥验证 RSA2 签名

商户处理要求：

收到通知后立即返回 HTTP 200 状态码

使用 requestId 或 mchFundSn 进行幂等处理

请求参数

Body 参数application/json必填

示例

{
    "code": 0,
    "msg": "SUCCESS",
    "appId": "APP20250101001",
    "timestamp": 1700000000000,
    "signType": "RSA2",
    "sign": "base64encodedSignature==",
    "data": {
        "requestId": "REQ20250101001",
        "mchFundSn": "MCH_FUND_20250101001",
        "fundSn": "FUND20250101001",
        "sn": "MCH20250101001",
        "appChannelSn": "AC20250101001",
        "type": 1,
        "shortName": "测试商户",
        "remark": "个人分账接收方入网",
        "notifyUrl": "https://example.com/notify",
        "reportStatus": 3,
        "failMsg": "",
        "mchCert": {
            "certName": "张三",
            "certCardId": "110101199001011234",
            "certFrontUrl": "https://oss.example.com/cert_front.jpg",
            "certBackUrl": "https://oss.example.com/cert_back.jpg",
            "certValidityType": 0,
            "certBeginDate": "2020-01-01",
            "certEndDate": "2030-01-01",
            "certPhone": "13800138000",
            "certEmail": "zhangsan@example.com",
            "certAddress": "北京市东城区XX路XX号",
            "contactName": "张三",
            "contactPhone": "13800138000",
            "contactCardId": "110101199001011234",
            "contactEmail": "zhangsan@example.com"
        },
        "mchCard": {
            "bankCode": "01040000",
            "bankName": "中国银行",
            "bankProvinceCode": "110000",
            "bankCityCode": "110100",
            "branchCode": "104100000004",
            "bankCardName": "张三",
            "bankCardNo": "6222021234567890123",
            "bankCardPhone": "13800138000",
            "bankCardUrl": "https://oss.example.com/bank_card.jpg",
            "accType": 1,
            "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/callback/nonMch/access/notify' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": 0,
    "msg": "SUCCESS",
    "appId": "APP20250101001",
    "timestamp": 1700000000000,
    "signType": "RSA2",
    "sign": "base64encodedSignature==",
    "data": {
        "requestId": "REQ20250101001",
        "mchFundSn": "MCH_FUND_20250101001",
        "fundSn": "FUND20250101001",
        "sn": "MCH20250101001",
        "appChannelSn": "AC20250101001",
        "type": 1,
        "shortName": "测试商户",
        "remark": "个人分账接收方入网",
        "notifyUrl": "https://example.com/notify",
        "reportStatus": 3,
        "failMsg": "",
        "mchCert": {
            "certName": "张三",
            "certCardId": "110101199001011234",
            "certFrontUrl": "https://oss.example.com/cert_front.jpg",
            "certBackUrl": "https://oss.example.com/cert_back.jpg",
            "certValidityType": 0,
            "certBeginDate": "2020-01-01",
            "certEndDate": "2030-01-01",
            "certPhone": "13800138000",
            "certEmail": "zhangsan@example.com",
            "certAddress": "北京市东城区XX路XX号",
            "contactName": "张三",
            "contactPhone": "13800138000",
            "contactCardId": "110101199001011234",
            "contactEmail": "zhangsan@example.com"
        },
        "mchCard": {
            "bankCode": "01040000",
            "bankName": "中国银行",
            "bankProvinceCode": "110000",
            "bankCityCode": "110100",
            "branchCode": "104100000004",
            "bankCardName": "张三",
            "bankCardNo": "6222021234567890123",
            "bankCardPhone": "13800138000",
            "bankCardUrl": "https://oss.example.com/bank_card.jpg",
            "accType": 1,
            "settlementType": "T1",
            "shareAuthUrl": "https://oss.example.com/share_auth.pdf",
            "settlementMode": "AUTO",
            "settlementTime": ""
        }
    }
}'

请求参数

请求示例代码

返回响应