POST/
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 isDISPUTE.
| 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_AMOUNTRequired 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 thedispute_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
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
{
"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
{
"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
{
"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
{
"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
}
}