10.2.4 异步通知

正式环境

https://openapi.3ypay.com

POST

商户异步预留地址

触发条件：代付成功，且下单时异步通知地址不为空。

当贵司接收到我司异步通知后请返回http状态码为200，其他状态码系统将判定为通知失败，将会触发重复通知队列，重复通知最大通知次数为20次。

异步推送间隔：1s 5s 10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m 20m 30m 1h 2h...

重要注意事项：我司有权对通知次数进行变更，请注意处理。

返回的应答或通知消息后续会升级而增加返回参数（返回参数参与签名），验证应答签名时务必允许这种情况。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "code": "string",
    "msg": "string",
    "appId": "string",
    "signType": "string",
    "timestamp": 0,
    "sign": "string",
    "data": {
        "appChannelSn": "string",
        "payoutNo": "string",
        "mchPayoutNo": "string",
        "insOrderNo": "string",
        "amount": 0,
        "feeCharge": 0,
        "channelFeeAmount": 0,
        "channelFeeRate": "string",
        "feeRate": "string",
        "description": "string",
        "attach": "string",
        "receiveType": "string",
        "bankAccountType": 0,
        "bankCardNo": "string",
        "bankCardName": "string",
        "bankCardPhone": "string",
        "bankCode": "string",
        "branchCode": "string",
        "clientIp": "string",
        "status": 0,
        "clearStatus": 0,
        "cancelStatus": 0,
        "cancelReason": "string",
        "failCode": "string",
        "failMsg": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com商户异步预留地址' \
--header 'x-cluster: {{x-cluster}}' \
--header 'Cookie: lToken={{lToken}};tToken={{tToken}};3yToken={{3yToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "code": "string",
    "msg": "string",
    "appId": "string",
    "signType": "string",
    "timestamp": 0,
    "sign": "string",
    "data": {
        "appChannelSn": "string",
        "payoutNo": "string",
        "mchPayoutNo": "string",
        "insOrderNo": "string",
        "amount": 0,
        "feeCharge": 0,
        "channelFeeAmount": 0,
        "channelFeeRate": "string",
        "feeRate": "string",
        "description": "string",
        "attach": "string",
        "receiveType": "string",
        "bankAccountType": 0,
        "bankCardNo": "string",
        "bankCardName": "string",
        "bankCardPhone": "string",
        "bankCode": "string",
        "branchCode": "string",
        "clientIp": "string",
        "status": 0,
        "clearStatus": 0,
        "cancelStatus": 0,
        "cancelReason": "string",
        "failCode": "string",
        "failMsg": "string"
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "请求成功",
    "appId": "APP_01534244437",
    "sign": "R+l5KJTX+06uJaJZIj/MYux+v2eLoCZgQX98EDYY7SIMPAGY/HX+9/iZLwHZVHT9h+zIGnAakMqz0afffE3EYVMPqe4f+kSGYGNdZg/WecVJObEJs2TkD9B2Cvdrd3ua46STNkU89wWlBcOuyiqcmMW/i/s1pzZBIUvD04ctmPWdchoMl//pcsIT6xeJBI8uI2c6ad3GbYLem0QP+r3gE23IlAIzfJoWlacY5D82rUAIvFtqR7AiopxrST1rUwXbie0bDwzZQ7m7Idr/fAjJ8Ez8Y9vMY4DxD2Wwn0GahUgGv411V9hNI0ybEcEHAQmt7KQ2q80lmPwNQ4s9pH80JQ==",
    "timestamp": 1781776220892,
    "signType": "RSA2",
    "data": "{\"appChannelSn\":\"AC...\",\"payoutNo\":\"PU20260618...\",\"mchPayoutNo\":\"MER_...\",\"insOrderNo\":\"20260...49f4a\",\"amount\":0.01,\"channelFeeAmount\":1,\"channelFeeRate\":\"[{\\\"feeType\\\":\\\"FIXED_MIX_PERCENT\\\",\\\"fixedRate\\\":1,\\\"rateBase\\\":0.03}]\",\"subject\":\"测试\",\"receiveType\":\"D0\",\"bankAccountType\":1,\"bankCardNo\":\"6214...170...81\",\"bankCardName\":\"刘xx\",\"bankCardPhone\":\"1998...\",\"branchCode\":\"30858...\",\"clientIp\":\"114.216.66.152\",\"status\":3,\"successTime\":1781776220993,\"failCode\":\"\",\"failMsg\":\"\"}"
}

10.2.3.代付撤销

AI智能路由指引-内测