Chargeback Alert Notifications

• Endpoint: POST /chargebackAlertNotifyUrl
• Tags: Risk

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
code	string	Yes	maxLength: 64	Return code, ‘APPLY_ SUCCESS’ stands for success
msg	string	Yes	maxLength: 256	Response description, ‘Success.’
data	object	Yes		Case information
data.outTradeNo	string	Yes	maxLength: 64	Merchant order number
data.outUserId	string	Yes	maxLength: 64	User ID
data.tradeToken	string	Yes	maxLength: 64	Payermax trade token
data.tradeCountry	string	Yes	maxLength: 3	Trade country
data.tradeAmount	string	Yes	maxLength: 20	Trade Amount
data.tradeCurrency	string	Yes	maxLength: 3	Trade Currency
data.tradeFinishTime	string	Yes	maxLength: 32	Trade Finish Time
data.alertOrderNo	string	Yes	maxLength: 64	Chargeback Alert Order No
data.alertTime	string	Yes	maxLength: 32	Alert Time
data.alertType	string	Yes	maxLength: 32	Alert Type
data.alertFeeAmount	string	Yes	maxLength: 20	Alert Fee Amount
data.alertFeeCurrency	string	Yes	maxLength: 3	Alert Fee Currency
data.alertTaxAmount	string	Yes	maxLength: 20	Alert Tax Amount
data.alertTaxCurrency	string	Yes	maxLength: 3	Alert Tax Currency
data.alertReasonCode	string	Yes	maxLength: 256	Alert Reason Code
data.alertReasonType	string	Yes	maxLength: 32	Alert Reason Type
data.refundRequired	string	Yes	maxLength: 1	Refund Required
data.refundType	string	Yes	maxLength: 20	Refund Type
notifyTime	string	Yes	maxLength: 32	Notify Time
version	string	Yes		API version. Current value: 1.0
keyVersion	string	Yes		Signature Algorithm Version, Current value: 1
requestTime	string	Yes		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		Merchant AppId，The unique identifier assigned to the merchant app by PayerMax
merchantNo	string	No	maxLength: 32	Merchant Id, the unique identifier generated when the merchant signs the contract with PayerMax

Example

{
  "appId": "6666c8b036a24579974497c2f9a11111",
  "code": "APPLY_SUCCESS",
  "data": {
    "outTradeNo": "20181112112606266846",
    "outUserId": "ZNW3e",
    "tradeToken": "T2024062702289232000001",
    "tradeCountry": "IN",
    "tradeAmount": 10,
    "tradeCurrency": "INR",
    "tradeFinishTime": "2022-01-22T10:00:00.500+08:00",
    "alertOrderNo": "CBW20250804071254841817458108",
    "alertTime": "2022-01-22T10:00:00.500+08:00",
    "alertType": "RDR",
    "alertFeeAmount": 10,
    "alertFeeCurrency": "USD",
    "alertTaxAmount": 0,
    "alertTaxCurrency": "USD",
    "alertReasonCode": "13.1",
    "alertReasonType": "dispute",
    "refundRequired": "Y",
    "refundType": "platform"
  },
  "keyVersion": "1",
  "merchantNo": "020213834542382",
  "msg": "Success.",
  "notifyTime": "2023-10-09T05:52:42.159Z",
  "version": "1.0"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
code	string	Yes		Return code, ‘APPLY_SUCCESS’ means success
msg	string	Yes		Return message, ‘Success.’