Proactively Retrieve Chargeback/Dispute Details

About 152 wordsLess than 1 minute

View as Markdown

2025-04-23

Request Body Parameters

application/json

Common Request Parameters

bizContent

eventDateStartString(256)Required
Query the start and end time of the event, in the format yyyy-MM-dd HH:mm:ss
eventDateEndString(256)Required
Query the start and end time of the event, in the format yyyy-MM-dd HH:mm:ss
eventCodeStringConditional
Query event type. Required for dispute query, optional for chargeback query
disputePspReferenceString(256)Optional
Chargeback number
chargebackStatusString(256)Optional
Chargeback status
pageNumintRequired
Page number
pageSizeintRequired
Number of rows, with a maximum limit of 1000

请求报文示例

{
  "accId": "2023042011040310224447",
  "bizContent": {
    "eventDateStart": "2025-03-01 00:00:00",
    "eventDateEnd": "2025-03-08 23:00:00",
    "ChargebackStatus": "",
    "pageSize": 2,
    "pageNum": 1,
    "disputePspReference": ""
  },
  "clientId": "2023042011040310224",
  "sign": "CBB392D4997A37C7221F886650E2A6FCB063ABA2148979C7A0E97132BEDFB9DE",
  "signType": "SHA256",
  "version": "1.0"
}

Responses Body Parameters

application/json

Common Response Parameters

bizContent

detailListarrayRequired

响应报文示例

{
  "accId": "2023042011040310224447",
  "bizContent": {
    "detailList": [
      {
        "originalReference": "2025030750121281",
        "chargebackReasonCode": "4849",
        "amount": "5.000000",
        "chargebackStatus": "PENDING",
        "disputePspReference": "202503070723235029",
        "defensePeriodEndsAt": "2025-03-18 06:00:00",
        "defendable": true,
        "accId": "2023042011040310224447",
        "currency": "USD",
        "chargebackSchemeCode": "Mastercard",
        "merchantReference": "PMT-IHJN1B6F8M1741332134207",
        "eventDate": "2025-03-07 07:23:23"
      },
      {
        "originalReference": "2025030450120449",
        "chargebackReasonCode": "11.1",
        "amount": "5.000000",
        "chargebackStatus": "PENDING",
        "disputePspReference": "202503040225095028",
        "defensePeriodEndsAt": "2025-03-17 06:00:00",
        "defendable": true,
        "accId": "2023042011040310224447",
        "currency": "USD",
        "chargebackSchemeCode": "VISA",
        "merchantReference": "BI01202503040221336123549CR54964455",
        "eventDate": "2025-03-04 02:25:10"
      }
    ]
  },
  "clientId": "2023042011040310224",
  "code": "000000",
  "description": "Success",
  "sign": "FA7B4C67F4C3DD8D90B1FE4F8E45FEC3E2E2F7DB67168CDC40FC164342FD398F",
  "signType": "SHA256"
}