Fraud Notifications

• Endpoint: POST /fraudNotifyUrl
• Tags: Risk

Description

Fraud notification interface, used to notify merchants of fraudulent transactions, which can be used by merchants to manage fraudulent transactions or users.

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	API version. Current value: 1.4
keyVersion	string	Yes	maxLength: 8	Signature Algorithm Version, Current value: 1
notifyTime	string	Yes	maxLength: 32	Request time, compliant with rfc3339 specification, format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX The time must be within two minutes of the current time
appId	string	Yes	maxLength: 64	Merchant AppId，The unique identifier assigned to the merchant app by PayerMax
merchantNo	string	Yes	maxLength: 64	Merchant Id, the unique identifier generated when the merchant signs the contract with PayerMax
data	object	Yes
data.merchantNo	string	Yes	maxLength: 64	Merchant ID unique identification number
data.outUserId	string	Yes	maxLength: 64	Merchant user unique ID
data.receiveDate	string	Yes	maxLength: 32	Fraud case acceptance time
data.tradeAmount	string	Yes	maxLength: 20	Original transaction amount
data.tradeCreateTime	string	Yes	maxLength: 32	Original transaction creation time
data.tradeCurrency	string	Yes	maxLength: 3	Original transaction currency
data.outTradeNo	string	Yes	maxLength: 64	Merchant order number
requestTime	string	Yes	maxLength: 32	Request time, in accordance with rfc3339 specification, format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX Time must be within two minutes of the current time
spMerchantNo	string	No	maxLength: 64	Platform merchant number, not required for non-platform merchants
notifyType	string	Yes	maxLength: 16	Notification type, the current default value is FRAUD, which means user fraud notification
code	string	Yes	maxLength: 64	Notification code, example: APPLY_SUCCESS
msg	string	Yes	maxLength: 256	Notification msg, example: Success.

Example

{
  "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",
    "outTradeNo": "12344545"
  },
  "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		Return code, ‘SUCCESS’ means success
msg	string	Yes		Return message, ‘Success’