10.1.3 提现结果通知

正式环境

https://openapi.3ypay.com

POST

/callback/withdrawal/notify

分账提现完成后，平台主动向商户 notifyUrl 推送提现结果通知。

触发条件：

提现状态变为最终状态：3=已提现或 7=提现失败

商户在提现申请时提供了 notifyUrl

同一笔提现仅通知一次

通知机制：

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

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

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

商户处理要求：

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

使用 serialNo 或 mchSerialNo 进行幂等处理

请求参数

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/callback/withdrawal/notify' \
--header 'Content-Type: application/json' \
--data '{
    "code": 0,
    "msg": "SUCCESS",
    "appId": "APP20250101001",
    "subSn": "MCH20250101001",
    "timestamp": 1700000001000,
    "signType": "RSA2",
    "sign": "base64encodedSignature==",
    "data": {
        "sn": "MCH20250101001",
        "appChannelSn": "AC20250101001",
        "accountNo": "RECV_ACCOUNT_001",
        "serialNo": "SN20250101000001",
        "mchSerialNo": "WD_20250101000001",
        "amount": 100,
        "fee": 1,
        "remark": "服务费提现",
        "status": 3,
        "date": "2025-01-01",
        "successTime": 1700000060000,
        "failCode": "",
        "failMsg": "",
        "notifyUrl": "https://example.com/notify/withdrawal"
    }
}'

返回响应

🟢200

商户收到通知后返回 HTTP 200 表示接收成功

该响应没有 Body

10.1.2 分账提现查询

AI智能路由指引-内测