3.2.3 统一交易通知

正式环境

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...

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

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

请求参数

Body 参数application/json必填

示例

{
    "code": "string",
    "msg": "string",
    "appId": "string",
    "signType": "string",
    "timestamp": 0,
    "sign": "string",
    "data": {
        "channelCode": "string",
        "channelFeeAmount": "string",
        "channelFeeRate": "string",
        "channelOrderNo": "string",
        "description": "string",
        "failCode": "string",
        "failReason": "string",
        "feeAmount": "string",
        "feeRate": "string",
        "instOrderNo": "string",
        "mchOrderNo": "string",
        "orderAmount": 0,
        "payAmount": "string",
        "payDataType": "string",
        "payOrderNo": "string",
        "paySubType": "string",
        "productCode": "string",
        "providerCode": "string",
        "sceneType": "string",
        "state": "string",
        "clearStatus": "string",
        "IsMpFund": "string",
        "subject": "string",
        "successTime": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com商户异步预留地址' \
--header 'Content-Type: application/json' \
--data '{
    "code": "string",
    "msg": "string",
    "appId": "string",
    "signType": "string",
    "timestamp": 0,
    "sign": "string",
    "data": {
        "channelCode": "string",
        "channelFeeAmount": "string",
        "channelFeeRate": "string",
        "channelOrderNo": "string",
        "description": "string",
        "failCode": "string",
        "failReason": "string",
        "feeAmount": "string",
        "feeRate": "string",
        "instOrderNo": "string",
        "mchOrderNo": "string",
        "orderAmount": 0,
        "payAmount": "string",
        "payDataType": "string",
        "payOrderNo": "string",
        "paySubType": "string",
        "productCode": "string",
        "providerCode": "string",
        "sceneType": "string",
        "state": "string",
        "clearStatus": "string",
        "IsMpFund": "string",
        "subject": "string",
        "successTime": "string"
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "请求成功",
    "appId": "APP_01837598935",
    "timestamp": 1763032803472,
    "signType": "RSA2",
    "sign": "L65ZH+txNYc4B5Wgut6J2KFNOTvhTEkvDFAaEx9jJn1N7HrQLbr/XMPBg7DbqhVZkDfFYTa5k2PWwcLVrzyp8XNY5mWbc/IE+UhPADyMqIq31Z655FXjUc+MJLaL0jpCZ8YEFTC3tuPSVZf0Lq5Mpn0diNYZ9h9vGoBe5o+p57prMSL8qN1yEJ7Rz4W+PQyoGKRO/GXuK9YEXJv48dYwb/L4LpSxXMAc3ZavuxZLoW+MO1t5e7LNkQ774M07W2/q0HCbcw407kuz2VTKfnzx/fniETb3inWDLnbfhSqRIcdZ/ze9UB/9qsIQRJqnakT49mecu215ci400xip9RpzUA==",
    "data": "{\"mchOrderNo\":\"ORDER_176224427901367477\",\"payOrderNo\":\"P202511071854557982201\",\"channelOrderNo\":\"4200002855202511073458020438\",\"instOrderNo\":\"2013202511073148401882100003\",\"payDataType\":null,\"state\":3,\"failCode\":null,\"failReason\":null,\"orderAmount\":\"0.01\",\"payAmount\":\"0.01\",\"productCode\":\"WeChat-PAY\",\"paySubType\":\"NATIVE\",\"sceneType\":1,\"providerCode\":\"S001525885414\",\"channelCode\":\"yeepay\",\"feeAmount\":null,\"feeRate\":null,\"channelFeeAmount\":\"0.00\",\"channelFeeRate\":\"[{\\\"rateType\\\":\\\"SINGLE_PERCENT\\\",\\\"percentRate\\\":0.38}]\",\"subject\":\"测试\",\"description\":\"测试\",\"successTime\":1762512939000}"
}

3.2.2 统一交易查询

3.2.4 统一退款接口