争议集成

1. 配置回调地址

需先登录商户平台（MMC），进入 设置服务 → 开发参数 完成回调地址配置。

2. 争议通知

当PayerMax收到上游争议通知，会向商户配置的回调地址发送通知，商户也可主动查询获取争议状态。

案件状态如下：

状态	描述
DISPUTE_INQUIRY	调单待反馈：等待商户反馈并回复举证材料
DISPUTE_RECEIVED	举证材料已接收
DISPUTE_END	调单完成：发卡行审核申诉并作出判定
CASE_CLOSED	已结案
CASE_CANCEL	案件已取消

争议通知/chargeBaclNotifyUrl API 接口请求示例：

curl --request POST \
  --url https://pay-gate-uat.payermax.com/chargeBaclNotifyUrl \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'sign: FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A==' \
  --data '{
  "appId": "6666c8b036a24579974497c2f9a11111",
  "code": "APPLY_SUCCESS",
  "data": {
    "fee": "564.47",
    "channelOrderNo": "TPC25414916781601399492036086",
    "batchId": "",
    "outUserId": "useroutTradeNo1678160134430",
    "tradeCreateTime": "2023-03-07T03:35:33.000Z",
    "caseId": "O20230412074414033194005231",
    "outTradeNo": "outTradeNo1678160134430",
    "currency": "PHP",
    "tradeToken": "T2023081604639602348121",
    "tradeCountry": "PH",
    "expirationDate": "2023-04-12",
    "amount": "20000.00",
    "retrievalDate": "2023-04-12",
    "payFinishTime": "2023-03-07T03:35:48.000Z",
    "caseResult": "WIN",
    "tradeCurrency": "PHP",
    "cardOrg": "",
    "productDesc": "this is subject",
    "targetOrg": "GRABPAY",
    "totalAmount": "20564.47",
    "tradeAmount": "20000.00",
    "paymentMethodType": "WALLET",
    "status": "CASE_CLOSED",
    "reasonCode": "4842",
    "reasonMessage": "Late Presentment",
    "originTradeAmount": "20000.00",
    "originTradeCurrency": "PHP"
  },
  "keyVersion": "1",
  "merchantNo": "020213834542382",
  "msg": "Success.",
  "notifyTime": "2023-10-09T05:52:42.159Z",
  "notifyType": "DISPUTE",
  "version": "1.4"
}'

争议通知/chargeBaclNotifyUrl API接口响应示例：

{
  "code": "SUCCESS",
  "msg": "Success"
}

3. 争议回复

争议回复/caseReplay API 接口请求示例：

curl --request POST \
  --url https://pay-gate-uat.payermax.com/aggregate-pay/api/gateway/caseReplay \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'sign: FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A==' \
  --data '{
  "version": "1.4",
  "keyVersion": "1",
  "requestTime": "{{requestTime}}",
  "appId": "127d5de5b5124d11b9132c6ec9cc61d3",
  "merchantNo": "010113864671194",
  "spMerchantNo": "",
  "data": {
    "batchId": "",
    "caseId": "O20230608124011368140006803",
    "outUserId": "uft_user_1686228003452",
    "responseContent": "测试文件地址",
    "representmentFile": [
      "https://xxx/img/image/public/imgcopyright_index1.jpg"
    ]
  }
}'

争议回复/caseReplay API 接口响应示例：

{
  "data": {
    "successCaseIds": [
      "string"
    ],
    "failCaseIds": [
      "string"
    ]
  },
  "code": "string",
  "msg": "string"
}

4. 争议查询

争议查询/caseSearch API 接口请求示例：

curl --request POST \
  --url https://pay-gate-uat.payermax.com/aggregate-pay/api/gateway/caseSearch \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'sign: FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A==' \
  --data '{
  "version": "1.5",
  "keyVersion": "1",
  "requestTime": "2023-04-13T06:31:52.000Z",
  "appId": "54a5e69376734010982c1602c88e00ff",
  "spMerchantNo": "",
  "merchantNo": "SP100860372",
  "data": {
    "caseId": "O20230103065545916437107761"
  }
}'

争议查询/caseSearch API 接口响应示例：

{
  "msg": "Success.",
  "code": "APPLY_SUCCESS",
  "data": {
    "amount": "5000.00",
    "retrievalDate": "2023-02-13",
    "fee": "5000.00",
    "caseResult": "WIN",
    "batchId": "",
    "outUserId": "10042",
    "tradeCreateTime": "2023-01-03T06:32:52.000Z",
    "totalAmount": "10000.00",
    "caseId": "O20230103065545916437107761",
    "outTradeNo": "dev-RenshTest1672727570986",
    "currency": "IDR",
    "tradeToken": "T2023081604639602348121",
    "status": "DISPUTE_INQUIRY",
    "expirationDate": "2023-02-14",
    "originTradeAmount": "5000.00",
    "originTradeCurrency": "IDR"
  }
}