Category links

API Links

Dispute Resolution

The dispute resolution process allows a dispute decision to be marked in the CoreCard system. The card processor can resolve a dispute in the cases of the cardholder agreeing to the charge during the investigation or a card network closing the dispute resolution process. In any case, the CoreCard system has an API to mark a dispute as resolved in favor of the cardholder or merchant based on an analysis and assessment of the transaction in question.

Dispute Resolution

Action: POST

Endpoint: /api/CoreCredit/Dispute/DisputeResolution

POST /api/CoreCredit/Dispute/DisputeResolution

Use this API to perform dispute resolutions (i.e.,  in favor of the cardholder, in favor of the merchant, rebill, write-off), dispute reversals, dispute re-openings, and dispute resolution reversals. Additionally, dispute resolution appropriate reasons may be selected and memos may be created for the same.

Request fields detail
Fields Description

Source

string

Source of API Consumer For external system expected sources will be WEB.

Allowable Values:

50

IPAddress

string

Optional

IP Address of Client / Application Hosting Server Example: 10.206.0.204

Allowable Values:

15

DateFormat

string

Optional

Place Holder for Future Use. Values are: 1 : MM/dd/yyyy HH:MM:SS (Default) 2 : MM/dd/yy HH:MM:SS 3 : dd/MM/yyyy HH:MM:SS

Allowable Values:

25

CurrencyCode

string

Optional

Place Holder for Future Use. Currency Code Ex. 840 = US Doller.

Allowable Values:

10

CurrencySymbolType

string

Optional

Place Holder for Future Use. CurrencySymbolType: 1: Currency Sign like $ 2: 3 ALPHA Currency Code like USD

Allowable Values:

10

Language

string

Optional

Place Holder for Future Use. Language: en: means use English Default: en - English

Allowable Values:

10

ExternalIP

string

IP Address of end user of API

Allowable Values:

50

SessionID

string

Optional

Session identifier of the API Example: 000028;026;1349906692

Allowable Values:

100

APIVersion

string

Version of the API to be invoked. Example: 2.0 API Version Current Version 2.0

Allowable Values:

10

CallerID

string

Optional

Caller ID of source from where API is initiated it is End User Caller ID Example: 7204454214 (phone number applicable in Case of IVR)

Allowable Values:

20

CalledID

string

Optional

Called ID of destination for which API is initiated It is Destination Called ID Example: 7314145404 (phone number applicable in Case of IVR)

Allowable Values:

20

RequestTime

datetime

Optional

Request Date Time of API Format: MM/dd/yyyy HH:mm:ss Example:01/15/2020 10:05:23

AccountNumber

string

Mandatory

Card Holder's Account number. Valid Values: 0-9 Format: XXXXXXXXXXXXXXXX Example: 8000000000000037

Allowable Values:

19

TransactionID

int64

Mandatory

Transaction Number for transaction being posted. Valid Values: 0-9 Example: 23654789

DisputeAction

integer

Mandatory

Action on Dispute Transaction. Valid Values: 0-9 Example: 0 - Initiate Chargeback

DisputeReason

string

Mandatory

Reason through which Dispute resolution needs to take place. Valid Values: 0-9 Example: 7 - Duplicate Processing

DisputeResolveAmount

decimal

Optional

Amount for which Dispute need to resolve. Valid Values: 0-9 Format: XX.XX Example: 10.50

MemoReason

string

Optional

Reason of Memo Text. Valid Values: 0-9, A-Z Example: Disputed Transaction

Allowable Values:

50

MemoText

string

Optional

Text of the Memo. Valid Values:0-9, a-z, special characters Format: XXXXXXXXXXXXXX Example: New Transaction posted.

Allowable Values:

100

Sample request body
{
  "Source": "Web",
  "IPAddress": "10.120.0.1",
  "DateFormat": null,
  "CurrencyCode": null,
  "CurrencySymbolType": null,
  "Language": null,
  "ExternalIP": "10.120.0.0",
  "SessionID": null,
  "APIVersion": "2.0",
  "CallerID": null,
  "CalledID": null,
  "RequestTime": null,
  "AccountNumber": "8110000000000026",
  "TransactionID": 123372036854843936,
  "DisputeAction": 3,
  "DisputeReason": "7",
  "DisputeResolveAmount": 53.21,
  "MemoReason": null,
  "MemoText": "some comments"
}
Response fields detail
Fields Description

DisputeAmount

decimal

The amount for which the Dispute is raised on the Transaction. Valid Values:0-9 Format: XXX.XX Example: 20.00

DisputeTranID

int64

Disputed Transaction ID. Valid Values: 0-9 Format: XXXXXXX Example:9856198

CaseID

int64

ID which is generated against the Dispute request. Valid Values: 0-9 Format: XXXXXXX Example:9856198

FraudTypeCode

string

Defines the Fraud Type Code prescribed for SAFE Reporting to Mastercard in the SAFE Reporting Guide. Valid Values:Refer Appendix Example: 06

Allowable Values:

5

SubFraudTypeCode

string

Defines the Sub Fraud Type Code prescribed for SAFE Reporting to Mastercard in the SAFE Reporting Guide Valid Values:Refer Appendix Example: K

Allowable Values:

5

Sample response body

{
  "application/json": {
    "Message": "Dispute Resolved Successfully",
    "Status": true,
    "ErrorCode": "ERR01016",
    "ResponseData": {
      "DisputeAmount": 53.21,
      "DisputeTranID": 123372036854863811,
      "CaseID": 123456,
      "FraudTypeCode": null,
      "SubFraudTypeCode": null
    }
  }
}