Dispute and Chargeback

Create a new Dispute and Chargeback request

Request
Security:
path Parameters
version
required
string
Request Body schema: application/json
dispute_guid
string or null <uuid>

Unique Id for the dispute, Mandatory if the dispute is already created

channel_dispute_id
string or null

Dispute ID from the service provider.

channel_user_guid
string or null <uuid>

User ID of the service provider’s user initiating the request

person_guid
string or null <uuid>

Unique Id for the customer

account_guid
string or null <uuid>

Unique Id for the account

card_number
string or null

Either Card number or card proxy must be provided

card_proxy
string or null

Unique Id for the card

request_code
required
string non-empty

Type of Request. Possible values 'NT-DISP_NEW', 'NT-DISP_UPD_AMT', 'NT-DISP_UPD'

required
object (DisputeReqDTO)
Responses
200

Success

400

Bad request

401

Unauthorized

404

Account not found

500

Server Error

post/api/{version}/disputes/dispute-chargeback
Request samples
application/json
{
  • "dispute_guid": "bfc3e3a6-0732-4184-983e-86eabde0c755",
  • "channel_dispute_id": "string",
  • "channel_user_guid": "35315278-8e02-48bb-a552-2308af308789",
  • "person_guid": "2ae6ba4b-f6c0-4817-a158-43e5a87168fd",
  • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
  • "card_number": "string",
  • "card_proxy": "string",
  • "request_code": "string",
  • "dispute": {
    • "dispute_status": "string",
    • "dispute_type": "string",
    • "dispute_reason": "string",
    • "notes": "string",
    • "documents": [
      • {
        • "name": "string",
        • "content": "string"
        }
      ],
    • "transaction_details": [
      • {
        • "transaction_guid": "f05e8168-ef44-4cd9-b75f-f45ec3331540",
        • "transaction_dispute_status": "string",
        • "transaction_channel_dispute_status": "string",
        • "data_nav_case_number": "string",
        • "amount": 0,
        • "channel": "DISCOVER",
        • "journal_entry": "string",
        • "apply_amount_details": {
          • "entry_type": "PROVISIONAL",
          • "txn_type": "CREDIT",
          • "amount": 0,
          • "reason_code": "string"
          },
        • "chargeback_log": {
          • "filing_status": "string",
          • "chargeback_level": "string",
          • "reason_code": "string"
          }
        }
      ]
    }
}
Response samples
application/json
{
  • "dispute_guid": "bfc3e3a6-0732-4184-983e-86eabde0c755",
  • "person_guid": "2ae6ba4b-f6c0-4817-a158-43e5a87168fd",
  • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
  • "card_proxy": "string",
  • "request_code": "string",
  • "dispute": {
    • "dispute_date": "2019-08-24T14:15:22Z",
    • "dispute_status": "string",
    • "dispute_type": "string",
    • "dispute_reason": "string",
    • "notes": "string",
    • "documents": [
      • {
        • "name": "string",
        • "content": "string"
        }
      ],
    • "transaction_details": [
      • {
        • "transaction_guid": "f05e8168-ef44-4cd9-b75f-f45ec3331540",
        • "transaction_dispute_status": "string",
        • "transaction_channel_dispute_status": "string",
        • "data_nav_case_number": "string",
        • "amount": 0,
        • "channel": "string",
        • "fee": [
          • {
            • "transaction_guid": "f05e8168-ef44-4cd9-b75f-f45ec3331540",
            • "amount": 0,
            • "description": "string"
            }
          ],
        • "apply_amount_details": {
          • "entry_type": "string",
          • "amount_date": "2019-08-24T14:15:22Z",
          • "amount": 0
          },
        • "chargeback_log": {
          • "chargeback_level": "string",
          • "reason_code": "string",
          • "chargeback_date": "2019-08-24T14:15:22Z",
          • "filing_status": "string"
          }
        }
      ]
    },
  • "journal_detail": {
    • "journal_guid": "019b8be6-224f-4e54-91ec-2a471754d334",
    • "journal_date": "2019-08-24T14:15:22Z",
    • "reason_code": "string",
    • "journal_entry": "string",
    • "journal_source": "string",
    • "source_user_guid": "0aaedba8-146e-40a6-ad5f-54c512699647",
    • "case_number": "string"
    }
}
Copyright © 2023 KeyBank & Qolo. All rights reserved.