8.1.7 进件状态通知

正式环境

https://openapi.3ypay.com

POST

/callback/access/status/notify

进件状态变更时,平台主动向商户notifyUrl推送进件结果通知。

触发条件:

进件状态变更为:3=人工审核、4=渠道审核、5=渠道签约、6=业务配置、7=审核完成、99=审核驳回

商户在进件申请时提供了notifyUrl

通知机制:

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

重试策略:失败后最多重试18次,采用延迟递增策略

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

商户处理要求:

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

使用accessSn进行幂等处理

不要在回调中执行耗时操作

请求参数

Body 参数application/json必填

示例

{
    "code": 200,
    "msg": "请求成功",
    "appId": "APP20250101001",
    "subSn": "",
    "timestamp": 1700000001000,
    "signType": "RSA2",
    "sign": "base64encodedSignature==",
    "data": {
        "accessSn": "ACCESS20250101001",
        "mchAccessNo": "MCH_ACCESS_20250101001",
        "providerCode": "PROVIDER001",
        "channelCode": "CHANNEL001",
        "name": "XX科技有限公司",
        "shortName": "XX科技",
        "contactName": "张三",
        "contactPhone": "13800138000",
        "contactEmail": "zhangsan@example.com",
        "status": 7,
        "subMchId": "SUB_MCH_001",
        "requestId": "REQ20250101001",
        "message": "",
        "signLink": ""
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/callback/access/status/notify' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": 200,
    "msg": "请求成功",
    "appId": "APP20250101001",
    "subSn": "",
    "timestamp": 1700000001000,
    "signType": "RSA2",
    "sign": "base64encodedSignature==",
    "data": {
        "accessSn": "ACCESS20250101001",
        "mchAccessNo": "MCH_ACCESS_20250101001",
        "providerCode": "PROVIDER001",
        "channelCode": "CHANNEL001",
        "name": "XX科技有限公司",
        "shortName": "XX科技",
        "contactName": "张三",
        "contactPhone": "13800138000",
        "contactEmail": "zhangsan@example.com",
        "status": 7,
        "subMchId": "SUB_MCH_001",
        "requestId": "REQ20250101001",
        "message": "",
        "signLink": ""
    }
}'

返回响应

🟢200

application/json

商户接收成功

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "success"
}

8.1.6 商户信息变更查询

8.1.8 变更状态通知