--- title: "Create a Card Dispute" method: POST path: "/card_disputes" --- # Create a Card Dispute `POST /card_disputes` ## Request body - CreateACardDisputeParameters - `amount` integer — The monetary amount of the part of the transaction that is being disputed. This is optional and will default to the full amount of the transaction if not provided. If provided, the amount must be less than or equal to the amount of the transaction. - `attachment_files` object[] — The files to be attached to the initial dispute submission. - `file_id` string, required — The ID of the file to be attached. The file must have a `purpose` of `card_dispute_attachment`. - `disputed_transaction_id` string, required — The Transaction you wish to dispute. This Transaction must have a `source_type` of `card_settlement`. - `explanation` string — The free-form explanation provided to Increase to provide more context for the user submission. This field is not sent directly to the card networks. - `network` 'visa', required — The network of the disputed transaction. Details specific to the network are required under the sub-object with the same identifier as the network. - `visa` object — The Visa-specific parameters for the dispute. Required if and only if `network` is `visa`. - `authorization` object — Authorization. Required if and only if `category` is `authorization`. - `account_status` 'account_closed' | 'credit_problem' | 'fraud', required — Account status. - `category` 'authorization' | 'consumer_canceled_merchandise' | 'consumer_canceled_recurring_transaction' | 'consumer_canceled_services' | 'consumer_counterfeit_merchandise' | 'consumer_credit_not_processed' | 'consumer_damaged_or_defective_merchandise' | 'consumer_merchandise_misrepresentation' | 'consumer_merchandise_not_as_described' | 'consumer_merchandise_not_received' | 'consumer_non_receipt_of_cash' | 'consumer_original_credit_transaction_not_accepted' | 'consumer_quality_merchandise' | 'consumer_quality_services' | 'consumer_services_misrepresentation' | 'consumer_services_not_as_described' | 'consumer_services_not_received' | 'fraud' | 'processing_error', required — Category. - `consumer_canceled_merchandise` object — Canceled merchandise. Required if and only if `category` is `consumer_canceled_merchandise`. - `cardholder_cancellation` object — Cardholder cancellation. - `canceled_at` string, date, required — Canceled at. - `canceled_prior_to_ship_date` 'canceled_prior_to_ship_date' | 'not_canceled_prior_to_ship_date', required — Canceled prior to ship date. - `cancellation_policy_provided` 'not_provided' | 'provided', required — Cancellation policy provided. - `reason` string, required — Reason. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `not_returned` object — Not returned. Required if and only if `return_outcome` is `not_returned`. - `purchase_explanation` string, required — Purchase explanation. - `received_or_expected_at` string, date, required — Received or expected at. - `return_attempted` object — Return attempted. Required if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object — Returned. Required if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date — Merchant received return at. - `other_explanation` string — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string — Tracking number. - `consumer_canceled_recurring_transaction` object — Canceled recurring transaction. Required if and only if `category` is `consumer_canceled_recurring_transaction`. - `cancellation_target` 'account' | 'transaction', required — Cancellation target. - `merchant_contact_methods` object, required — Merchant contact methods. - `application_name` string — Application name. - `call_center_phone_number` string — Call center phone number. - `email_address` string — Email address. - `in_person_address` string — In person address. - `mailing_address` string — Mailing address. - `text_phone_number` string — Text phone number. - `other_form_of_payment_explanation` string — Other form of payment explanation. - `transaction_or_account_canceled_at` string, date, required — Transaction or account canceled at. - `consumer_canceled_services` object — Canceled services. Required if and only if `category` is `consumer_canceled_services`. - `cardholder_cancellation` object, required — Cardholder cancellation. - `canceled_at` string, date, required — Canceled at. - `cancellation_policy_provided` 'not_provided' | 'provided', required — Cancellation policy provided. - `reason` string, required — Reason. - `contracted_at` string, date, required — Contracted at. - `guaranteed_reservation` object — Guaranteed reservation explanation. Required if and only if `service_type` is `guaranteed_reservation`. - `explanation` 'cardholder_canceled_prior_to_service' | 'cardholder_cancellation_attempt_within_24_hours_of_confirmation' | 'merchant_billed_no_show', required — Explanation. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `other` object — Other service type explanation. Required if and only if `service_type` is `other`. - `purchase_explanation` string, required — Purchase explanation. - `service_type` 'guaranteed_reservation' | 'other' | 'timeshare', required — Service type. - `timeshare` object — Timeshare explanation. Required if and only if `service_type` is `timeshare`. - `consumer_counterfeit_merchandise` object — Counterfeit merchandise. Required if and only if `category` is `consumer_counterfeit_merchandise`. - `counterfeit_explanation` string, required — Counterfeit explanation. - `disposition_explanation` string, required — Disposition explanation. - `order_explanation` string, required — Order explanation. - `received_at` string, date, required — Received at. - `consumer_credit_not_processed` object — Credit not processed. Required if and only if `category` is `consumer_credit_not_processed`. - `canceled_or_returned_at` string, date — Canceled or returned at. - `credit_expected_at` string, date — Credit expected at. - `consumer_damaged_or_defective_merchandise` object — Damaged or defective merchandise. Required if and only if `category` is `consumer_damaged_or_defective_merchandise`. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `not_returned` object — Not returned. Required if and only if `return_outcome` is `not_returned`. - `order_and_issue_explanation` string, required — Order and issue explanation. - `received_at` string, date, required — Received at. - `return_attempted` object — Return attempted. Required if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object — Returned. Required if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date — Merchant received return at. - `other_explanation` string — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string — Tracking number. - `consumer_merchandise_misrepresentation` object — Merchandise misrepresentation. Required if and only if `category` is `consumer_merchandise_misrepresentation`. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `misrepresentation_explanation` string, required — Misrepresentation explanation. - `not_returned` object — Not returned. Required if and only if `return_outcome` is `not_returned`. - `purchase_explanation` string, required — Purchase explanation. - `received_at` string, date, required — Received at. - `return_attempted` object — Return attempted. Required if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object — Returned. Required if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date — Merchant received return at. - `other_explanation` string — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string — Tracking number. - `consumer_merchandise_not_as_described` object — Merchandise not as described. Required if and only if `category` is `consumer_merchandise_not_as_described`. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `received_at` string, date, required — Received at. - `return_attempted` object — Return attempted. Required if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'returned' | 'return_attempted', required — Return outcome. - `returned` object — Returned. Required if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date — Merchant received return at. - `other_explanation` string — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string — Tracking number. - `consumer_merchandise_not_received` object — Merchandise not received. Required if and only if `category` is `consumer_merchandise_not_received`. - `cancellation_outcome` 'cardholder_cancellation_prior_to_expected_receipt' | 'merchant_cancellation' | 'no_cancellation', required — Cancellation outcome. - `cardholder_cancellation_prior_to_expected_receipt` object — Cardholder cancellation prior to expected receipt. Required if and only if `cancellation_outcome` is `cardholder_cancellation_prior_to_expected_receipt`. - `canceled_at` string, date, required — Canceled at. - `reason` string — Reason. - `delayed` object — Delayed. Required if and only if `delivery_issue` is `delayed`. - `explanation` string, required — Explanation. - `not_returned` object — Not returned. Required if and only if `return_outcome` is `not_returned`. - `return_attempted` object — Return attempted. Required if and only if `return_outcome` is `return_attempted`. - `attempted_at` string, date, required — Attempted at. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object — Returned. Required if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date, required — Merchant received return at. - `returned_at` string, date, required — Returned at. - `delivered_to_wrong_location` object — Delivered to wrong location. Required if and only if `delivery_issue` is `delivered_to_wrong_location`. - `agreed_location` string, required — Agreed location. - `delivery_issue` 'delayed' | 'delivered_to_wrong_location', required — Delivery issue. - `last_expected_receipt_at` string, date, required — Last expected receipt at. - `merchant_cancellation` object — Merchant cancellation. Required if and only if `cancellation_outcome` is `merchant_cancellation`. - `canceled_at` string, date, required — Canceled at. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `no_cancellation` object — No cancellation. Required if and only if `cancellation_outcome` is `no_cancellation`. - `purchase_info_and_explanation` string, required — Purchase information and explanation. - `consumer_non_receipt_of_cash` object — Non-receipt of cash. Required if and only if `category` is `consumer_non_receipt_of_cash`. - `consumer_original_credit_transaction_not_accepted` object — Original Credit Transaction (OCT) not accepted. Required if and only if `category` is `consumer_original_credit_transaction_not_accepted`. - `explanation` string, required — Explanation. - `reason` 'prohibited_by_local_laws_or_regulation' | 'recipient_refused', required — Reason. - `consumer_quality_merchandise` object — Merchandise quality issue. Required if and only if `category` is `consumer_quality_merchandise`. - `expected_at` string, date, required — Expected at. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `not_returned` object — Not returned. Required if and only if `return_outcome` is `not_returned`. - `ongoing_negotiations` object — Ongoing negotiations. Exclude if there is no evidence of ongoing negotiations. - `explanation` string, required — Explanation of the previous ongoing negotiations between the cardholder and merchant. - `issuer_first_notified_at` string, date, required — Date the cardholder first notified the issuer of the dispute. - `started_at` string, date, required — Started at. - `purchase_info_and_quality_issue` string, required — Purchase information and quality issue. - `received_at` string, date, required — Received at. - `return_attempted` object — Return attempted. Required if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object — Returned. Required if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date — Merchant received return at. - `other_explanation` string — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string — Tracking number. - `consumer_quality_services` object — Services quality issue. Required if and only if `category` is `consumer_quality_services`. - `cardholder_cancellation` object, required — Cardholder cancellation. - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant. - `canceled_at` string, date, required — Canceled at. - `reason` string, required — Reason. - `cardholder_paid_to_have_work_redone` 'did_not_pay_to_have_work_redone' | 'paid_to_have_work_redone' — Cardholder paid to have work redone. - `non_fiat_currency_or_non_fungible_token_related_and_not_matching_description` 'not_related' | 'related', required — Non-fiat currency or non-fungible token related and not matching description. - `ongoing_negotiations` object — Ongoing negotiations. Exclude if there is no evidence of ongoing negotiations. - `explanation` string, required — Explanation of the previous ongoing negotiations between the cardholder and merchant. - `issuer_first_notified_at` string, date, required — Date the cardholder first notified the issuer of the dispute. - `started_at` string, date, required — Started at. - `purchase_info_and_quality_issue` string, required — Purchase information and quality issue. - `restaurant_food_related` 'not_related' | 'related' — Whether the dispute is related to the quality of food from an eating place or restaurant. Must be provided when Merchant Category Code (MCC) is 5812, 5813 or 5814. - `services_received_at` string, date, required — Services received at. - `consumer_services_misrepresentation` object — Services misrepresentation. Required if and only if `category` is `consumer_services_misrepresentation`. - `cardholder_cancellation` object, required — Cardholder cancellation. - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant. - `canceled_at` string, date, required — Canceled at. - `reason` string, required — Reason. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `misrepresentation_explanation` string, required — Misrepresentation explanation. - `purchase_explanation` string, required — Purchase explanation. - `received_at` string, date, required — Received at. - `consumer_services_not_as_described` object — Services not as described. Required if and only if `category` is `consumer_services_not_as_described`. - `cardholder_cancellation` object, required — Cardholder cancellation. - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant. - `canceled_at` string, date, required — Canceled at. - `reason` string, required — Reason. - `explanation` string, required — Explanation of what was ordered and was not as described. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `received_at` string, date, required — Received at. - `consumer_services_not_received` object — Services not received. Required if and only if `category` is `consumer_services_not_received`. - `cancellation_outcome` 'cardholder_cancellation_prior_to_expected_receipt' | 'merchant_cancellation' | 'no_cancellation', required — Cancellation outcome. - `cardholder_cancellation_prior_to_expected_receipt` object — Cardholder cancellation prior to expected receipt. Required if and only if `cancellation_outcome` is `cardholder_cancellation_prior_to_expected_receipt`. - `canceled_at` string, date, required — Canceled at. - `reason` string — Reason. - `last_expected_receipt_at` string, date, required — Last expected receipt at. - `merchant_cancellation` object — Merchant cancellation. Required if and only if `cancellation_outcome` is `merchant_cancellation`. - `canceled_at` string, date, required — Canceled at. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `no_cancellation` object — No cancellation. Required if and only if `cancellation_outcome` is `no_cancellation`. - `purchase_info_and_explanation` string, required — Purchase information and explanation. - `fraud` object — Fraud. Required if and only if `category` is `fraud`. - `fraud_type` 'account_or_credentials_takeover' | 'card_not_received_as_issued' | 'fraudulent_application' | 'fraudulent_use_of_account_number' | 'incorrect_processing' | 'issuer_reported_counterfeit' | 'lost' | 'manipulation_of_account_holder' | 'merchant_misrepresentation' | 'miscellaneous' | 'stolen', required — Fraud type. - `processing_error` object — Processing error. Required if and only if `category` is `processing_error`. - `duplicate_transaction` object — Duplicate transaction. Required if and only if `error_reason` is `duplicate_transaction`. - `other_transaction_id` string, required — Other transaction ID. - `error_reason` 'duplicate_transaction' | 'incorrect_amount' | 'paid_by_other_means', required — Error reason. - `incorrect_amount` object — Incorrect amount. Required if and only if `error_reason` is `incorrect_amount`. - `expected_amount` integer, required — Expected amount. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `paid_by_other_means` object — Paid by other means. Required if and only if `error_reason` is `paid_by_other_means`. - `other_form_of_payment_evidence` 'canceled_check' | 'card_transaction' | 'cash_receipt' | 'other' | 'statement' | 'voucher', required — Other form of payment evidence. - `other_transaction_id` string — Other transaction ID. ## Response `200` Card Dispute - CardDispute — If unauthorized activity occurs on a card, you can create a Card Dispute and we'll work with the card networks to return the funds if appropriate. - `amount` integer, required — The amount of the dispute. - `card_id` string, required — The Card that the Card Dispute is associated with. - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card Dispute was created. - `disputed_transaction_id` string, required — The identifier of the Transaction that was disputed. - `id` string, required — The Card Dispute identifier. - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys). - `loss` object, nullable, required — If the Card Dispute's status is `lost`, this will contain details of the lost dispute. - `lost_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card Dispute was lost. - `reason` 'user_withdrawn' | 'loss', required — The reason the Card Dispute was lost. - `network` 'visa' | 'pulse', required — The network that the Card Dispute is associated with. - `status` 'user_submission_required' | 'pending_user_submission_reviewing' | 'pending_user_submission_submitting' | 'pending_user_withdrawal_submitting' | 'pending_response' | 'lost' | 'won', required — The status of the Card Dispute. - `type` 'card_dispute', required — A constant representing the object's type. For this resource it will always be `card_dispute`. - `user_submission_required_by` string, date-time, nullable, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the user submission is required by. Present only if status is `user_submission_required` and a user submission is required by a certain time. Otherwise, this will be `nil`. - `visa` CardDisputeVisa, required - `network_events` CardDisputeVisaNetworkEvent[], required — The network events for the Card Dispute. - `attachment_files` CardDisputeFileAttachment[], required — The files attached to the Visa Card Dispute User Submission. - `file_id` string, required — The ID of the file attached to the Card Dispute. - `category` 'chargeback_accepted' | 'chargeback_submitted' | 'chargeback_timed_out' | 'merchant_prearbitration_decline_submitted' | 'merchant_prearbitration_received' | 'merchant_prearbitration_timed_out' | 'represented' | 'representment_timed_out' | 'user_prearbitration_accepted' | 'user_prearbitration_declined' | 'user_prearbitration_submitted' | 'user_prearbitration_timed_out' | 'user_withdrawal_submitted', required — The category of the user submission. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully. - `chargeback_accepted` object, nullable — A Card Dispute Chargeback Accepted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `chargeback_accepted`. Contains the details specific to a chargeback accepted Visa Card Dispute Network Event, which represents that a chargeback has been accepted by the merchant. - `chargeback_submitted` object, nullable — A Card Dispute Chargeback Submitted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `chargeback_submitted`. Contains the details specific to a chargeback submitted Visa Card Dispute Network Event, which represents that a chargeback has been submitted to the network. - `chargeback_timed_out` object, nullable — A Card Dispute Chargeback Timed Out Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `chargeback_timed_out`. Contains the details specific to a chargeback timed out Visa Card Dispute Network Event, which represents that the chargeback has timed out in the user's favor. - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Visa Card Dispute Network Event was created. - `dispute_financial_transaction_id` string, nullable, required — The dispute financial transaction that resulted from the network event, if any. - `merchant_prearbitration_decline_submitted` object, nullable — A Card Dispute Merchant Pre-Arbitration Decline Submitted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `merchant_prearbitration_decline_submitted`. Contains the details specific to a merchant prearbitration decline submitted Visa Card Dispute Network Event, which represents that the user has declined the merchant's request for a prearbitration request decision in their favor. - `merchant_prearbitration_received` object, nullable — A Card Dispute Merchant Pre-Arbitration Received Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `merchant_prearbitration_received`. Contains the details specific to a merchant prearbitration received Visa Card Dispute Network Event, which represents that the merchant has issued a prearbitration request in the user's favor. - `cardholder_no_longer_disputes` object, nullable, required — Cardholder no longer disputes details. Present if and only if `reason` is `cardholder_no_longer_disputes`. - `explanation` string, nullable, required — Explanation for why the merchant believes the cardholder no longer disputes the transaction. - `compelling_evidence` object, nullable, required — Compelling evidence details. Present if and only if `reason` is `compelling_evidence`. - `category` 'authorized_signer' | 'delivery' | 'delivery_at_place_of_employment' | 'digital_goods_download' | 'dynamic_currency_conversion_actively_chosen' | 'flight_manifest_and_purchase_itinerary' | 'household_member_signer' | 'legitimate_spend_across_payment_types_for_same_merchandise' | 'merchandise_use' | 'passenger_transport_ticket_use' | 'recurring_transaction_with_binding_contract_or_previous_undisputed_transaction' | 'signed_delivery_or_pickup_form' | 'signed_mail_order_phone_order_form' | 'travel_and_expense_loyalty_transaction' | 'travel_and_expense_subsequent_purchase', required — The category of compelling evidence provided by the merchant. - `explanation` string, nullable, required — Explanation of the compelling evidence provided by the merchant. - `credit_or_reversal_processed` object, nullable, required — Credit or reversal processed details. Present if and only if `reason` is `credit_or_reversal_processed`. - `amount` integer, required — The amount of the credit or reversal in the minor unit of its currency. For dollars, for example, this is cents. - `currency` string, required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the credit or reversal's currency. - `explanation` string, nullable, required — Explanation for why the merchant believes the credit or reversal was processed. - `processed_at` string, date, required — The date the credit or reversal was processed. - `delayed_charge_transaction` object, nullable, required — Delayed charge transaction details. Present if and only if `reason` is `delayed_charge_transaction`. - `explanation` string, nullable, required — Additional details about the delayed charge transaction. - `evidence_of_imprint` object, nullable, required — Evidence of imprint details. Present if and only if `reason` is `evidence_of_imprint`. - `explanation` string, nullable, required — Explanation of the evidence of imprint. - `invalid_dispute` object, nullable, required — Invalid dispute details. Present if and only if `reason` is `invalid_dispute`. - `explanation` string, nullable, required — Explanation for why the dispute is considered invalid by the merchant. - `reason` 'other' | 'special_authorization_procedures_followed', required — The reason a merchant considers the dispute invalid. - `non_fiat_currency_or_non_fungible_token_received` object, nullable, required — Non-fiat currency or non-fungible token received details. Present if and only if `reason` is `non_fiat_currency_or_non_fungible_token_received`. - `blockchain_transaction_hash` string, required — Blockchain transaction hash. - `destination_wallet_address` string, required — Destination wallet address. - `prior_approved_transactions` string, nullable, required — Prior approved transactions. - `prior_undisputed_non_fraud_transactions` object, nullable, required — Prior undisputed non-fraud transactions details. Present if and only if `reason` is `prior_undisputed_non_fraud_transactions`. - `explanation` string, nullable, required — Explanation of the prior undisputed non-fraud transactions provided by the merchant. - `reason` 'cardholder_no_longer_disputes' | 'compelling_evidence' | 'credit_or_reversal_processed' | 'delayed_charge_transaction' | 'evidence_of_imprint' | 'invalid_dispute' | 'non_fiat_currency_or_non_fungible_token_received' | 'prior_undisputed_non_fraud_transactions', required — The reason the merchant re-presented the dispute. - `merchant_prearbitration_timed_out` object, nullable — A Card Dispute Merchant Pre-Arbitration Timed Out Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `merchant_prearbitration_timed_out`. Contains the details specific to a merchant prearbitration timed out Visa Card Dispute Network Event, which represents that the user has timed out responding to the merchant's prearbitration request. - `represented` object, nullable — A Card Dispute Re-presented Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `represented`. Contains the details specific to a re-presented Visa Card Dispute Network Event, which represents that the merchant has declined the user's chargeback and has re-presented the payment. - `cardholder_no_longer_disputes` object, nullable, required — Cardholder no longer disputes details. Present if and only if `reason` is `cardholder_no_longer_disputes`. - `explanation` string, nullable, required — Explanation for why the merchant believes the cardholder no longer disputes the transaction. - `credit_or_reversal_processed` object, nullable, required — Credit or reversal processed details. Present if and only if `reason` is `credit_or_reversal_processed`. - `amount` integer, required — The amount of the credit or reversal in the minor unit of its currency. For dollars, for example, this is cents. - `currency` string, required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the credit or reversal's currency. - `explanation` string, nullable, required — Explanation for why the merchant believes the credit or reversal was processed. - `processed_at` string, date, required — The date the credit or reversal was processed. - `invalid_dispute` object, nullable, required — Invalid dispute details. Present if and only if `reason` is `invalid_dispute`. - `explanation` string, nullable, required — Explanation for why the dispute is considered invalid by the merchant. - `reason` 'automatic_teller_machine_transaction_proof_provided' | 'balance_of_partial_prepayment_not_paid' | 'cardholder_canceled_before_expected_merchandise_receipt_date' | 'cardholder_canceled_before_expected_services_receipt_date' | 'cardholder_canceled_different_date' | 'cardholder_did_not_cancel_according_to_policy' | 'cardholder_received_merchandise' | 'country_code_correct' | 'credit_processed_correctly' | 'currency_correct' | 'dispute_is_for_quality' | 'dispute_is_for_visa_cash_back_transaction_portion' | 'disputed_amount_is_value_added_tax' | 'disputed_amount_is_value_added_tax_no_credit_receipt_provided' | 'limited_return_or_cancellation_policy_properly_disclosed' | 'merchandise_held_at_cardholder_customs_agency' | 'merchandise_matches_description' | 'merchandise_not_counterfeit' | 'merchandise_not_damaged' | 'merchandise_not_defective' | 'merchandise_provided_prior_to_cancellation_date' | 'merchandise_quality_matches_description' | 'merchandise_return_not_attempted' | 'merchant_not_notified_of_closed_account' | 'name_on_flight_manifest_matches_purchase' | 'no_credit_receipt_provided' | 'other' | 'processing_error_incorrect' | 'returned_mechandise_held_at_customs_agency_outside_merchant_country' | 'services_match_description' | 'services_provided_prior_to_cancellation_date' | 'services_used_after_cancellation_date' | 'terms_of_service_not_misrepresented' | 'transaction_code_correct', required — The reason a merchant considers the dispute invalid. - `non_fiat_currency_or_non_fungible_token_as_described` object, nullable, required — Non-fiat currency or non-fungible token as described details. Present if and only if `reason` is `non_fiat_currency_or_non_fungible_token_as_described`. - `non_fiat_currency_or_non_fungible_token_received` object, nullable, required — Non-fiat currency or non-fungible token received details. Present if and only if `reason` is `non_fiat_currency_or_non_fungible_token_received`. - `blockchain_transaction_hash` string, required — Blockchain transaction hash. - `destination_wallet_address` string, required — Destination wallet address. - `prior_approved_transactions` string, nullable, required — Prior approved transactions. - `proof_of_cash_disbursement` object, nullable, required — Proof of cash disbursement details. Present if and only if `reason` is `proof_of_cash_disbursement`. - `explanation` string, nullable, required — Explanation for why the merchant believes the evidence provides proof of cash disbursement. - `reason` 'cardholder_no_longer_disputes' | 'credit_or_reversal_processed' | 'invalid_dispute' | 'non_fiat_currency_or_non_fungible_token_as_described' | 'non_fiat_currency_or_non_fungible_token_received' | 'proof_of_cash_disbursement' | 'reversal_issued', required — The reason the merchant re-presented the dispute. - `reversal_issued` object, nullable, required — Reversal issued by merchant details. Present if and only if `reason` is `reversal_issued`. - `explanation` string, nullable, required — Explanation of the reversal issued by the merchant. - `representment_timed_out` object, nullable — A Card Dispute Re-presentment Timed Out Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `representment_timed_out`. Contains the details specific to a re-presentment time-out Visa Card Dispute Network Event, which represents that the user did not respond to the re-presentment by the merchant within the time limit. - `user_prearbitration_accepted` object, nullable — A Card Dispute User Pre-Arbitration Accepted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration_accepted`. Contains the details specific to a user prearbitration accepted Visa Card Dispute Network Event, which represents that the merchant has accepted the user's prearbitration request in the user's favor. - `user_prearbitration_declined` object, nullable — A Card Dispute User Pre-Arbitration Declined Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration_declined`. Contains the details specific to a user prearbitration declined Visa Card Dispute Network Event, which represents that the merchant has declined the user's prearbitration request. - `user_prearbitration_submitted` object, nullable — A Card Dispute User Pre-Arbitration Submitted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration_submitted`. Contains the details specific to a user prearbitration submitted Visa Card Dispute Network Event, which represents that the user's request for prearbitration has been submitted to the network. - `user_prearbitration_timed_out` object, nullable — A Card Dispute User Pre-Arbitration Timed Out Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration_timed_out`. Contains the details specific to a user prearbitration timed out Visa Card Dispute Network Event, which represents that the merchant has timed out responding to the user's prearbitration request. - `user_withdrawal_submitted` object, nullable — A Card Dispute User Withdrawal Submitted Visa Network Event object. This field will be present in the JSON response if and only if `category` is equal to `user_withdrawal_submitted`. Contains the details specific to a user withdrawal submitted Visa Card Dispute Network Event, which represents that the user's request to withdraw the dispute has been submitted to the network. - `required_user_submission_category` 'chargeback' | 'merchant_prearbitration_decline' | 'user_prearbitration', nullable, required — The category of the currently required user submission if the user wishes to proceed with the dispute. Present if and only if status is `user_submission_required`. Otherwise, this will be `nil`. - `user_submissions` CardDisputeVisaUserSubmission[], required — The user submissions for the Card Dispute. - `accepted_at` string, date-time, nullable, required — The date and time at which the Visa Card Dispute User Submission was reviewed and accepted. - `amount` integer, nullable, required — The amount of the dispute if it is different from the amount of a prior user submission or the disputed transaction. - `attachment_files` CardDisputeFileAttachment[], required — The files attached to the Visa Card Dispute User Submission. - `file_id` string, required — The ID of the file attached to the Card Dispute. - `category` 'chargeback' | 'merchant_prearbitration_decline' | 'user_prearbitration', required — The category of the user submission. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully. - `chargeback` object, nullable — A Visa Card Dispute Chargeback User Submission Chargeback Details object. This field will be present in the JSON response if and only if `category` is equal to `chargeback`. Contains the details specific to a Visa chargeback User Submission for a Card Dispute. - `authorization` object, nullable, required — Authorization. Present if and only if `category` is `authorization`. - `account_status` 'account_closed' | 'credit_problem' | 'fraud', required — Account status. - `category` 'authorization' | 'consumer_canceled_merchandise' | 'consumer_canceled_recurring_transaction' | 'consumer_canceled_services' | 'consumer_counterfeit_merchandise' | 'consumer_credit_not_processed' | 'consumer_damaged_or_defective_merchandise' | 'consumer_merchandise_misrepresentation' | 'consumer_merchandise_not_as_described' | 'consumer_merchandise_not_received' | 'consumer_non_receipt_of_cash' | 'consumer_original_credit_transaction_not_accepted' | 'consumer_quality_merchandise' | 'consumer_quality_services' | 'consumer_services_misrepresentation' | 'consumer_services_not_as_described' | 'consumer_services_not_received' | 'fraud' | 'processing_error', required — Category. - `consumer_canceled_merchandise` object, nullable, required — Canceled merchandise. Present if and only if `category` is `consumer_canceled_merchandise`. - `cardholder_cancellation` object, nullable, required — Cardholder cancellation. - `canceled_at` string, date, required — Canceled at. - `canceled_prior_to_ship_date` 'canceled_prior_to_ship_date' | 'not_canceled_prior_to_ship_date', required — Canceled prior to ship date. - `cancellation_policy_provided` 'not_provided' | 'provided', required — Cancellation policy provided. - `reason` string, required — Reason. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`. - `purchase_explanation` string, required — Purchase explanation. - `received_or_expected_at` string, date, required — Received or expected at. - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date, nullable, required — Merchant received return at. - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string, nullable, required — Tracking number. - `consumer_canceled_recurring_transaction` object, nullable, required — Canceled recurring transaction. Present if and only if `category` is `consumer_canceled_recurring_transaction`. - `cancellation_target` 'account' | 'transaction', required — Cancellation target. - `merchant_contact_methods` object, required — Merchant contact methods. - `application_name` string, nullable, required — Application name. - `call_center_phone_number` string, nullable, required — Call center phone number. - `email_address` string, nullable, required — Email address. - `in_person_address` string, nullable, required — In person address. - `mailing_address` string, nullable, required — Mailing address. - `text_phone_number` string, nullable, required — Text phone number. - `other_form_of_payment_explanation` string, nullable, required — Other form of payment explanation. - `transaction_or_account_canceled_at` string, date, required — Transaction or account canceled at. - `consumer_canceled_services` object, nullable, required — Canceled services. Present if and only if `category` is `consumer_canceled_services`. - `cardholder_cancellation` object, required — Cardholder cancellation. - `canceled_at` string, date, required — Canceled at. - `cancellation_policy_provided` 'not_provided' | 'provided', required — Cancellation policy provided. - `reason` string, required — Reason. - `contracted_at` string, date, required — Contracted at. - `guaranteed_reservation` object, nullable, required — Guaranteed reservation explanation. Present if and only if `service_type` is `guaranteed_reservation`. - `explanation` 'cardholder_canceled_prior_to_service' | 'cardholder_cancellation_attempt_within_24_hours_of_confirmation' | 'merchant_billed_no_show', required — Explanation. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `other` object, nullable, required — Other service type explanation. Present if and only if `service_type` is `other`. - `purchase_explanation` string, required — Purchase explanation. - `service_type` 'guaranteed_reservation' | 'other' | 'timeshare', required — Service type. - `timeshare` object, nullable, required — Timeshare explanation. Present if and only if `service_type` is `timeshare`. - `consumer_counterfeit_merchandise` object, nullable, required — Counterfeit merchandise. Present if and only if `category` is `consumer_counterfeit_merchandise`. - `counterfeit_explanation` string, required — Counterfeit explanation. - `disposition_explanation` string, required — Disposition explanation. - `order_explanation` string, required — Order explanation. - `received_at` string, date, required — Received at. - `consumer_credit_not_processed` object, nullable, required — Credit not processed. Present if and only if `category` is `consumer_credit_not_processed`. - `canceled_or_returned_at` string, date, nullable, required — Canceled or returned at. - `credit_expected_at` string, date, nullable, required — Credit expected at. - `consumer_damaged_or_defective_merchandise` object, nullable, required — Damaged or defective merchandise. Present if and only if `category` is `consumer_damaged_or_defective_merchandise`. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`. - `order_and_issue_explanation` string, required — Order and issue explanation. - `received_at` string, date, required — Received at. - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date, nullable, required — Merchant received return at. - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string, nullable, required — Tracking number. - `consumer_merchandise_misrepresentation` object, nullable, required — Merchandise misrepresentation. Present if and only if `category` is `consumer_merchandise_misrepresentation`. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `misrepresentation_explanation` string, required — Misrepresentation explanation. - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`. - `purchase_explanation` string, required — Purchase explanation. - `received_at` string, date, required — Received at. - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date, nullable, required — Merchant received return at. - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string, nullable, required — Tracking number. - `consumer_merchandise_not_as_described` object, nullable, required — Merchandise not as described. Present if and only if `category` is `consumer_merchandise_not_as_described`. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `received_at` string, date, required — Received at. - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'returned' | 'return_attempted', required — Return outcome. - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date, nullable, required — Merchant received return at. - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string, nullable, required — Tracking number. - `consumer_merchandise_not_received` object, nullable, required — Merchandise not received. Present if and only if `category` is `consumer_merchandise_not_received`. - `cancellation_outcome` 'cardholder_cancellation_prior_to_expected_receipt' | 'merchant_cancellation' | 'no_cancellation', required — Cancellation outcome. - `cardholder_cancellation_prior_to_expected_receipt` object, nullable, required — Cardholder cancellation prior to expected receipt. Present if and only if `cancellation_outcome` is `cardholder_cancellation_prior_to_expected_receipt`. - `canceled_at` string, date, required — Canceled at. - `reason` string, nullable, required — Reason. - `delayed` object, nullable, required — Delayed. Present if and only if `delivery_issue` is `delayed`. - `explanation` string, required — Explanation. - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`. - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`. - … - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`. - … - `delivered_to_wrong_location` object, nullable, required — Delivered to wrong location. Present if and only if `delivery_issue` is `delivered_to_wrong_location`. - `agreed_location` string, required — Agreed location. - `delivery_issue` 'delayed' | 'delivered_to_wrong_location', required — Delivery issue. - `last_expected_receipt_at` string, date, required — Last expected receipt at. - `merchant_cancellation` object, nullable, required — Merchant cancellation. Present if and only if `cancellation_outcome` is `merchant_cancellation`. - `canceled_at` string, date, required — Canceled at. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `no_cancellation` object, nullable, required — No cancellation. Present if and only if `cancellation_outcome` is `no_cancellation`. - `purchase_info_and_explanation` string, required — Purchase information and explanation. - `consumer_non_receipt_of_cash` object, nullable, required — Non-receipt of cash. Present if and only if `category` is `consumer_non_receipt_of_cash`. - `consumer_original_credit_transaction_not_accepted` object, nullable, required — Original Credit Transaction (OCT) not accepted. Present if and only if `category` is `consumer_original_credit_transaction_not_accepted`. - `explanation` string, required — Explanation. - `reason` 'prohibited_by_local_laws_or_regulation' | 'recipient_refused', required — Reason. - `consumer_quality_merchandise` object, nullable, required — Merchandise quality issue. Present if and only if `category` is `consumer_quality_merchandise`. - `expected_at` string, date, required — Expected at. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `not_returned` object, nullable, required — Not returned. Present if and only if `return_outcome` is `not_returned`. - `ongoing_negotiations` object, nullable, required — Ongoing negotiations. Exclude if there is no evidence of ongoing negotiations. - `explanation` string, required — Explanation of the previous ongoing negotiations between the cardholder and merchant. - `issuer_first_notified_at` string, date, required — Date the cardholder first notified the issuer of the dispute. - `started_at` string, date, required — Started at. - `purchase_info_and_quality_issue` string, required — Purchase information and quality issue. - `received_at` string, date, required — Received at. - `return_attempted` object, nullable, required — Return attempted. Present if and only if `return_outcome` is `return_attempted`. - `attempt_explanation` string, required — Attempt explanation. - `attempt_reason` 'merchant_not_responding' | 'no_return_authorization_provided' | 'no_return_instructions' | 'requested_not_to_return' | 'return_not_accepted', required — Attempt reason. - `attempted_at` string, date, required — Attempted at. - `merchandise_disposition` string, required — Merchandise disposition. - `return_outcome` 'not_returned' | 'returned' | 'return_attempted', required — Return outcome. - `returned` object, nullable, required — Returned. Present if and only if `return_outcome` is `returned`. - `merchant_received_return_at` string, date, nullable, required — Merchant received return at. - `other_explanation` string, nullable, required — Other explanation. Required if and only if the return method is `other`. - `return_method` 'dhl' | 'face_to_face' | 'fedex' | 'other' | 'postal_service' | 'ups', required — Return method. - `returned_at` string, date, required — Returned at. - `tracking_number` string, nullable, required — Tracking number. - `consumer_quality_services` object, nullable, required — Services quality issue. Present if and only if `category` is `consumer_quality_services`. - `cardholder_cancellation` object, required — Cardholder cancellation. - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant. - `canceled_at` string, date, required — Canceled at. - `reason` string, required — Reason. - `cardholder_paid_to_have_work_redone` 'did_not_pay_to_have_work_redone' | 'paid_to_have_work_redone', nullable, required — Cardholder paid to have work redone. - `non_fiat_currency_or_non_fungible_token_related_and_not_matching_description` 'not_related' | 'related', required — Non-fiat currency or non-fungible token related and not matching description. - `ongoing_negotiations` object, nullable, required — Ongoing negotiations. Exclude if there is no evidence of ongoing negotiations. - `explanation` string, required — Explanation of the previous ongoing negotiations between the cardholder and merchant. - `issuer_first_notified_at` string, date, required — Date the cardholder first notified the issuer of the dispute. - `started_at` string, date, required — Started at. - `purchase_info_and_quality_issue` string, required — Purchase information and quality issue. - `restaurant_food_related` 'not_related' | 'related', nullable, required — Whether the dispute is related to the quality of food from an eating place or restaurant. Must be provided when Merchant Category Code (MCC) is 5812, 5813 or 5814. - `services_received_at` string, date, required — Services received at. - `consumer_services_misrepresentation` object, nullable, required — Services misrepresentation. Present if and only if `category` is `consumer_services_misrepresentation`. - `cardholder_cancellation` object, required — Cardholder cancellation. - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant. - `canceled_at` string, date, required — Canceled at. - `reason` string, required — Reason. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `misrepresentation_explanation` string, required — Misrepresentation explanation. - `purchase_explanation` string, required — Purchase explanation. - `received_at` string, date, required — Received at. - `consumer_services_not_as_described` object, nullable, required — Services not as described. Present if and only if `category` is `consumer_services_not_as_described`. - `cardholder_cancellation` object, required — Cardholder cancellation. - `accepted_by_merchant` 'accepted' | 'not_accepted', required — Accepted by merchant. - `canceled_at` string, date, required — Canceled at. - `reason` string, required — Reason. - `explanation` string, required — Explanation of what was ordered and was not as described. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `received_at` string, date, required — Received at. - `consumer_services_not_received` object, nullable, required — Services not received. Present if and only if `category` is `consumer_services_not_received`. - `cancellation_outcome` 'cardholder_cancellation_prior_to_expected_receipt' | 'merchant_cancellation' | 'no_cancellation', required — Cancellation outcome. - `cardholder_cancellation_prior_to_expected_receipt` object, nullable, required — Cardholder cancellation prior to expected receipt. Present if and only if `cancellation_outcome` is `cardholder_cancellation_prior_to_expected_receipt`. - `canceled_at` string, date, required — Canceled at. - `reason` string, nullable, required — Reason. - `last_expected_receipt_at` string, date, required — Last expected receipt at. - `merchant_cancellation` object, nullable, required — Merchant cancellation. Present if and only if `cancellation_outcome` is `merchant_cancellation`. - `canceled_at` string, date, required — Canceled at. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `no_cancellation` object, nullable, required — No cancellation. Present if and only if `cancellation_outcome` is `no_cancellation`. - `purchase_info_and_explanation` string, required — Purchase information and explanation. - `fraud` object, nullable, required — Fraud. Present if and only if `category` is `fraud`. - `fraud_type` 'account_or_credentials_takeover' | 'card_not_received_as_issued' | 'fraudulent_application' | 'fraudulent_use_of_account_number' | 'incorrect_processing' | 'issuer_reported_counterfeit' | 'lost' | 'manipulation_of_account_holder' | 'merchant_misrepresentation' | 'miscellaneous' | 'stolen', required — Fraud type. - `processing_error` object, nullable, required — Processing error. Present if and only if `category` is `processing_error`. - `duplicate_transaction` object, nullable, required — Duplicate transaction. Present if and only if `error_reason` is `duplicate_transaction`. - `other_transaction_id` string, required — Other transaction ID. - `error_reason` 'duplicate_transaction' | 'incorrect_amount' | 'paid_by_other_means', required — Error reason. - `incorrect_amount` object, nullable, required — Incorrect amount. Present if and only if `error_reason` is `incorrect_amount`. - `expected_amount` integer, required — Expected amount. - `merchant_resolution_attempted` 'attempted' | 'prohibited_by_local_law', required — Merchant resolution attempted. - `paid_by_other_means` object, nullable, required — Paid by other means. Present if and only if `error_reason` is `paid_by_other_means`. - `other_form_of_payment_evidence` 'canceled_check' | 'card_transaction' | 'cash_receipt' | 'other' | 'statement' | 'voucher', required — Other form of payment evidence. - `other_transaction_id` string, nullable, required — Other transaction ID. - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Visa Card Dispute User Submission was created. - `explanation` string, nullable, required — The free-form explanation provided to Increase to provide more context for the user submission. This field is not sent directly to the card networks. - `further_information_requested_at` string, date-time, nullable, required — The date and time at which Increase requested further information from the user for the Visa Card Dispute. - `further_information_requested_reason` string, nullable, required — The reason for Increase requesting further information from the user for the Visa Card Dispute. - `merchant_prearbitration_decline` object, nullable — A Visa Card Dispute Merchant Pre-Arbitration Decline User Submission object. This field will be present in the JSON response if and only if `category` is equal to `merchant_prearbitration_decline`. Contains the details specific to a merchant prearbitration decline Visa Card Dispute User Submission. - `reason` string, required — The reason the user declined the merchant's request for pre-arbitration in their favor. - `status` 'abandoned' | 'accepted' | 'further_information_requested' | 'pending_reviewing', required — The status of the Visa Card Dispute User Submission. - `updated_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Visa Card Dispute User Submission was updated. - `user_prearbitration` object, nullable — A Visa Card Dispute User-Initiated Pre-Arbitration User Submission object. This field will be present in the JSON response if and only if `category` is equal to `user_prearbitration`. Contains the details specific to a user-initiated pre-arbitration Visa Card Dispute User Submission. - `category_change` object, nullable, required — Category change details for the pre-arbitration request, if requested. - `category` 'authorization' | 'consumer_canceled_merchandise' | 'consumer_canceled_recurring_transaction' | 'consumer_canceled_services' | 'consumer_counterfeit_merchandise' | 'consumer_credit_not_processed' | 'consumer_damaged_or_defective_merchandise' | 'consumer_merchandise_misrepresentation' | 'consumer_merchandise_not_as_described' | 'consumer_merchandise_not_received' | 'consumer_non_receipt_of_cash' | 'consumer_original_credit_transaction_not_accepted' | 'consumer_quality_merchandise' | 'consumer_quality_services' | 'consumer_services_misrepresentation' | 'consumer_services_not_as_described' | 'consumer_services_not_received' | 'fraud' | 'processing_error', required — The category the dispute is being changed to. - `reason` string, required — The reason for the pre-arbitration request. - `reason` string, required — The reason for the pre-arbitration request. - `win` object, nullable, required — If the Card Dispute's status is `won`, this will contain details of the won dispute. - `won_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card Dispute was won. - `withdrawal` object, nullable, required — If the Card Dispute has been withdrawn, this will contain details of the withdrawal. - `explanation` string, nullable, required — The explanation for the withdrawal of the Card Dispute. ## Other responses - `4XX` — Error - `5XX` — Error --- [API](https://skmtc.net/increase/apis/increase-api.md) · [All operations](https://skmtc.net/increase/apis/increase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api/versions/22125d715935/schema)