> ## 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 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.
**Allowable Values:**
`MERCHANT_ISSUED_PARTIAL_REFUND`, `PARTIAL_DISPUTE`, `NOT_AS_DESCRIBED_PARTIAL`, `PARTIAL_SERVICE`, `PRORATED_REFUND`, `NOT_AUTHORIZED_FOR_FULL_AMOUNT`
Required if `dispute_amount` is not equal to transaction 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 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 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 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 table. |
| additional\_dispute\_details
object
Optional | An object providing any additional information for a case.
**Allowable Values:**
See 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 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 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 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 table. |
| incorrect\_transaction\_code\_details
object
Conditionally required | An object providing incorrect transaction code details.
**Allowable Values:**
See 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 table. |
| incorrect\_account\_number\_details
object
Conditionally required | An object providing incorrect account number details.
**Allowable Values:**
See 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 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 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 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 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 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 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 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 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 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 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 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 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 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 table. |
| cancelled\_recurring\_transaction\_details
object
Conditionally required | An object providing cancelled recurring transaction details.
**Allowable Values:**
See 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 table. |
| credit\_not\_processed\_details
object
Conditionally required | An object providing credit not processed details.
**Allowable Values:**
See 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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**
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 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 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](/docs/core-api/disputes-mastercard/create-case.md)
- [Create dispute case transition](/docs/core-api/disputes-pulse/create-case-transition.md)
- [Create dispute case action](/docs/core-api/disputes-visa/create-case-action.md)
- [Create dispute case content](/docs/core-api/disputes-visa/create-case-content.md)
- [Disputes (PULSE) Overview](/docs/core-api/disputes-pulse.md)