> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create dispute case

> Create a new dispute case by specifying the type and including the type-specific details object.

POST/cases

Create a new dispute case by specifying the type and including the type-specific details object.

## Body field details

| Fields | Description |
| - | - |
| token string  Optional | The unique identifier of the dispute case. If you do not include a token, the system generates a token automatically. Because this token is necessary for use in other API calls, it is recommended that, rather than let the system generate the token, you use a simple string that is easy to remember. This value cannot be updated. **Allowable Values:**  36 char max |
| type string  Required | The type of case. **Allowable Values:**  `DISPUTE` |
| memo string  Optional | Free-form comments about the dispute. **Allowable Values:**  512 char max |
| zendesk\_ticket\_id string  Optional | ID for the Zendesk ticket. **Allowable Values:**  255 char max |
| dispute\_details object  Required | An object describing the disputed transaction, including the reason for the dispute. **Allowable Values:**  See [The dispute\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_dispute_details_object) table. |

## The dispute\_details object

Include this object in your request if the case type is `DISPUTE`.

| Fields | Description |
| - | - |
| original\_transaction\_token string  Required | The token of the original transaction under dispute. **Allowable Values:**  36 char max |
| original\_transaction\_id integer  Optional | The ID of the original transaction under dispute. **Allowable Values:**  Existing transaction ID. |
| dispute\_amount number  Required | The amount of funds under dispute. **Allowable Values:**  Must be less than or equal to the original transaction amount. |
| dispute\_amount\_change\_reason string  Conditionally required | The reason the dispute amount has been changed from the transaction amount. Required if `dispute_amount` is not equal to transaction amount. **Allowable Values:**  `MERCHANT_ISSUED_PARTIAL_REFUND`, `PARTIAL_DISPUTE`, `NOT_AS_DESCRIBED_PARTIAL`, `PARTIAL_SERVICE`, `PRORATED_REFUND`, `NOT_AUTHORIZED_FOR_FULL_AMOUNT` |
| currency\_code string  Optional | The currency in which the original transaction was made. Currently, only 840 is supported. There is a known caveat for multi-currency programs: disputes are created in the transaction currency as expected, but chargebacks might currently default to the program-level default currency rather than the transaction currency. **Allowable Values:**  30 char max |
| dispute\_reason string  Required | The code describing the reason for the dispute. **Allowable Values:**  See [The dispute\_details.dispute\_reason field](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_dispute_details_dispute_reason_field) table. |
| processing\_error\_type\_dispute\_details object  Optional | An object providing details about processing error disputes. **Allowable Values:**  See [The processing\_error\_type\_dispute\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_processing_error_type_dispute_details_object) table. |
| consumer\_dispute\_type\_dispute\_details object  Optional | An object providing consumer dispute type details. **Allowable Values:**  See [The consumer\_dispute\_type\_dispute\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_consumer_dispute_type_dispute_details_object) table. |
| duplicate\_processing\_or\_paid\_by\_other\_means\_details object  Optional | An object providing duplicate processing or paid by other means dispute type details. **Allowable Values:**  See [The duplicate\_processing\_or\_paid\_by\_other\_means\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_duplicate_processing_or_paid_by_other_means_details_object) table. |
| additional\_dispute\_details object  Optional | An object providing any additional information for a case. **Allowable Values:**  See [The additional\_dispute\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_additional_dispute_details_object) table. |
| fraud\_dispute\_type\_details object  Optional | An object providing any additional information for a dispute case with a fraud dispute reason. **Allowable Values:**  See [The fraud\_dispute\_type\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_fraud_dispute_type_details_object) table. |
| fraud\_category\_type\_dispute\_details object  Optional | An object providing the fraud type request to the Visa network. **Allowable Values:**  See [The fraud\_category\_type\_dispute\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_fraud_category_type_dispute_details_object) table. |
| fraud\_classification\_type\_dispute\_details object  Optional | Object that provides details about the fraud type classification to the Visa card network. **Allowable Values:**  See the [fraud\_classification\_type\_dispute\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_fraud_classification_type_dispute_details_object) table. |
| cardholder\_contact\_date datetime  Conditionally required | The date that the cardholder made initial contact regarding the dispute. Required for Regulation E reason codes if the program has been enrolled for Regulation E provisional credit; otherwise, optional. **Allowable Values:**  Format: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| regulation\_type string  Conditionally required | The regulation type for the dispute. **Allowable Values:**  `REG_E` |

## The dispute\_details.dispute\_reason field

The following table describes the possible values for the `dispute_details.dispute_reason` field.

| Dispute Reason and Visa Code | Description |
| - | - |
| EMV\_LIABILITY\_SHIFT\_COUNTERFEIT\_FRAUD (10.1) | The transaction was completed with a counterfeit card in a card-present environment and qualifies for the EMV liability shift. |
| EMV\_LIABILITY\_SHIFT\_NON\_COUNTERFEIT\_FRAUD (10.2) | The transaction was completed in a card-present environment with a card that was reported lost or stolen and qualifies for the EMV liability shift. |
| NOT\_AUTHORIZED\_CARD\_PRESENT (10.3) | The cardholder denies authorization of or participation in a key-entered transaction conducted in a card-present environment. |
| NOT\_AUTHORIZED\_CARD\_ABSENT (10.4) | An unauthorized user initiated the transaction and the card was not present. |
| NO\_AUTHORIZATION (11.3) | - Authorization was required, but not obtained. - The primary account number (PAN) does not exist. - A Card Not Present (CNP) transaction was initially declined but subsequently approved through stand-in processing. |
| INCORRECT\_TRANSACTION\_CODE (12.2) | The transaction code is incorrect. |
| INCORRECT\_CURRENCY (12.3) | The currency is incorrect. |
| INCORRECT\_ACCOUNT\_NUMBER (12.4) | The account number is incorrect. |
| INCORRECT\_TRANSACTION\_AMOUNT (12.5) | The transaction amount is incorrect. |
| DUPLICATE\_PROCESSING\_OR\_PAID\_BY\_OTHER\_MEANS (12.6) | A single transaction was processed more than once using the same payment credential on the same transaction date, and for the same transaction amount. |
| SERVICE\_NOT\_PROVIDED\_MERCHANDISE\_NOT\_RECEIVED (13.1) | The goods or services were not provided. |
| CANCELLED\_RECURRING\_TRANSACTION (13.2) | A recurring transaction was cancelled. |
| NOT\_AS\_DESCRIBED\_OR\_DEFECTIVE\_MERCHANDISE (13.3) | The merchandise was not as described or defective. |
| COUNTERFEIT\_MERCH (13.4) | The cardholder received counterfeit goods. |
| MISREPRESENTATION (13.5) | The merchant misrepresented their advertised goods or services. |
| CREDIT\_NOT\_PROCESSED (13.6) | A credit was not processed. |
| CANCELLED\_MERCHANDISE\_OR\_SERVICES (13.7) | Merchandise or services were cancelled. |
| ORIGINAL\_CREDIT\_NOT\_ACCEPTED (13.8) | The cardholder did not or could not accept an original credit transaction. |
| NON\_RECEIPT\_OF\_CASH\_OR\_LOAD\_TRANSACTION\_VALUE\_AT\_ATM (13.9) | The cardholder did not receive the full cash withdrawal or received only partial amount. |
| FRAUD\_REPORT | Report fraud to the Visa network. |

### The processing\_error\_type\_dispute\_details object

| Fields | Description |
| - | - |
| late\_presentment\_details object  Conditionally required | An object providing late presentment details. **Allowable Values:**  See [The late\_presentment\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_late_presentment_details_object) table. |
| incorrect\_transaction\_code\_details object  Conditionally required | An object providing incorrect transaction code details. **Allowable Values:**  See [The incorrect\_transaction\_code\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_incorrect_transaction_code_details_object) table. |
| incorrect\_currency\_details object  Conditionally required | An object providing incorrect currency details. **Allowable Values:**  See [The incorrect\_currency\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_incorrect_currency_details_object) table. |
| incorrect\_account\_number\_details object  Conditionally required | An object providing incorrect account number details. **Allowable Values:**  See [The incorrect\_account\_number\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_incorrect_account_number_details_object) table. |
| incorrect\_transaction\_amount\_details object  Conditionally required | An object providing incorrect transaction amount details. **Allowable Values:**  See [The incorrect\_transaction\_amount\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_incorrect_transaction_amount_details_object) table. |
| duplicate\_processing\_or\_paid\_by\_other\_means\_details object  Conditionally required | An object providing details about duplicate processing or paid by other means. **Allowable Values:**  See [The duplicate\_processing\_or\_paid\_by\_other\_means\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_duplicate_processing_or_paid_by_other_means_details_object) table. |

The late\_presentment\_details object

| Fields | Description |
| - | - |
| account\_status string  Conditionally required | The account status. Whether this field is optional or required depends on previous answers provided by the cardholder. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  `ACCOUNT_CLOSED`, `CREDIT_PROBLEM`, `FRAUD`, `NONSUFFICIENT_FUNDS` |

The incorrect\_transaction\_code\_details object

| Fields | Description |
| - | - |
| how\_is\_transaction\_code\_incorrect string  Conditionally required | The token of the original transaction under dispute. Whether this field is optional or required depends on previous answers provided by the cardholder. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  `CREDIT_INSTEAD_OF_REVERSAL_OR_ADJUSTMENT`, `CREDIT_POSTED_AS_DEBIT`, `DEBIT_POSTED_AS_CREDIT` |
| explain\_why\_the\_credit\_refund\_was\_processed\_in\_error string  Conditionally required | An explanation for why the credit refund was incorrectly processed. Whether this field is optional or required depends on previous answers provided by the cardholder. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:** |

The incorrect\_currency\_details object

| Fields | Description |
| - | - |
| incorrect\_currency\_reason string  Conditionally required | The reason for the incorrect currency. Whether this field is optional or required depends on previous answers provided by the cardholder. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  `CURRENCY_DIFFERENCE`, `DCC_DISPUTE` |
| what\_was\_the\_correct\_currency integer  Conditionally required | An explanation for why the credit refund was incorrectly processed. Whether this field is optional or required depends on previous answers provided by the cardholder. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  An ISO 4217 currency number |
| certification\_that\_the\_cardholder\_did\_not\_agree\_to\_dynamic\_currency\_conversion\_and\_did\_not\_make\_an\_active\_choice string  Conditionally required | Indicates that the cardholder did not agree to or make an active choice for dynamic currency conversion. Whether this field is optional or required depends on previous answers provided by the cardholder. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |

The incorrect\_account\_number\_details object

| Fields | Description |
| - | - |
| is\_the\_account\_number\_on\_the\_issuers\_master\_file boolean  Conditionally required | Indicates whether the cardholder's account number is also in the issuer's file. Whether this field is optional or required depends on previous answers provided by the cardholder. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| does\_the\_account\_number\_on\_the\_receipt\_match\_the\_cardholders\_account\_number\_or\_token boolean  Conditionally required | Indicates whether the account numbers match. Whether this field is optional or required depends on previous answers provided by the cardholder. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |

The incorrect\_transaction\_amount\_details object

| Fields | Description |
| - | - |
| what\_is\_the\_amount\_on\_the\_cardholders\_receipt number  Conditionally required | The amount on the cardholder's receipt. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  32 bytes |
| what\_is\_the\_currency\_on\_the\_cardholders\_receipt string  Conditionally required | The currency on the cardholder's receipt. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  A valid currency code. |
| is\_the\_dispute\_due\_to\_the\_difference\_between\_quoted\_price\_and\_actual\_charges\_made\_by\_the\_merchant boolean  Conditionally required | Indicates whether the dispute appeared due to the difference between quoted price and actual charges made by the merchant. To determine whether this field is required, see the decision tree for [Processing Errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |

### The consumer\_dispute\_type\_dispute\_details object

| Fields | Description |
| - | - |
| service\_not\_provided\_merchandise\_not\_received\_details object  Conditionally required | An object describing service or merchandise not provided details. **Allowable Values:**  See [The service\_not\_provided\_merchandise\_not\_received\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_service_not_provided_merchandise_not_received_details_object) table. |
| cancelled\_recurring\_transaction\_details object  Conditionally required | An object providing cancelled recurring transaction details. **Allowable Values:**  See [The cancelled\_recurring\_transaction\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_cancelled_recurring_transaction_details_object) table. |
| not\_as\_described\_or\_defective\_merchandise\_details object  Conditionally required | An object providing not as described or defective merchandise details. **Allowable Values:**  See [The not\_as\_described\_or\_defective\_merchandise\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_not_as_described_or_defective_merchandise_details_object) table. |
| credit\_not\_processed\_details object  Conditionally required | An object providing credit not processed details. **Allowable Values:**  See [The credit\_not\_processed\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_credit_not_processed_details_object) table. |
| cancelled\_merchandise\_or\_services\_details object  Conditionally required | An object providing cancelled merchandise or service details. **Allowable Values:**  See [The cancelled\_merchandise\_or\_services\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_cancelled_merchandise_or_services_details_object) table. |

The service\_not\_provided\_merchandise\_not\_received\_details object

| Fields | Description |
| - | - |
| detailed\_description\_of\_what\_was\_purchased\_and\_explanation\_of\_the\_dispute string  Conditionally required | A description of what was purchased and explanation of the dispute. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| expected\_receipt\_date date  Conditionally required | The expected date of receipt. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| expected\_receipt\_time string  Conditionally required | The expected time of receipt. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: hh-mm-ss |
| did\_cardholder\_cancel\_prior\_to\_the\_expected\_date boolean  Conditionally required | Indicates whether the cardholder cancelled before the expected date. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| cancellation\_date date  Conditionally required | The date the service was canceled. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| cancellation\_reason string  Conditionally required | The reason the transaction was cancelled. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| did\_cardholder\_attempt\_to\_resolve\_dispute\_with\_merchant boolean  Conditionally required | Indicates whether the cardholder attempted to resolve the dispute with the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| is\_attempt\_to\_resolve\_prohibited\_by\_local\_law\_or\_regulations boolean  Conditionally required | Indicates whether the attempt to resolve the dispute is prohibited by local laws or regulations. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| provide\_details\_of\_local\_law\_or\_regulations string  Conditionally required | A description of the local laws or regulations that prohibit resolution of the dispute. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| merchandise\_or\_services string  Conditionally required | Indicates whether the dispute is over merchandise or services. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `MERCHANDISE`, `SERVICES` |
| was\_merchandise\_delivered\_to\_wrong\_location boolean  Conditionally required | Indicates whether merchandise was delivered to the wrong location. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| address\_of\_agreed\_location string  Conditionally required | The address where merchandise was intended to be delivered. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  255 char max |
| did\_cardholder\_return\_merchandise boolean  Conditionally required | Indicates whether the cardholder returned the merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| date\_cardholder\_returned\_merchandise date  Conditionally required | If the cardholder returned the merchandise, the date it was returned. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| date\_merchant\_received\_returned\_merchandise date  Conditionally required | The date the merchant received the returned merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| did\_cardholder\_attempt\_to\_return\_merchandise boolean  Conditionally required | Indicates whether the cardholder attempted to return the merchandise to the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| date\_of\_attempted\_return date  Conditionally required | The date the cardholder attempted to return the merchandise to the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| explain\_how\_merchandise\_was\_returned string  Conditionally required | Describes how the merchandise was returned. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| third\_party\_gift\_card\_indicator boolean  Conditionally required | Indicates whether the purchase is a third-party gift card without an expiration date, where the merchandise or services were not provided by the third party due to insolvency or bankruptcy. **Allowable Values:**  `true`, `false` |
| visa\_commercial\_card\_virtual\_account\_indicator boolean  Conditionally required | Indicates whether the dispute involves a Visa Commercial Card Virtual Account. **Allowable Values:**  `true`, `false` |
| did\_virtual\_account\_holder\_suffer\_financial\_loss boolean  Conditionally required | Indicates whether the virtual account holder suffered a financial loss. **Allowable Values:**  `true`, `false` |
| did\_merchant\_cancel\_merchandise boolean  Conditionally required | Indicates whether merchant canceled merchandise. **Allowable Values:**  `true`, `false` |
| date\_merchant\_cancelled\_merchandise date  Conditionally required | Date merchant provider cancelled merchandise. Required if `did_merchant_cancel_merchandise` is true. **Allowable Values:**  Format: yyyy-MM-dd |
| did\_merchant\_cancel\_services boolean  Conditionally required | Indicates whether merchant/travel provider canceled services. **Allowable Values:**  `true`, `false` |
| date\_merchant\_cancelled\_services Date  Conditionally required | Date merchant/travel provider cancelled services. Required if `did_merchant_cancel_services` is true. **Allowable Values:**  Format: yyyy-MM-dd |
| explanation\_dispute\_prior\_expected\_delivery\_date String  Conditionally required | Explanation of dispute initiated prior to the expected delivery date. **Allowable Values:** |

The cancelled\_recurring\_transaction\_details object

| Fields | Description |
| - | - |
| date\_cardholder\_withdrew\_permission\_to\_charge\_the\_payment\_credential date  Conditionally required | The date the cardholder withdrew permission to charge the payment credential. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| cancellation\_reason string  Conditionally required | The reason the cardholder canceled the recurring transaction. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| date\_issuer\_informed\_merchant\_of\_account\_closure date  Conditionally required | The date the card issuer informed the merchant that the account was closed. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| contact\_merchant\_details\_physical\_address object  Conditionally required | The physical address of the merchant. **Allowable Values:**  Valid `contact_merchant_details_physical_address` object |
| contact\_method\_merchant\_in\_person\_ind boolean  Conditionally required | Indicates if the merchant was contacted in person. **Allowable Values:**  `true`, `false` |
| contact\_method\_merchant\_email\_ind boolean  Conditionally required | Indicates if the merchant was contacted by email. **Allowable Values:**  `true`, `false` |
| contact\_method\_merchant\_mail\_ind boolean  Conditionally required | Indicates if the merchant was contacted by physical mail. **Allowable Values:**  `true`, `false` |
| contact\_merchant\_details\_application\_name string  Conditionally required | The application name. **Allowable Values:**  255 char max |
| contact\_method\_merchant\_webform\_ind boolean  Conditionally required | Indicates if the merchant was contacted by webform. **Allowable Values:**  `true`, `false` |
| contact\_merchant\_details\_phone\_number string  Conditionally required | The phone number used to contact the merchant. **Allowable Values:**  Valid phone number |
| contact\_merchant\_details\_email\_address string  Conditionally required | The email address used to contact the merchant. **Allowable Values:**  Valid email address |
| contact\_method\_merchant\_SMS\_ind string  Conditionally required | Indicates if the merchant was contacted by SMS. **Allowable Values:**  `true`, `false` |
| contact\_method\_with\_merchant\_ind boolean  Conditionally required | Indicates if the method for contacting the merchant was provided. **Allowable Values:**  `true`, `false` |
| contact\_method\_merchant\_call\_center\_ind boolean  Conditionally required | Indicates if the merchant was contacted by a call center. **Allowable Values:**  `true`, `false` |
| other\_form\_of\_payment\_ind boolean  Optional | Indicates if another form of payment was provided. **Allowable Values:**  `true`, `false` |
| other\_form\_of\_payment\_desc string  Conditionally required | Description of the other form of payment. Required if `other_form_of_payment_ind` is `true`. **Allowable Values:**  255 char max |

The not\_as\_described\_or\_defective\_merchandise\_details object

| Fields | Description |
| - | - |
| merchant\_refuse\_advise string  Conditionally required | Provides clarification as to why merchant refused advise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `MERCHANT_REFUSED_RETURN_AUTHORIZATION`, `MERCHANT_REFUSED_TO_ACCEPT_RETURNED_MERCHANDISE`, `MERCHANT_INFORMED_CARDHOLDER_NOT_TO_RETURN_MERCHANDISE` |
| not\_as\_described\_or\_defective string  Conditionally required | Indicates whether the merchandise was not as described or defective. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `NOT_AS_DESCRIBED`, `DEFECTIVE` |
| merchandise\_or\_services string  Conditionally required | Indicates whether the transaction involves merchandise or services. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `MERCHANDISE`, `SERVICES` |
| date\_the\_cardholder\_first\_notified\_the\_issuer\_of\_the\_dispute date  Conditionally required | The date the cardholder first notified the card issuer of the dispute. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| did\_the\_cardholder\_attempt\_to\_resolve\_the\_dispute\_with\_the\_merchant boolean  Conditionally required | Indicates whether the cardholder attempted to resolve the dispute with the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| is\_attempt\_to\_resolve\_prohibited\_by\_local\_law\_or\_regulations boolean  Conditionally required | Indicates whether the attempt to resolve the dispute is prohibited by local laws or regulations. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| provide\_details\_of\_local\_law\_or\_regulations string  Conditionally required | A detailed explanation of local laws or regulations that prevent resolution. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| did\_the\_cardholder\_return\_the\_merchandise boolean  Conditionally required | Indicates whether the cardholder returned the merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| date\_cardholder\_returned\_the\_merchandise date  Conditionally required | The date the cardholder returned the merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| date\_merchant\_received\_the\_returned\_merchandise date  Conditionally required | The date the merchant received the returned merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| return\_method string  Conditionally required | The method used to return the merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `FACE_TO_FACE`, `FED_EX`, `DHL`, `UPS`, `POSTAL_SERVICE`, `OTHER` |
| tracking\_number string  Conditionally required | The tracking number of the returned merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| date\_of\_attempted\_return date  Conditionally required | The date the return was attempted. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| provide\_a\_detailed\_description\_of\_how\_the\_cardholder\_attempted\_to\_return\_and\_the\_disposition\_of\_the\_merchandise string  Conditionally required | A detailed description of how the cardholder attempted to return them merchandise and its current disposition. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| did\_the\_cardholder\_attempt\_to\_return\_the\_merchandise boolean  Conditionally required | Indicates whether the cardholder attempted to return the merchandise to the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| explain\_how\_the\_merchandise\_was\_returned string  Conditionally required | A description of how the merchandise was returned by the cardholder. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| cardholder\_merchant\_previous\_negotiation\_evidence boolean  Conditionally required | Indicates whether the cardholder and merchant have negotiated. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| explain\_prev\_negotiation string  Conditionally required | A description of the negotiation between the cardholder and the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| when\_negotiations\_begin string  Conditionally required | The date when negotiations between the cardholder and merchant began. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| date\_merchandise\_or\_service\_was\_received date  Conditionally required | The date the merchandise or service was received by the cardholder. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| does\_the\_dispute\_involve\_merchandise\_or\_services\_provided\_that\_do\_not\_match\_the\_merchants\_verbal\_description boolean  Conditionally required | Indicates whether the dispute involves merchandise or services that do not match the merchant's verbal description. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| did\_the\_merchandise\_or\_services\_differ\_from\_what\_was\_described\_on\_the\_receipt boolean  Conditionally required | Indicates whether the merchandise or services differ from what was described on the receipt. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| provide\_details\_of\_what\_was\_ordered\_and\_not\_as\_described string  Conditionally required | A description of what the cardholder ordered and how it is different from what was described by the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| did\_the\_cardholder\_cancel\_the\_services boolean  Conditionally required | Indicates whether the cardholder cancelled the services. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| cancellation\_date date  Conditionally required | The date the services were cancelled. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| cancellation\_reason string  Conditionally required | The reason the services were cancelled. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| what\_was\_ordered\_and\_how\_it\_was\_damaged\_or\_defective string  Conditionally required | Describes what was ordered and whether it was damaged or defective. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| date\_merchandise\_was\_received date  Conditionally required | The date the merchandise was received. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |

The credit\_not\_processed\_details object

| Fields | Description |
| - | - |
| was\_a\_credit\_voucher\_voided\_transaction\_receipt\_or\_refund\_acknowledgement\_given boolean  Conditionally required | Indicates whether a credit voucher voided the transaction receipt or a refund acknowledgment was given. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| is\_the\_credit\_voucher\_transaction\_receipt\_or\_refund\_acknowledgement\_dated boolean  Conditionally required | Indicates whether the credit voucher transaction receipt or refund acknowledgment has a date. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| credit\_voucher\_transaction\_receipt\_or\_refund\_acknowledgement\_date date  Conditionally required | The date of the credit voucher transaction receipt or refund acknowledgment. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| date\_cardholder\_returned\_cancelled\_merchandise Date  Conditionally required | Date the cardholder cancelled the service or returned the merchandise. **Allowable Values:**  Format: yyyy-MM-dd |

The cancelled\_merchandise\_or\_services\_details object

| Fields | Description |
| - | - |
| merchandise\_or\_services string  Conditionally required | Indicates whether the dispute is about merchandise or services. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `MERCHANDISE`, `SERVICE` |
| describe\_what\_was\_purchased string  Conditionally required | A description of what was purchased. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| date\_cardholder\_received\_or\_expected\_to\_receive\_merchandise date  Conditionally required | The date the cardholder received or expected to receive the merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| did\_the\_cardholder\_attempt\_to\_resolve\_the\_dispute\_with\_the\_merchant boolean  Conditionally required | Indicates whether the cardholder attempted to resolve the dispute with the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| is\_attempt\_to\_resolve\_prohibited\_by\_local\_law\_or\_regulations boolean  Conditionally required | Indicates whether the attempt to resolve the dispute is prohibited by local laws or regulations. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| provide\_details\_of\_local\_law\_or\_regulations string  Conditionally required | A description of local laws or regulations that affect the dispute. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| did\_the\_cardholder\_return\_the\_merchandise boolean  Conditionally required | Indicates whether the cardholder returned the merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| date\_of\_return date  Conditionally required | The date the merchandise was returned by the cardholder. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| date\_merchant\_received\_returned\_merchandise date  Conditionally required | The date the returned merchandise was received by the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| return\_method string  Conditionally required | The method used by the cardholder to return the merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `FACE_TO_FACE`, `FED_EX`, `DHL`, `UPS`, `POSTAL_SERVICE`, `OTHER` |
| tracking\_number string  Conditionally required | The tracking number of the returned merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| explain\_how\_the\_merchandise\_was\_returned string  Conditionally required | Describes how the merchandise was returned by the cardholder. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| did\_the\_cardholder\_attempt\_to\_return\_the\_merchandise boolean  Conditionally required | Indicates whether the cardholder attempted to return the merchandise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| date\_of\_attempted\_return date  Conditionally required | The date of the attempted return of merchandise to the merchant. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| detailed\_description\_of\_how\_the\_cardholder\_attempted\_to\_return\_and\_the\_disposition\_of\_the\_merchandise string  Conditionally required | A detailed description of how the cardholder attempted to return the merchandise and its current disposition. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| did\_cardholder\_cancel boolean  Conditionally required | Indicates whether the cardholder canceled. **Allowable Values:**  `true`, `false` |
| cancellation\_date date  Conditionally required | The date the cardholder canceled the purchase. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format: yyyy-MM-dd |
| cancellation\_reason string  Conditionally required | The reason for the cancellation. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:** |
| was\_cancellation\_policy\_provided boolean  Conditionally required | Indicates whether a cancellation policy was provided to the cardholder. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `true`, `false` |
| type\_of\_service string  Conditionally required | The type of service. **Allowable Values:**  `TIMESHARE`, `GUARANTEED_RESERVATION`, `OTHER` |
| date\_of\_service\_or\_expected\_service date  Conditionally required | The date of the service or expected service. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  Format yyyy-MM-dd |
| cancelled\_guaranteed\_reservation\_certification\_selection string  Conditionally required | Indicates the cancelled guaranteed reservation selection. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `CARDHOLDER_PROPERLY_CANCELLED`, `CARDHOLDER_ATTEMPTED_TO_CANCEL_WITHIN_24_HOURS_OF_CONFIRMATION`, `MERCHANT_BILLED_A_NO_SHOW_TRANSACTION_FOR_MORE_THAN_ONE_DAYS_ACCOMODATION` |
| merchant\_refuse\_advise string  Conditionally required | Provides clarification as to why merchant refused advise. To determine whether this field is required, see the decision tree for [Consumer disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_consumer_disputes) in Managing Visa Disputes. **Allowable Values:**  `MERCHANT_REFUSED_RETURN_AUTHORIZATION`, `MERCHANT_REFUSED_TO_ACCEPT_RETURNED_MERCHANDISE`, `MERCHANT_INFORMED_CARDHOLDER_NOT_TO_RETURN_MERCHANDISE` |

### The duplicate\_processing\_or\_paid\_by\_other\_means\_details object

| Fields | Description |
| - | - |
| error\_type string  Required | Indicates whether the dispute is a duplicate or paid by other means. For more information on whether this field is required, see the decision tree for [Processing errors](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md#_processing_errors) in Managing Visa Disputes. **Allowable Values:**  `DUPLICATE`, `PAID_BY_OTHER_MEANS` |
| both\_transactions\_in\_same\_account boolean  Required | Indicates whether both transactions are for the same merchant and on the same card. **Allowable Values:**  `true`, `false` |
| other\_transaction\_reference\_token string  Conditionally required | The clearing token of the duplicate original transaction. Required when `both_transactions_in_same_account` is set to `true`. **Allowable Values:**  36 char max |
| other\_visa\_transaction\_reference\_id string  Conditionally required | Used if the other transaction has been made with a different Visa card that has not been issued by Marqeta. Required when `both_transactions_in_same_account` is set to `true` and `transaction_reference_token` is not provided. **Allowable Values:** |
| other\_visa\_transaction\_mcsn string  Conditionally required | The MCSN of the duplicate transaction. Required when `visa_transaction_reference_id` is provided and the `visa_transaction_reference_id` has an MSCN field. **Allowable Values:** |
| transaction\_in\_different\_visa\_account boolean  Conditionally required | This should be set if the other transaction is for the same merchant and on a different Visa card owned by the same issuer or cardholder. Required when `both_transactions_in_same_account` is set to `false`. **Allowable Values:**  `true`, `false` |
| is\_other\_transaction\_with\_same\_merchant boolean  Conditionally required | Indicates whether the duplicate transaction is with the same merchant. Required when `transaction_in_different_visa_account` is set to `false`. **Allowable Values:**  `true`, `false` |
| provided\_proof\_of\_other\_means\_type string  Conditionally required | The type of proof provided that the transaction was paid by other means. Required when `is_other_transaction_with_same_merchant` is set to `false`. For `CASH_RECEIPT`, `THIRD_PARTY_VOUCHER`, `OTHER_CARD_STATEMENT`, and `OTHER` a document must be uploaded and attached when submitting to the network. `COPY_OF_CHECK` must include a copy of the front and back of the check. **Allowable Values:**  `OTHER_TRANSACTION_ARN`, `OTHER_TRANSACTION_INFORMATION`, `CASH_RECEIPT`, `COPY_OF_CHECK`, `THIRD_PARTY_VOUCHER`, `OTHER_CARD_STATEMENT`, `OTHER` |
| is\_evidence\_of\_merchant\_passed\_funds\_provided boolean  Conditionally required | If the user inputs `true`, the attachments docs are required. If user inputs `false`, the case will be network rejected when submitted to the network and will be moved to `OPEN_WITH_ACTION_REQUIRED`. Required when `provided_proof_of_other_means_type` is set to `THIRD_PARTY_VOUCHER`. **Allowable Values:**  `true`, `false` |
| cardholder\_attempted\_to\_resolve boolean  Conditionally required | Indicates whether the cardholder attempted to resolve the dispute with the merchant. Required when `error_type` is set to `PAID_BY_OTHER_MEANS` and when either `transaction_in_different_visa_account` is set to `true` or if `is_other_transaction_with_same_merchant` is set to `true`. Optional when `error_type` is set to `DUPLICATE` and when either `transaction_in_different_visa_account` is set to `true` or if `is_other_transaction_with_same_merchant` is set to `true`. **Allowable Values:**  `true`, `false` |
| is\_attempt\_to\_resolve\_prohibited\_by\_local\_law boolean  Conditionally required | Indicates whether the attempt to resolve prohibited by local law or regulations. Required when `cardholder_attempted_to_resolve` is set to false. Visa requires for the cardholder to attempt to resolve the issue before submitting to the network. If the user inputs `false` and `cardholder_attempted_to_resolve` is also `false`, the case will be network rejected when submitted to the network and will be moved to `OPEN_WITH_ACTION_REQUIRED`. **Allowable Values:**  `true`, `false` |
| other\_visa\_transaction\_arn string  Conditionally required | The ARN from other transaction if it was paid with a Visa card. Required when `provided_proof_of_other_means_type` is set to `OTHER_TRANSACTION_ARN`. **Allowable Values:** |
| other\_visa\_transaction\_information string  Conditionally required | The transaction information from the other transaction if it was paid with a Visa card. Required when `provided_proof_of_other_means_type` is set to `OTHER_TRANSACTION_INFORMATION`. **Allowable Values:** |

### The additional\_dispute\_details object

| Fields | Description |
| - | - |
| explanation\_of\_credit string  Optional | Explanation of credit. **Allowable Values:** |
| fraud\_category\_report\_details object  Optional | The fraud type request to the Visa network. **Allowable Values:**  See [The fraud\_category\_type\_dispute\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_fraud_category_type_dispute_details_object) table. |

### The fraud\_category\_type\_dispute\_details object

| Fields | Description |
| - | - |
| fraud\_type string  Optional | The fraud type of a fraud dispute case. **Allowable Values:**  `LOST`, `STOLEN`, `CARD_NOT_RECEIVED_AS_ISSUED`, `FRAUDULENT_APPLICATION`, `ISSUER_REPORTED_COUNTERFEIT`, `MISCELLANEOUS`, `FRAUDULENT_USE_OF_ACCOUNT_NUMBER`, `ACQUIRER_REPORTED_COUNTERFEIT`, `INCORRECT_PROCESSING`, `ACCOUNT_OR_CREDENTIALS_TAKEOVER`, `MERCHANT_MISREPRESENTATION`, `MANIPULATION_OF_ACCOUNT_HOLDER` |

> [!NOTE]
>
> **Note**\
> Do not use the `FRAUDULENT_APPLICATION` type when the dispute reason is either `NOT_AUTHORIZED_CARD_PRESENT (10.3)` or `NOT_AUTHORIZED_CARD_ABSENT (10.4)`. The Visa card network will reject such disputes.

### The fraud\_classification\_type\_dispute\_details object

| Fields | Description |
| - | - |
| fraud\_type\_classification string  Optional | Classification of the fraud type. This field is required if you are submitting a fraudulent account funding transaction and the `fraud_type` is `MANIPULATION_OF_ACCOUNT_HOLDER`. **Allowable Values:**  `PURCHASE_SCAM`, `INVESTMENT_SCAM`, `ROMANCE_SCAM`, `ADVANCE_FEE_SCAM`, `INVOICE_OR_MANDATE_SCAM`, `CEO_FRAUD_SCAM`, `IMPERSONATION_SCAM`, `CHARITY_SCAM`, `HOLIDAY_AND_TICKET_SCAM`, `UTILITY_SCAM`, `LOAN_SCAM`, `PARENT_GRANDPARENT_RELATIVE_SCAM`, `JOB_SCAM` |

### The fraud\_dispute\_type\_details object

An object providing additional information for cases with a fraud dispute reason.

| Fields | Description |
| - | - |
| general\_fraud\_type\_dispute\_details object  Conditionally required | An object describing general fraud type details. **Allowable Values:**  See [The general\_fraud\_type\_dispute\_details object](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/create-dispute-case-visa.md#_the_general_fraud_type_dispute_details_object) table. |

### The general\_fraud\_type\_dispute\_details object

| Fields | Description |
| - | - |
| chip\_on\_card boolean  Conditionally required | This field is set to true if the card used for the original transaction had a chip. **Allowable Values:**  `True`, `False` |

## 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](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-cases-visa/list-dispute-cases-visa.md#_the_dispute_details_response_object) table. |
| 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 |

## Sample request body

```json JSON expandable lines wrap theme={null}
{
  "token": "string",
  "type": "DISPUTE",
  "memo": "string",
  "zendesk_ticket_id": "string",
  "dispute_details": {
    "original_transaction_token": "string",
    "original_transaction_id": 0,
    "dispute_amount": 0,
    "dispute_amount_change_reason": "MERCHANT_ISSUED_PARTIAL_REFUND",
    "currency_code": "string",
    "dispute_reason": "SERVICE_NOT_PROVIDED_MERCHANDISE_NOT_RECEIVED",
    "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-07-19",
        "expected_receipt_time": "string",
        "did_cardholder_cancel_prior_to_the_expected_date": true,
        "cancellation_date": "2022-07-19",
        "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-07-19",
        "date_merchant_received_returned_merchandise": "2022-07-19",
        "did_cardholder_attempt_to_return_merchandise": true,
        "date_of_attempted_return": "2022-07-19",
        "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_merchandise": false,
        "date_merchant_cancelled_services": " ",
        "did_merchant_cancel_services": true,
        "date_merchant_cancelled_services": "2022-07-19",
        "explanation_dispute_prior_expected_delivery_date": "string"
      },
      "cancelled_recurring_transaction_details": {
        "merchant_refuse_advise": "MERCHANT_REFUSED_RETURN_AUTHORIZATION",
        "cancellation_date": "2022-07-19",
        "cancellation_reason": "string",
        "date_issuer_informed_merchant_of_account_closure": "2022-07-19"
      },
      "not_as_described_or_defective_merchandise_details": {
        "merchant_refuse_advise": "MERCHANT_REFUSED_RETURN_AUTHORIZATION",
        "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-07-19",
        "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-07-19",
        "date_merchant_received_the_returned_merchandise": "2022-07-19",
        "return_method": "FACE_TO_FACE",
        "tracking_number": "string",
        "date_of_attempted_return": "2022-07-19",
        "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-07-19",
        "date_merchandise_or_service_was_received": "2022-07-19",
        "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-07-19",
        "cancellation_reason": "string",
        "what_was_ordered_and_how_it_was_damaged_or_defective": "string",
        "date_merchandise_was_received": "2022-07-19"
      },
      "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-07-19",
        "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-07-19",
        "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-07-19",
        "date_merchant_received_returned_merchandise": "2022-07-19",
        "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-07-19",
        "detailed_description_of_how_the_cardholder_attempted_to_return_and_the_disposition_of_the_merchandise": "2022-07-19",
        "did_cardholder_cancel": true,
        "cancellation_date": "2022-07-19",
        "cancellation_reason": "string",
        "was_cancellation_policy_provided": true,
        "type_of_service": "TIMESHARE",
        "date_of_service_or_expected_service": "2022-07-19",
        "cancelled_guaranteed_reservation_certification_selection": "string",
        "merchant_refuse_advise": "MERCHANT_REFUSED_RETURN_AUTHORIZATION"
      }
    },
    "additional_dispute_details": {
      "explanation_of_credit": "string",
      "fraud_category_report_details": {
        "fraud_type": "LOST"
      }
    },
    "fraud_dispute_type_details": {
      "general_fraud_type_dispute_details": {
        "chip_on_card": true
      }
    },
    "fraud_category_type_dispute_details": {
      "fraud_type": "LOST"
    },
    "cardholder_contact_date": "2022-07-19T22:36:47.451Z"
  }
}
```

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "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",
  "zendesk_ticket_id": "string",
  "type_change_time": "string",
  "dispute_details": {
    "original_transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "original_transaction_id": 0,
    "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_reason_code": "string",
    "dispute_state": "INITIATED",
    "chargeback_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "network": "MASTERCARD",
    "network_case_number": "string",
    "acquirer_fee": 0,
    "associated_transaction_selection_required": true,
    "card_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "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-07-19",
        "expected_receipt_time": "string",
        "did_cardholder_cancel_prior_to_the_expected_date": true,
        "cancellation_date": "2022-07-19",
        "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-07-19",
        "date_merchant_received_returned_merchandise": "2022-07-19",
        "did_cardholder_attempt_to_return_merchandise": true,
        "date_of_attempted_return": "2022-07-19",
        "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_merchandise": false,
        "date_merchant_cancelled_services": " ",
        "did_merchant_cancel_services": true,
        "date_merchant_cancelled_services": "2022-07-19",
        "explanation_dispute_prior_expected_delivery_date": "string"
      },
      "cancelled_recurring_transaction_details": {
        "merchant_refuse_advise": "MERCHANT_REFUSED_RETURN_AUTHORIZATION",
        "cancellation_date": "2022-07-19",
        "cancellation_reason": "string",
        "date_issuer_informed_merchant_of_account_closure": "2022-07-19"
      },
      "not_as_described_or_defective_merchandise_details": {
        "merchant_refuse_advise": "MERCHANT_REFUSED_RETURN_AUTHORIZATION",
        "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-07-19",
        "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-07-19",
        "date_merchant_received_the_returned_merchandise": "2022-07-19",
        "return_method": "FACE_TO_FACE",
        "tracking_number": "string",
        "date_of_attempted_return": "2022-07-19",
        "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-07-19",
        "date_merchandise_or_service_was_received": "2022-07-19",
        "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-07-19",
        "cancellation_reason": "string",
        "what_was_ordered_and_how_it_was_damaged_or_defective": "string",
        "date_merchandise_was_received": "2022-07-19"
      },
      "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-07-19",
        "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-07-19",
        "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-07-19",
        "date_merchant_received_returned_merchandise": "2022-07-19",
        "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-07-19",
        "detailed_description_of_how_the_cardholder_attempted_to_return_and_the_disposition_of_the_merchandise": "2022-07-19",
        "did_cardholder_cancel": true,
        "cancellation_date": "2022-07-19",
        "cancellation_reason": "string",
        "was_cancellation_policy_provided": true,
        "type_of_service": "TIMESHARE",
        "date_of_service_or_expected_service": "2022-07-19",
        "cancelled_guaranteed_reservation_certification_selection": "string",
        "merchant_refuse_advise": "MERCHANT_REFUSED_RETURN_AUTHORIZATION"
      }
    },
    "network_case_status_details": {
      "network": "MASTERCARD",
      "network_case_number": "string",
      "case_status": "string",
      "current_case_amount": 0,
      "next_actor": "ISSUER",
      "days_to_act": 0,
      "last_action_date": "2022-07-19T22:36:47.451Z",
      "case_opened_date": "2022-07-19",
      "last_refresh_date": "2022-07-19T22:36:47.451Z",
      "allowable_actions": [
        "SUBMIT"
      ]
    },
    "additional_dispute_details": {
      "explanation_of_credit": "string",
      "fraud_category_report_details": {
        "fraud_report_details": {
          "fraud_type": "LOST",
          "fraud_type_code": "string",
          "fraud_report_id": 0,
          "fraud_type_category": "string"
        }
      }
    },
    "fraud_dispute_type_details": {
      "general_fraud_type_dispute_details": {
        "chip_on_card": true
      }
    },
    "network_failure_response": "string",
    "fraud_category_type_dispute_details": {
      "fraud_report_details": {
        "fraud_type": "LOST",
        "fraud_type_code": "string",
        "fraud_report_id": 0,
        "fraud_type_category": "string"
      }
    },
    "cardholder_contact_date": "2022-07-18T22:24:46.251Z",
    "provisional_credit_granted": true,
    "regulation_type": "REG_E"
  },
  "created_time": "2022-07-19T22:36:47.451Z",
  "updated_time": "2022-07-19T22:36:47.451Z"
}
```

## Sample request body (FRAUD)

The following shows a sample request body for submitting a fraud report.

```json JSON lines wrap theme={null}
{
    "dispute_details": {
        "dispute_reason": "FRAUD_REPORT",
        "dispute_amount": 50,
        "fraud_category_type_dispute_details": {
            "fraud_type": "FRAUDULENT_APPLICATION"
        },
        "original_transaction_token": "1c0a45c3-8212-4524-b679-610cf4d231a8"
      },

    "memo": "This is a QE test",
    "type": "DISPUTE"
}
```

## Sample response body (FRAUD)

The following shows a sample response body for submitting a fraud report.

```json JSON expandable lines wrap theme={null}
{
    "created_time": "2022-10-10T14:13:49Z",
    "last_modified_time": "2022-10-10T14:13:49Z",
    "token": "qa01-2054",
    "type": "DISPUTE",
    "memo": "This is a QE test",
    "program_short_code": "qa01",
    "user_token": "2ccc806a-d9a4-4357-aa2b-897ec86c409f",
    "state": "CLOSED",
    "dispute_details": {
        "original_transaction_token": "1c0a45c3-8212-4524-b679-610cf4d231a8",
        "original_transaction_type": "authorization.clearing",
        "dispute_amount": 50.00,
        "currency_code": "USD",
        "dispute_reason": "FRAUD_REPORT",
        "network": "VISA",
        "network_case_number": "5155784824",
        "card_token": "8db8321d-56f5-42b4-a9c3-f7d3a64bc92a",
        "provisional_credit_granted": false,
        "acquirer_fee": 0.0000,
        "associated_transaction_selection_required": true
    }
}
```


## Related topics

- [Create dispute case](https://www.marqeta.com/docs/core-api/disputes-mastercard/dispute-cases-mastercard/create-dispute-case-mastercard.md)
- [Create dispute case transition](https://www.marqeta.com/docs/core-api/disputes-pulse/dispute-case-transitions-pulse/create-dispute-case-transition-pulse.md)
- [Create dispute case action](https://www.marqeta.com/docs/core-api/disputes-pulse/create-dispute-case-action-pulse.md)
- [Create dispute case content](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-case-content-visa/create-dispute-case-content-visa.md)
- [Dispute Cases (Mastercard) Overview](https://www.marqeta.com/docs/core-api/disputes-mastercard/dispute-cases-mastercard.md)
