GET//
Retrieve a specific dispute case.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | The token of the dispute case to retrieve. Allowable Values: 36 char max |
Query parameter
| Fields | Description |
|---|---|
| expand string Optional | If the regulation_type field is set to REG_E, adds the regulation_details fields inside dispute_details in the response. For more information, see The regulation_details object.Allowable Values: regulation_details |
Response body
| Fields | Description |
|---|---|
| token string Returned | The unique identifier of the dispute case. Allowable Values: 36 char max |
| type string Returned | The type of case. Allowable Values: DISPUTE |
| memo string Returned | Free-form comments about the dispute. Allowable Values: 512 char max |
| program_short_code string Returned | Indicates what program the case belongs to. Allowable Values: 10 char max |
| user_token string Returned | Token that identifies the user that made the original transaction. Allowable Values: 36 char max |
| business_token string Returned | The token of the business involved in the dispute case. Allowable Values: 36 char max |
| state string Returned | Indicates the current case state. Allowable Values: OPEN, OPEN_WITH_ACTION_REQUIRED, READY, CHARGEBACK_INITIATED, CLOSED |
| assignee string Returned | Indicates who is working on the case. This is updated by the case transition endpoint with reason code 22 and ASSIGN action.Allowable Values: 255 char max |
| zendesk_ticket_id string Optional | ID for the Zendesk ticket. Allowable Values: 255 char max |
| type_change_time datetime Optional | When the type was changed. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ |
| dispute_details object Returned | The details of the dispute case. Allowable Values: See The dispute details response object. |
| created_time datetime Returned | The time when the dispute case was created. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ |
| updated_time datetime Returned | The time when the dispute case was last updated. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ |
JSON
{
"count": 0,
"start_index": 0,
"end_index": 0,
"is_more": true,
"data": [
{
"token": "string",
"type": "DISPUTE",
"memo": "string",
"program_short_code": "string",
"user_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"business_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"state": "OPEN",
"assignee": "string",
"dispute_details": {
"original_transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"original_transaction_type": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"dispute_amount": 0,
"dispute_amount_change_reason": "MERCHANT_ISSUED_PARTIAL_REFUND",
"currency_code": "string",
"dispute_reason": "SERVICE_NOT_PROVIDED_MERCHANDISE_NOT_RECEIVED",
"dispute_state": "INITIATED",
"chargeback_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"network": "VISA",
"network_case_number": "string",
"acquirer_fee": 0,
"associated_transaction_selection_required": true,
"card_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"network_failure_response": "string",
"processing_error_type_dispute_details": {
"late_presentment_details": {
"account_status": "ACCOUNT_CLOSED"
},
"incorrect_transaction_code_details": {
"how_is_transaction_code_incorrect": "CREDIT_INSTEAD_OF_REVERSAL_OR_ADJUSTMENT",
"explain_why_the_credit_refund_was_processed_in_error": "string"
},
"incorrect_currency_details": {
"incorrect_currency_reason": "CURRENCY_DIFFERENCE",
"what_was_the_correct_currency": 0,
"certification_that_the_cardholder_did_not_agree_to_dynamic_currency_conversion_and_did_not_make_an_active_choice": "string"
},
"incorrect_account_number_details": {
"is_the_account_number_on_the_issuers_master_file": true,
"does_the_account_number_on_the_receipt_match_the_cardholders_account_number_or_token": true
},
"incorrect_transaction_amount_details": {
"what_is_the_amount_on_the_cardholders_receipt": 0,
"what_is_the_currency_on_the_cardholders_receipt": "string"
}
},
"consumer_dispute_type_dispute_details": {
"service_not_provided_merchandise_not_received_details": {
"detailed_description_of_what_was_purchased_and_explanation_of_the_dispute": "string",
"expected_receipt_date": "2022-03-21",
"expected_receipt_time": "2022-03-21",
"did_cardholder_cancel_prior_to_the_expected_date": true,
"cancellation_date": "2022-03-21",
"cancellation_reason": "string",
"did_cardholder_attempt_to_resolve_dispute_with_merchant": true,
"is_attempt_to_resolve_prohibited_by_local_law_or_regulations": true,
"provide_details_of_local_law_or_regulations": "string",
"merchandise_or_services": "MERCHANDISE SERVICES",
"was_merchandise_delivered_to_wrong_location": true,
"address_of_agreed_location": "string",
"did_cardholder_return_merchandise": true,
"date_cardholder_returned_merchandise": "2022-03-21",
"date_merchant_received_returned_merchandise": "2022-03-21",
"did_cardholder_attempt_to_return_merchandise": true,
"date_of_attempted_return": "2022-03-21",
"explain_how_merchandise_was_returned": "string",
"third_party_gift_card_indicator": true,
"visa_commercial_card_virtual_account_indicator": true,
"did_virtual_account_holder_suffer_financial_loss": true,
"did_merchant_cancel_services": true,
"date_merchant_cancelled_services": "2022-03-21",
"explanation_dispute_prior_expected_delivery_date": "string"
},
"cancelled_recurring_transaction_details": {
"cancellation_date": "2022-03-21",
"cancellation_reason": "string",
"date_issuer_informed_merchant_of_account_closure": "2022-03-21"
},
"not_as_described_or_defective_merchandise_details": {
"not_as_described_or_defective": "NOT_AS_DESCRIBED DEFECTIVE",
"merchandise_or_services": "MERCHANDISE SERVICES",
"date_the_cardholder_first_notified_the_issuer_of_the_dispute": "2022-03-21",
"did_the_cardholder_attempt_to_resolve_the_dispute_with_the_merchant": true,
"is_attempt_to_resolve_prohibited_by_local_law_or_regulations": true,
"provide_details_of_local_law_or_regulations": "string",
"did_the_cardholder_return_the_merchandise": true,
"date_cardholder_returned_the_merchandise": "2022-03-21",
"date_merchant_received_the_returned_merchandise": "2022-03-21",
"return_method": "FACE_TO_FACE",
"tracking_number": "string",
"date_of_attempted_return": "2022-03-21",
"provide_a_detailed_description_of_how_the_cardholder_attempted_to_return_and_the_disposition_of_the_merchandise": "string",
"did_the_cardholder_attempt_to_return_the_merchandise": true,
"explain_how_the_merchandise_was_returned": "string",
"cardholder_merchant_previous_negotiation_evidence": true,
"explain_prev_negotiation": "string",
"when_negotiations_begin": "2022-03-21",
"date_merchandise_or_service_was_received": "2022-03-21",
"does_the_dispute_involve_merchandise_or_services_provided_that_do_not_match_the_merchants_verbal_description": true,
"did_the_merchandise_or_services_differ_from_what_was_described_on_the_receipt": true,
"provide_details_of_what_was_ordered_and_not_as_described": "string",
"did_the_cardholder_cancel_the_services": true,
"cancellation_date": "2022-03-21",
"cancellation_reason": "string",
"what_was_ordered_and_how_it_was_damaged_or_defective": "string",
"date_merchandise_was_received": "2022-03-21"
},
"credit_not_processed_details": {
"was_a_credit_voucher_voided_transaction_receipt_or_refund_acknowledgement_given": true,
"is_the_credit_voucher_transaction_receipt_or_refund_acknowledgement_dated": true,
"credit_voucher_transaction_receipt_or_refund_acknowledgement_date": "2022-03-21",
"date_cardholder_returned_cancelled_merchandise": "string"
},
"cancelled_merchandise_or_services_details": {
"merchandise_or_services": "MERCHANDISE SERVICE",
"describe_what_was_purchased": "string",
"date_cardholder_received_or_expected_to_receive_merchandise": "2022-03-21",
"did_the_cardholder_attempt_to_resolve_the_dispute_with_the_merchant": true,
"is_attempt_to_resolve_prohibited_by_local_law_or_regulations": true,
"provide_details_of_local_law_or_regulations": "string",
"did_the_cardholder_return_the_merchandise": true,
"date_of_return": "2022-03-21",
"date_merchant_received_returned_merchandise": "2022-03-21",
"return_method": "FACE_TO_FACE",
"tracking_number": "string",
"explain_how_the_merchandise_was_returned": "string",
"did_the_cardholder_attempt_to_return_the_merchandise": true,
"date_of_attempted_return": "2022-03-21",
"detailed_description_of_how_the_cardholder_attempted_to_return_and_the_disposition_of_the_merchandise": "2022-03-21",
"did_cardholder_cancel": true,
"cancellation_date": "2022-03-21",
"cancellation_reason": "string",
"was_cancellation_policy_provided": true,
"type_of_service": "TIMESHARE",
"date_of_service_or_expected_service": "2022-03-21",
"cancelled_guaranteed_reservation_certification_selection": "string"
}
},
"fraud_dispute_type_details": {
"general_fraud_type_dispute_details": {
"chip_on_card": true
}
},
"network_case_status_details": {
"network": "VISA",
"network_case_number": "string",
"case_status": "string",
"current_case_amount": 0,
"next_actor": "ISSUER",
"days_to_act": 0,
"last_action_date": "2022-03-21T15:46:20.825Z",
"case_opened_date": "2022-03-21",
"last_refresh_date": "2022-03-21T15:46:20.825Z",
"allowable_actions": [
"SUBMIT"
]
},
"fraud_category_type_dispute_details": {
"fraud_report_details": {
"fraud_type": "LOST",
"fraud_type_code": "string",
"fraud_report_id": 0,
"fraud_type_category": "string"
}
}
},
"created_time": "2022-03-21T15:46:20.825Z",
"updated_time": "2022-03-21T15:46:20.825Z"
}
]
}