风控欺诈通知
- Endpoint:
POST /fraudNotifyUrl - Tags: 风控
Description
欺诈通知接口，用于通知商户产生了欺诈的交易，可用于商户自己对于欺诈交易或用户做风险管理
Parameters
| Field | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
Content-Type | header | string | Yes | ||
sign | header | string | Yes | 签名信息请参考技术文档 |
Parameter Examples
Content-Type:"application/json"sign:"FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="
Request Body
Content-Type: application/json
| Field | Type | Required | Constraints | Description | Enum |
|---|---|---|---|---|---|
version | string | Yes | maxLength: 8 | 接口版本 当前值为：1.0 | |
keyVersion | string | Yes | maxLength: 8 | 密钥版本 当前值为：1 | |
notifyTime | string | Yes | maxLength: 32 | 通知时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 | |
appId | string | Yes | maxLength: 64 | 商户应用Id，PayerMax分配给商户应用的唯一标识 | |
merchantNo | string | No | maxLength: 32 | 商户号，商户与PayerMax业务签约时生成的唯一标识 | |
data | object | Yes | |||
data.merchantNo | string | Yes | maxLength: 32 | 商户号唯一标识编号 | |
data.outTradeNo | string | Yes | maxLength: 64 | 商户订单号 | |
data.tradeAmount | string | Yes | maxLength: 20 | 原交易金额 | |
data.tradeCurrency | string | Yes | maxLength: 3 | 原交易币种 | |
data.tradeCreateTime | string | Yes | maxLength: 32 | 原交易创建时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 | |
data.receiveDate | string | No | maxLength: 32 | 欺诈接收时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 | |
data.outUserId | string | Yes | maxLength: 64 | 商户外部用户唯一标识 | |
requestTime | string | Yes | maxLength: 32 | 请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 | |
spMerchantNo | string | No | maxLength: 32 | 平台商户号，非平台商户无需关注 | |
notifyType | string | No | maxLength: 16 | 通知类型 ，当前默认值 FRAUD, 即指用户欺诈类通知 | |
code | string | Yes | maxLength: 64 | 通知code，示例：APPLY_SUCCESS | |
msg | string | Yes | maxLength: 256 | 通知msg，示例：Success. |
Example
json
{
"appId": "486c52f2a774420f8116ce5373a938a1",
"code": "APPLY_SUCCESS",
"data": {
"merchantNo": "P010101145234",
"outUserId": "28167857",
"receiveDate": "2024-10-29T20:39:28.925+08:00",
"tradeAmount": "30.5900",
"tradeCreateTime": "2024-10-29T20:39:28.925+08:00",
"tradeCurrency": "EGP"
},
"keyVersion": "1",
"merchantNo": "P01010114547935",
"msg": "Success.",
"notifyTime": "2024-10-29T20:39:28.925+08:00",
"notifyType": "FRAUD",
"spMerchantNo": "",
"version": "1.0"
}Responses
200
| Field | Type | Required | Constraints | Description | Enum |
|---|---|---|---|---|---|
code | string | Yes | 返回码，’SUCCESS’代表成功 | ||
msg | string | Yes | 返回描述，’Success’ |