Visa collaboration and allocation questionnaires

This guide is intended to help clients create a dispute form for Visa. Creating this form follows creating a dispute. Specifically, it is a transcription from Visa IES Release 23.2 translated to the Pismo platform processing. It is intended to help the clients use the Visa Dispute form collaboration questionnaire. For more information, see the Visa IES Release 23.2 spreadsheet or contact your Pismo representative.

This document addresses two dispute reasons:

  • Processing Errors (reason 12)
  • Consumer (reason 13).

So if your dispute has a reason 12, see the Result of processing errors (Reason 12) section below.

For more information, see Visa chargeback reason codes. Specifically, Processing errors (reason 12), and Consumer Disputes (reason 13).

Inside the result sections you can see that some fields are repeated. This occurs because the same field could be used for more than one dispute_due_to value. The tables below are organized according to dispute_due_to values.

Pismo does not validate the completed collaboration questionnaire content.

Processing errors (reason 12)

Note: For the Req column, C = Conditional, Y = required, N= not required, and N/A = not applicable

{`
View table<i class="icon-maximize2"onclick="event.target.parentElement.click()">

			<tr id="ID">
				<td style="text-align:left; background-color: beige" colspan=4>
					<strong>
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> = 
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">ID</code> (Invalid Data)
					</strong>
				</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">authorizationRequestDeclinedValidDataInd</code>
				</td>
				<td style="text-align:left">bool</td>
				<td style="text-align:left">Certification that the authorization request would have been declined if valid data had been provided.
					<br/>
					<br/>

Valid if

dispute_due_to =

ID (Invalid Data).

Required when valid.











            <tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">processingDateOver10DaysFmTransDateInd</code>
				</td>
				<td style="text-align:left">bool</td>
				<td style="text-align:left">Processing Date is more than 10 days from  the Transaction Date. Valid if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> =
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">LP</code> (Late Presentment). and if application determines that Processing Date > 10 calendar days from Transaction Date.
					<br/>
					<br/>
                    This element is valid only for Interlink network.
                    For Non interlink network including adjustment of an ATM cash disbursement or a PIN-Authenticated Visa Debit Transaction: Required if Processing Date &lt;= 180 calendar days from Transaction Date for non adjustment transaction or if Processing Date &lt;= 45 calendar days from Transaction Date for adjustment transaction.
					<br/>
				</td>
				<td style="text-align:left">C</td>
			</tr>
            <tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">processingDateOver45DaysFmTransDateInd</code>
				</td>
				<td style="text-align:left">bool</td>
				<td style="text-align:left">Processing Date is more than 45 days from the Transaction Date.<br/>For non-interlink network:<br/> Valid if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> =
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">LP</code> (Late Presentment) and if Processing Date for an adjustment of ATM Cash Disbursement/PAVD transaction > 45 calendar days from Transaction Date.
					<br/>
                    For Interlink network:<br/> Valid if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> =
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">LP</code> (Late Presentment) and Processing Date of an adjustment transaction > 45 calendar days from Transaction Date.
					
					<br/>

				</td>
				<td style="text-align:left">C</td>
			</tr>

            <tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">processingDateOver180DaysFmTransDateInd</code>
				</td>
				<td style="text-align:left">bool</td>
				<td style="text-align:left">Processing Date is more than 180 days from the Transaction Date. Valid if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> =
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">LP</code> (Late Presentment) and if application determines that Processing Date > 180 calendar days from Transaction Date.
					<br/>
					<br/>
                    This element is valid only for Interlink network.

				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left; background-color: beige" colspan=4>
					<strong>
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> = 
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">IC</code> (Incorrect Currency)
					</strong>
				</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">incorrectCurrencyReason</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Incorrect currency reason.
					<br/>

Valid in VISA Processing Errors Flux (reason code 12.3).



CD = Currency different. The transaction currency is different from the currency transmitted through Visa.



DD = Cardholder claims that you failed to offer them a choice of paying in your local currency or that they declined paying in their local currency
















			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">transactionCodeIncorrect</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">How is transaction code incorrect?
					<br/>
					<br/>

Valid if

dispute_due_to=

IT (Incorrect Transaction Code).




Required when valid.




Values:



CRI= Credit instead of reversal or adjustment,



CRD= Credit posted as a debit,



DCR= Debit posted as a credit




Retired values:



CP= Cash posted as purchase,



PC= Purchase posted as cash.




Notes:



  1. If user selects

    CRI (Credit instead of reversal or adjustment) then the dispute amount must always be a partial amount else user will get a hard stop error upon submit if Dispute Amount >= Transaction Amount.



  2. If user selects

    CRD (Credit posted as a debit) or 'DCR' (Debit posted as a credit) then the Dispute Amount should be twice the Transaction Amount.




















			<tr>
				<td style="text-align:left; background-color:beige" colspan=4>
					<strong>
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> = 
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">IAN</code> (Incorrect Account Number)
					</strong>
				</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">receiptAccountNumberMatchInd</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">
					Does the account number on the receipt match the cardholder's account number or token? Valid values = Y or N.<br/>

					<br/<br/>Valid if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code>=
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">IT</code> (Incorrect Account Number) and 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">IssuerMasterFileAccountNumberInd</code>= 'Y'
					<br/>
					<strong>Required</strong> when valid.

				</td>
				<td style="text-align:left"></td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">issuerMasterFileAccountNumberInd</code>
				</td>
				<td style="text-align:left">long</td>
				<td style="text-align:left">Is the account number on the issuer&#x27;s master file? Valid values = 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>.
					<br/>
					<br/>

Valid if

dispute_due_to=

IAN (Incorrect Account Number)




Required when valid.






















			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">cardholderReceiptAmt</code>
				</td>
				<td style="text-align:left">number</td>
				<td style="text-align:left">What is the amount on the cardholder&#x27;s receipt. Valid if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code>=
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">IA</code> (Incorrect Amount). 
					<strong>Required</strong> when valid.
					<br/>
					<br/>
					<strong>Note</strong>: VROL calculates the difference between the transaction amount and the amount on the cardholder&#x27;s receipt. If the dispute amount is more than the difference, VROL displays a hard-stop error and expect the user to modify the dispute amount to be no more than the difference.
					<br/>
					<br/>
					<strong>Note</strong>: Documentation is 
					<strong>required</strong>.
				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">merchantDisputePriceDiffInd</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Is the dispute due to the difference between the quoted price and the actual charges made by the merchant?
					<br/>
					<br/>Valid if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code>=
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">IA</code>(Incorrect Amount) and 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">cardholderReceiptAmt</code> not equal to 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">TransactionAmount</code> and must be a valid T&amp;E MCC code transaction as listed in the Visa Op Regs.
					<br/>
					<br/>
					Valid values = 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>.
					<br/>
					<strong>Required</strong> when valid.
				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left; background-color:beige" colspan=4>
					<strong>
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> = 
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">D</code> (Duplicate) or 
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">P</code> (Paid by other means)
					</strong>
				</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">bothTransactionsOnSameAcctNumberInd</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Are both transactions for the same merchant and on the same card? Valid values = 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>.
					<br/>
					<br/>

Valid if

dispute_due_to=

D (Duplicate) or

dispute_due_to=

P (Paid by other Means).




Required when valid.


            <tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">duplicateARN</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">
                    Acquirer Reference Number
					<br/>
                    Valid if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code>=
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">D</code> (Duplicate) or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code>=
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">P</code> (Paid by other Means).
                    and <code>bothTransactionsOnSameAcctNumberInd</code>= <code>Y</code>.
					<br/>
				</td>
				<td style="text-align:left">C</td>
			</tr>


			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">issuerOrCardholderOtherAcctWithDiffVisaCardInd</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Is the other transaction for the same merchant and on a different Visa Card owned by the same Issuer/Cardholder?
					<br/>
					Format= CYY-MM-DD
					<br/><br/>

Valid if (

dispute_due_to=

D (Duplicate) or

dispute_due_to=

P (Paid by other Means)) and

bothTransactionsOnSameAcctNumberInd=

N.




Required when valid.


























		</tbody>
	</table>
</div>

`}

Consumer disputes (reason 13)

Note: For the Req column, C = Conditional, Y = required, N= not required, N/A = not applicable, and VROL = Visa Resolve On Line

{`
View table<i class="icon-maximize2"onclick="event.target.parentElement.click()">

Field Type Description Req
C


explainWhyValidDataInclusionReason
stringExplain why the inclusion of valid data would have caused the Authorization Request to be declined




Valid if

dispute_due_to =

ID (Invalid Data).
Required when valid
C



dispute_due_to =

LP (Late Presentment)

C


correctCurrency
numberProcessed through VisaNet as [currency code]; what was the correct currency


[followed by unlabeled alpha currency code dropdown]




Valid if

dispute_due_to=

IC (Incorrect Currency) and

incorrectCurrencyReason=

CD (Currency Difference)




Required when valid




Note: Provide correct 3-digit ISO currency code as opposed to the one in the original transaction being disputed.
C


cardholderDidNotAgreeDCC
stringCertification that the Cardholder did not agree to Dynamic Currency Conversion and did not make an active choice.


Valid values =

Y or

N.


Valid if

dispute_due_to=

IC (Incorrect Currency) and

incorrectCurrencyReason=

DD (DCC Dispute)




Required when valid.
C



dispute_due_to =

IT (Incorrect Transaction Code)

C


rolTransactionId
longValid if

dispute_due_to=

IT (Incorrect Transaction Code) and

transactionCodeIncorrect=

CRI (Credit instead of reversal or adjustment)




This will be VROL internal transaction id. User must provide one of the two fields

rolTransactionId or

incorrectTransactionId. These fields will be used to initiate transaction inquiry to search for supporting transaction. If provided, this field will take precedence over

incorrectTransactionId.
C


incorrectTransactionId
stringValid if

dispute_due_to=

IT (Incorrect Transaction Code) and

transactionCodeIncorrect=

CRI (Credit instead of reversal or adjustment)




User must provide one of the two fields incorrectTransactionId or rolTransactionId.




These fields will be used to initiate transaction inquiry to search for supporting transaction.




This is VisaNet transaction id. The Transaction ID is specified as the first 15 digits of this field from original transaction. If a Multiple Clearing Sequence Number (MCSN) is present for transactions such as airline transactions,


the MCSN should be appended to the end of the Transaction ID, which would make this a 17 digit value. A blank MCSN is treated the same as two zeros at the end of the Transaction ID.
C


explainWhyCreditRefund ProcessedInError
stringExplain why the credit refund was processed in error




Valid if

dispute_due_to=

IT (Incorrect Transaction Code) and

transactionCodeIncorrect=

CRI (Credit instead of reversal or adjustment).




Required when valid.




The dispute amount will be a partial amount.
C
C


matchingAuthTranId
string
Valid if

dispute_due_to=

IAN (Incorrect Account Number) and IssuerMasterFileAccountNumberInd=`N` and if a matching authorization transaction exists


This is VROL internal transaction id
C


authorizationDate
date
Valid if

dispute_due_to=

IAN (Incorrect Account Number) and IssuerMasterFileAccountNumberInd=`N` and if a matching authorization transaction exists


This is VROL internal transaction id
C


authorizationCode
string
Valid if

dispute_due_to=

IAN (Incorrect Account Number) and IssuerMasterFileAccountNumberInd=`N` and if a matching authorization transaction exists


This is VROL internal transaction id
C



dispute_due_to =

IA (Incorrect Amount)

C
C


issuerEvidenceMerchantPassedOnFundsInd
stringDoes the issuer have evidence that the first merchant passed on the funds to the second merchant? Valid values =

Yor

N




Valid if (

dispute_due_to=

D (Duplicate) or

dispute_due_to=

P (Paid by other Means)) and

providingPaymentProofOtherMeans=

V (Voucher from the third party))




Required when valid.




Note: If user inputs

Y, then the attachments docs are required. If user inputs

N, then dispute will be blocked with a hard stop error.
C


cardholderAttemptToResolve
stringDid the cardholder attempt to resolve the dispute with the merchant?




Required if

dispute_due_to=

P (Paid by other Means) AND (

otherTranSameMerchantInd=

Y or

issuerOrCardholderOtherAcctWithDiffVisaCardInd=

Y)


Valid values = Y or N.


Optional if

dispute_due_to=

D (Duplicate) AND (

otherTranSameMerchantInd=

Y or

issuerOrCardholderOtherAcctWithDiffVisaCardInd=

Y)
C


attemptToResolveProhLocalLaw
stringIs attempt to resolve prohibited by local law or regulations? Valid values =

Y or

N




Valid if

dispute_due_to=

D(Duplicate) or

dispute_due_to=

P (Paid by other Means) and

cardholderAttemptToResolve=

1N




Required when valid.




Note: If user inputs

N, then application will display hard-stop error prompting the cardholder must attempt to resolve the dispute with the merchant unless it’s prohibited by local law or regulations.
C


otherTranSameMerchantInd
stringIs the other transaction paid by other means? Valid values = Y or N.




Note: If user inputs 'N', then dispute will be blocked with a hard stop error.




Valid if (

dispute_due_to=

D(Duplicate) or

dispute_due_to=

P (Paid by other Means)) and

issuerOrCardholderOtherAcctWithDiffVisaCardInd=

N.

					<br/>
					<strong>Required</strong> when valid
				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">providingPaymentProofOtherMeans</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Providing proof of payment by other means
					<br/>
					<br/>

Valid if (

dispute_due_to=

D(Duplicate) or

dispute_due_to=

P (Paid by other Means)) and

otherTranSameMerchantInd =

Y.




Required when valid.




Domain Values:





A= ARN from other transaction if paid with Visa Card



T= Transaction information from other transaction (Transaction Identifier), if paid with Visa card



C= Cash Receipt



F= Copy of the front and back of a cancelled check



V= Voucher from the third party



S= Statement from other card



O= Other




Documentation is required and valid for domain values

C,

F,

S and

O.

C
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">cardholderDeceased</code>
				</td>
				<td style="text-align:left">bool</td>
				<td style="text-align:left">Certification that the cardholder is deceased
					<br/>
					<br/>

Valid if

dispute_due_to=

CR (Cancelled Recurring Transaction) and disputed transaction's jurisdiction is Europe regional or domestic within Europe




Note: User can only provide either

merchantFacilitiesWithdrawn or

cardholderDeceased not both. If both fields are provided then application will display hard stop error.
































































































































































































































































			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">whatWasOrdered</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">What was ordered?
					<br/>
					<br/>

Valid if

dispute_due_to =

CM (Counterfeit Merchandise)


Required when valid.


			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">merchandiseWasCounterfeitDate</code>
				</td>
				<td style="text-align:left">date</td>
				<td style="text-align:left">Date the cardholder received the merchandise or received notification that the merchandise was counterfeit. Format = CCYY-MM-DD
					<br/>
					<br/>

Valid if

dispute_due_to =

CM (Counterfeit Merchandise)


Required when valid




























































































































				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">bondAuthLetterOrAdviceDate</code>
				</td>
				<td style="text-align:left">date</td>
				<td style="text-align:left">Date of the letter or advice from the bonding authority/insurance scheme. Format = CCYY-MM-DD
					<br/>
					<br/>

Valid if

dispute_due_to =

'NR (Merchandise/Services Not Received) and

disputeInvolveBondingAuthorityInd =

Y


Required when valid.








































































































			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">nonFiatCurrencyNotDelivered</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Was non-fiat currency or non-fungible token(s) not successfully delivered to the destination wallet address supplied by the cardholder at the time of the transaction? 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code>or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>

Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

whatWasNotReceived=

S (Services).



Required when valid.


			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">merchandiseDeliveredLate</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Was the merchandise delivered late?
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code>or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>

Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

whatWasNotReceived=

M (Merchandise).



Required when valid.


			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">merchantInBankruptcyLiquidationInd</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Is merchant in bankruptcy/liquidation?
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code>or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>

Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

					<br/><br/>
					<strong>Required</strong> when valid.
				</td>
				<td style="text-align:left">C</td>
			</tr>


			<tr>
				<td style="text-align:left; background-color:beige" colspan=4>
					<strong>
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> = 
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">DM</code>(Damaged or Defective Merchandise) 
					</strong>
				</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">damagedOrDefectiveOrderInfo</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">What was ordered and how it was damaged or defective?
					<br/>
					<br/>

Valid if

dispute_due_to =

DM (Damaged or Defective Merchandise).


Required when valid.


			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">merchandiseReceivedDate</code>
				</td>
				<td style="text-align:left">date</td>
				<td style="text-align:left">Date merchandise was received. Format = CCYY-MM=DD
					<br/>
					<br/>

Valid if

dispute_due_to =

DM (Damaged or Defective Merchandise).


Required when valid.




































































































			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">merchandiseOrServices</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">What was purchased?
					<br/>
					<br/>

Valid if

dispute_due_to=

M (Misrepresentation)




Required when valid.










































































































































































































































































































































































































































			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispositionOfMerchandise</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">What is the disposition of the merchandise?
					<br/>
					<br/>

Valid if

dispute_due_to =

Q (Quality) and

CardholderAttemptReturnMerchandise =

Y



Required when valid.


























		</tbody>
	</table>
</div>

undefined `}

Allocation questionnaire (reason 11)

With VISA IES Release 24.2, Visa now requires an allocation questionnaire. This form only applies to the dispute reason 11 - Authorization.

Unlike the Collaboration questionnaire, this form will not have a dispute_due_to linked to it, and it takes only two parameters:

  1. accountStatus with one of the following values:

AC = Account closed
CP= Credit problem
F = Fraud

  1. oneAuthForMultipleSalesInd - Was one authorization used for multiples sales? Y or N

Example:

{  
    "form": {  
        "allocationQuestionnaire": {  
            "accountStatus": "AC", 
            "oneAuthForMultipleSalesInd": "Y"
  
          }  
    }
Field Type Description Req
dispute_due_to = CR(Cancelled Recurring Transaction)
merchantFacilitiesWithdrawn bool Certification that the merchant facilities were withdrawnValid if dispute_due_to= CR (Cancelled Recurring Transaction) and disputed transaction's jurisdiction is Europe regional or domestic within Europe Note: User can only provide either merchantFacilitiesWithdrawn or cardholderDeceased not both. If both fields are provided then application will display hard stop error.
C


cancellationDate
dateCancellation Date / Date cardholder withdrew permission to charge the Payment Credential. Format = CCYY-MM-DD




For Europe regional or domestic within Europe:




Valid if

dispute_due_to=

CR (Cancelled Recurring Transaction) and (

merchantFacilitiesWithdrawn=

false AND

cardholderDeceased=

false)




Required when valid.




For all other jurisdiction other than Europe regional or domestic:




Valid if

dispute_due_to=

CR (Cancelled Recurring Transaction)




Required when valid.




Note: User can only provide either

cancellationDate or

accountClosureDate for all jurisdictions.
C


contactMethodWithMerchantInd
boolContact method with merchant




For other jurisdiction other than Europe regional or domestic:




Valid if

dispute_due_to =

CR (Cancelled Recurring Transaction) and

cancellationDate is not null.




Required when valid.
C


contactMethodMerchantEmailInd
boolEmailValid if

contactMethodWithMerchantInd =

trueWhen valid, at least one of the following fields must be set to

true:



contactMethodMerchantEmailInd

contactMethodMerchantCallCenterInd

contactMethodMerchantMailInd

contactMethodMerchantSMSInd

contactMethodMerchantInPersonInd

contactMethodMerchantWebformInd
C


contactMethodMerchantCallCenterInd
boolCall Center Phone Number




Valid if

contactMethodWithMerchantInd =

true




When valid, at least one of the following fields must be set to

true:

contactMethodMerchantEmailInd

contactMethodMerchantCallCenterInd

contactMethodMerchantMailInd

contactMethodMerchantSMSInd

contactMethodMerchantInPersonInd

contactMethodMerchantWebformInd
C


contactMethodMerchantMailInd
boolMail




Valid if

contactMethodWithMerchantInd =

true




When valid, at least one of the following fields must be set to

true:



contactMethodMerchantEmailInd

contactMethodMerchantCallCenterInd

contactMethodMerchantMailInd

contactMethodMerchantSMSInd

contactMethodMerchantInPersonInd

contactMethodMerchantWebformInd
C


contactMethodMerchantSMSInd
boolSMS/Text Message




Valid if

contactMethodWithMerchantInd =

true




When valid, at least one of the following fields must be set to

true:



contactMethodMerchantEmailInd

contactMethodMerchantCallCenterInd

contactMethodMerchantMailInd

contactMethodMerchantSMSInd

contactMethodMerchantInPersonInd

contactMethodMerchantWebformInd
C


contactMethodMerchantInPersonInd
boolIn-Person




Valid if

contactMethodWithMerchantInd =

true




When valid, at least one of the following fields must be set to

true:



contactMethodMerchantEmailInd

contactMethodMerchantCallCenterInd

contactMethodMerchantMailInd

contactMethodMerchantSMSInd

contactMethodMerchantInPersonInd

contactMethodMerchantWebformInd
C


contactMethodMerchantWebformInd
boolWebform/Application Name




Valid if

contactMethodWithMerchantInd =

true




When valid, at least one of the following fields must be set to

true:

contactMethodMerchantEmailInd

contactMethodMerchantCallCenterInd

contactMethodMerchantMailInd

contactMethodMerchantSMSInd

contactMethodMerchantInPersonInd

contactMethodMerchantWebformInd
C


contactMerchantDetailsPhoneNumber
stringPhone Number




Valid if

contactMethodMerchantCallCenterInd =

true or

contactMethodMerchantSMSInd =

true




Required when valid.
C


contactMerchantDetailsEmailAddress
stringEmail Address




Valid if

contactMethodMerchantEmailInd =

true




Required when valid.
C


contactMerchantDetailsPhysicalAddress
stringPhysical Address




Valid if

contactMethodMerchantWebformInd =

true or
contactMethodMerchantInPersonInd = true




Required when valid.
C


contactMerchantDetailsApplicationName
stringApplication Name




Valid if

contactMethodMerchantWebformInd =

true




Required when valid.
C


otherFormOfPaymentInd
boolOther Form of Payment




For other jurisdiction other than Europe regional or domestic:




Valid if

dispute_due_to =

CR (Cancelled Recurring Transaction) and

cancellationDate is not

null.
C


otherFormOfPaymentDesc
string Describe other form of payment




Valid if

otherFormOfPaymentInd =

true




Required when valid.
C


accountClosureDate
dateDate issuer informed merchant of account closure




For Europe regional or domestic within Europe:




Valid if

dispute_due_to =

CR (Cancelled Recurring Transaction) and (

merchantFacilitiesWithdrawn =

false AND

cardholderDeceased =

false)




Required when valid.




For all other jurisdiction other than Europe regional or domestic:




Valid if

dispute_due_to=

CR (Cancelled Recurring Transaction)




Required when valid.




Note: User can only provide either CancellationDate or AccountClosureDate for all jurisdictions.
C


cancellationMethod
stringCancellation Reason




Valid if

dispute_due_to =

CR (Cancelled Recurring Transaction) and user supplied value in

cancellationDate




Required when valid.
C



dispute_due_to =

CS(Cancelled Merchandise/Service)



attemptToResolveProhLocalLaw
stringIs attempt to resolve prohibited by local law or regulations? Valid values =


Y or

N

Valid if

dispute_due_to=

CS(Cancelled Merchandies/Services) and
cardholderAttemptToResolve=

N


Required when valid.

Note: If user inputs

N, then application will display hard-stop error prompting the cardholder must attempt to resolve the dispute with the merchant unless it’s prohibited by local law or regulations.

				</td>
				<td style="text-align:left"></td>
			</tr>
            <tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">cancellationPolicyProvidedInd</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Was a cancellation policy provided? 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>
					<strong>Required</strong> if 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> = 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">CS</code> (Cancelled Merchandise/Services) and any of the following is 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">true</code>:
					<br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">cardholderReceiveMerchandiseInd</code> = 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>; or
					<br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">didCardholderCancelBeforeShipping</code> = 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code>; or
					<br/>

(

serviceType =

G (Guaranteed Reservation); or


(

serviceType =

T (Timeshare) and

cancellationDate is 14 days greater than

timeshareDate)




Optional if

dispute_due_to =

CS (Cancelled Merchandise/Services) and (

serviceType =

O (Other) or

didCardholderCancelBeforeShipping =

N)

C


disputeRelateToOffpremisesDistanceSellInd
stringDoes the dispute relate to off-premises or distance selling contract? Valid values = Y or N.




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and jurisdiction is Europe regional or domestic within Europe for non T&E transactions and merchant is located in country other than Turkey, Switzerland and Israel.




Required when valid
C


cancellationDate
date

                    Cancellation Date.<br/><br/>
                     

					<strong>Required</strong> if <code>dispute_due_to</code> =<code>'CS'</code> (Cancelled Merchandise/Services) and <code>MerchandiseOrServices </code>=<code>'Services'</code> and <code>DidCardholderCancel</code>=<code>'Y'</code> or <code>CertificationGuaranteedReservation</code>=<code>'GR'</code> (The cardholder properly cancelled the guaranteed reservation) or <code>CertificationGuaranteedReservation</code>=<code>'RC'</code> (The cardholder attempted to cancel within 24 hours of delivery of the reservation confirmation) or <code>MerchandiseOrServices</code>=<code>'Merchandise'</code> and <code>DidCardholderCancelBeforeShipping</code> = <code>'Y'</code> or <code>MerchandiseOrServices</code>=<code>'Merchandise'</code> and <code>DidCardholderCancel</code>=<code>'Y'</code> and <code>CardholderReceiveMerchandiseInd</code>=<code>'N'</code>
					<br/>
					<br/>
					Optional if <code>DisputeDueTo</code>=<code>'CS'</code> (Cancelled Merchandise/Services) and <code>MerchandiseOrServices</code>=<code>'Merchandise'</code> and <code>DidCardholderCancelBeforeShipping</code>=<code>'N'</code>

				</td>
				<td style="text-align:left">C</td>
			</tr>
            <tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">cancellationMethod</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">

                    Cancellation Method
                    <br/>
					<br/>
					<strong>Required</strong> if <code>DisputeDueTo</code>=<code>'CS'</code> (Cancelled Merchandise/Services) and (<code>MerchandiseOrServices </code>=<code>'Services'</code> and <code>DidCardholderCancel</code>=<code>'Y'</code>) or (<code>MerchandiseOrServices</code>=<code>'Merchandise'</code> and <code>DidCardholderCancel</code>=<code>'Y'</code> and <code>CardholderReceiveMerchandiseInd</code>=<code>'N'</code>) or (<code>MerchandiseOrServices</code>=<code>'Merchandise'</code> and <code>DidCardholderCancelBeforeShipping</code>=<code>'Y'</code>)
                    <br/> 
					<br/>
					Optional if <code>DisputeDueTo</code>=<code>'CS'</code> (Cancelled Merchandise/Services) and <code>DidCardholderCancelBeforeShipping</code>=<code>'N'</code>

				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">disputeRelateToInd</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Is the dispute related to one of the following?
					<br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>
  • Price is dependent on fluctuations in the financial market.

  • Made to measure goods are supplied.

  • Goods are liable to deteriorate or expire rapidly.

  • Sealed goods, subject to health and safety provisions, are supplied.

  • Goods are not received in physical form (software download).

C


contractDate
dateContract date. Format = CCYY-MM-DD




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

disputeRelateToInd =

N




Required when valid
C


merchandiseOrServices
stringWhat was purchased?




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services)




Required when valid.
C


serviceType
stringType of service




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

merchandiseOrServices =

Services.




Required when valid.




Values:



T = Timeshare



G = Guaranteed Reservation



O = Other
C


whatWasPurchased
stringDescribe what was purchased?




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and (

merchandiseOrServices =

Merchandise or

serviceType =

O (Other))




Required when valid.
C


cardholderReceiveMerchandiseInd
stringDid cardholder receive the merchandise?

Y or

N.




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

merchandiseOrServices =

Merchandise




Required when valid.
C


chReceivedOrExpectedMerchandise
dateDate the cardholder received or expected to receive the merchandise. Format = CCYY-MM-DD




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

merchandiseOrServices =

Merchandise




Required when valid.
C


cardholderAttemptToResolve
stringDid the cardholder attempt to resolve the dispute with the merchant? Valid values = Y or N




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services)


Required when valid.




C


cardholderReturnMerchandiseInd
stringDid the cardholder return the merchandise?




Valid if

disputeDueTo =

ND (Not as Described) and

merchandiseOrServices =

Merchandise




Required when valid.
C


cardholderReturnedMerchandiseDate
dateDate cardholder returned the merchandise - CCYY-MM-DD




Valid if

disputeDueTo =

CS (Cancelled Merchandise/Services) and

cardholderReturnMerchandiseInd =

Y




Required when valid
C


returnedMerchandiseReceivedDate
dateDate merchant received returned merchandise. Format = CCYY-MM-DD




Valid if

disputeDueTo =

CS (Cancelled Merchandise/Services) and

cardholderReturnMerchandiseInd =

Y




Required when valid.
C


returnMethod
stringReturn Method




Required if

dispute_due_to =

CS (Cancelled Merchandise/Services)) and

cardholderReturnMerchandiseInd =

Y.




Values:



FF = Face to Face



FE= Fed Ex



D= DHL



U= UPS



P = Postal Service



O = Other
C


howMerchandiseReturned
stringExplain how the merchandise was returned




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

returnMethod=

O (Other)




Required when valid.
C


shippingTrackingNumber
stringTracking Number




Valid if

dispute_due_to=

CS (Cancelled Merchandise/Services) and (

returnMethod=

FE(FedEx) or

D(DHL) or

U(UPS) or

P(Postal Service) or

O' (Other))
C


cardholderAttemptReturnMerchandise
stringDid the cardholder attempt to return the merchandise?

Y or

N




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

cardholderReturnMerchandiseInd =

N.




Required when valid.
C


attemptedReturnDate
dateDate of attempted return. Format = CCYY-MM-DD




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

cardholderAttemptReturnMerchandise =

Y




Required when valid.
C


howChAttemptReturnAndDispOfMerchandise
stringProvide a detailed description of how the cardholder attempted to return merchandise




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

cardholderAttemptReturnMerchandise =

Y


Required when valid.
C


merchantRefuseAdvise
string Provide certification of one of the following




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

merchandiseOrServices =

Merchandise and

cardholderAttemptReturnMerchandise =

Y


Required when valid.




Values:



MRRM = Merchant refused to accept returned merchandise



MICNRM = Merchant informed cardholder not to return the merchandise
C


didCardholderCancel
stringDid the cardholder cancel?

Y or

N




Required if

dispute_due_to =

CS (Cancelled Merchandise/Services) and (

cardholderReceiveMerchandiseInd =

N or

serviceType =

O (Other) or

T=(Timeshare))




Optional when

dispute_due_to =

CS (Cancelled Merchandise/Services) and

cardholderReceiveMerchandiseInd =

Y




Note: If

serviceType =

O (Other) and user inputs

N, then application will display hard stop error.
C


didCardholderCancelBeforeShipping
stringDid cardholder cancel before ship date?

Y or

N




Required if

dispute_due_to=

CS (Cancelled Merchandise/Services) and

cardholderReceiveMerchandiseInd =

Y and

didCardholderCancel =

Y
C


timeshareDate
dateDate of the timeshare, or the date the contract or related documents were received. Format = CCYY-MM-DD




For Non-Europe Regions:


Required if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

serviceType =

T (Timeshare).




For Europe Regions:


Required if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

serviceType =

T (Timeshare) and

disputeRelateToInd is

Y




Optional if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

serviceType =

T (Timeshare) and

disputeRelateToInd is

N
C


dateOfService
dateDate of service or expected service. Format = CCYY-MM-DD




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

serviceType=

G (Guaranteed Reservation) or

O (Other)




Required when valid.
C


certificationGuaranteedReservation
stringCertification of one of the following




Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

serviceType =

G (Guaranteed Reservation)


Required when valid.




Values:



GR - The cardholder properly cancelled the guaranteed reservation



RC - The cardholder attempted to cancel within 24 hours of delivery of the reservation confirmation



AR - The merchant billed a no show transaction for more than one day’s accommodation or rental
C
dispositionOfMerchandisestringWhat is the disposition of the merchandise?

					Valid if <button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> = 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">CS</code> (Cancelled Merchandise/Services) and 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">CardholderAttemptReturnMerchandise</code> = 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code>
					<br/><br/>
					<strong>Required</strong> when valid.
					<br/>
					<br/></td>
					<td style="text-align:left">C</td></tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">merchantAcceptInd</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Did the merchant accept cancellation? <code>Y</code> or <code>N</code>.
					<br/>
					<br/>

Valid if

dispute_due_to =

CS (Cancelled Merchandise/Services) and

merchandiseOrServices=

Merchandise and

didCardholderCancelBeforeShipping = Y and

cancellationDate = less than or equal to 15 days prior to today


Required when valid

C



dispute_due_to =

CM(Counterfeit Merchandise)

Note: Documentation is required.
C
C


descCounterfeitMerchandise
stringDescribe the counterfeit merchandise




Valid if

dispute_due_to =

CM (Counterfeit Merchandise)


Required when valid.
C


descDispOfCounterfeitMerchandise
stringDescribe the disposition of the counterfeit merchandise




Valid if

dispute_due_to =

CM (Counterfeit Merchandise)


Required when valid
C



dispute_due_to =

OC(Original Credit Not Accepted)



originalCreditNotAccepted
stringCertification that an original credit transaction was not accepted because either




Valid if

dispute_due_to =

OC (Original Credit Not Accepted) and if disputed transaction is an original credit (

TranType =

Credit).


Required when valid.




Values:



R = Recipient refused the original credit



O = Original credit prohibited by local laws or regulations
C


explain
stringExplain




Valid if

dispute_due_to =

OC (Original Credit Not Accepted)


Required when valid
C



dispute_due_to =

CN(Credit Not Processed)



creditVoucherTransactionReceipt
string
Was a credit voucher, voided transaction receipt or refund acknowledgement given?




Valid if

dispute_due_to =

CN (Credit Not Processed)



Required when valid



Note: If user inputs 'N', then application will display hard-stop error.

				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">creditVoucherTransactionReceiptDated</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Is the credit voucher, transaction receipt, or refund acknowledgement dated? 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>

Valid if

dispute_due_to =

CN (Credit Not Processed) and

creditVoucherTransactionReceipt =

Y.


Required when valid documentation is required.

C


creditVoucherOrTransactionReceiptDate
dateDate of credit voucher, transaction receipt or refund acknowledgement




Valid if

dispute_due_to =

CN (Credit Not Processed) and

creditVoucherTransactionReceiptDated =

Y


Required when valid documentation is required.
C


cardholderCancelledReturnedMerchDate
dateDate the cardholder cancelled the service or returned the merchandise. Format = CCYY-MM-DD




Valid if

dispute_due_to =

CN (Credit Not Processed) and

creditVoucherTransactionReceiptDated=

N


Required when valid
C


explainCreditIssuedLateDetailsOfNegotiations
stringExplanation for credit issued late details of negotiation




Valid if

dispute_due_to =

CN (Credit not processed) and

creditVoucherOrTransactionReceiptDate or

CardholderCancelledReturnedMerchDate greater than 120 days from processing date.


Required when valid
C



dispute_due_to =

NR(Merchandise/Services Not Received)

Note: Not applicable for ATM transactions.


merchantCancelMerchandiseDate
dateDate merchant cancelled merchandise




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received).


Required when valid.
C


merchantInLiquidationOrReceivershipInd
stringIs the merchant in liquidation or receivership?

Y or

N




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and jurisdiction is France domestic.


Required when valid.
C


whatWasNotReceived
stringValid if

dispute_due_to =

NR (Merchandise/Services Not Received)


Required when valid.




Values:



M = Merchandise,



S = Services




Notes:



  1. VROL searches for existing 'Merchandise/Services Not Received' disputes for same card #, same merchant where all of the disputed transactions occurred within the 30-calendar day period (original transaction date of disputed transactions is within 30 calendar days). For Parcelado dispute, the transaction date of original authorization request should be considered.



  2. VROL needs to count all transactions with same transaction Id as a single dispute.




    If VROL search results into 2 or more disputes for same card number, user must attach a 'Cardholder Letter' document with any doc type to the dispute QN starting 3rd dispute else application will display a hard stop error.

C


thirdPartyGiftCardInd
stringIs the purchase 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?

Y or

N




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received)


Required when valid.
C


visaComCardVirtualAccInd
stringDoes the dispute involve a Visa Commercial Card Virtual Account?

Y or

N




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

whatWasNotReceived =

S (Services) and productId from original transaction =

G,

K,

S or

X


Required when valid.
C


virtualAccFinancialLossInd
stringDid virtual account holder suffer a financial loss?

Y or

N




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

visaComCardVirtualAccInd =

Y


Required when valid.
C


didMerchantCancelInd
stringDid merchant cancel services?



Y or

N




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

whatWasNotReceived =

S (Services)


Required when valid.
C


merchantCancellationDate
dateDate merchant cancelled services. Format = CCYY-MM-DD




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

didMerchantCancelInd =

Y


Required when valid.
C


nonReceiptOfTravelServicesInd
stringDoes the dispute relate to non-receipt of travel services from a merchant that was unable to provide services due to insolvency/bankruptcy?



Y or

N




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

whatWasNotReceived =

S (Services).


Required when valid.




Note: Valid for Europe Regional or Europe Domestic disputes
C


disputeInvolveBondingAuthorityInd
stringWas there a bond/insurance scheme?



Y or

N




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

nonReceiptOfTravelServicesInd =

Y


Required when valid.




Note: Valid for Europe Regional or Europe Domestic disputes
C


explainAttemptToResolveWithBondAuth
stringProvide an explanation of the attempt to resolve the dispute with the bonding authority/insurance scheme (advice or guidance given) or where the information was obtained to confirm an insufficient bond/insurance scheme.




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

nonReceiptOfTravelServicesInd =

Y



Required when valid.
C


purchasedInfo
stringProvide detailed description of what was purchased and an explanation of the dispute




Required if



dispute_due_to =

NR (Merchandise/Services Not Received) and

purchaseInfoAvailableInd =

False




Optional if

dispute_due_to =

NR (Merchandise/Services Not Received) and

purchaseInfoAvailableInd= `True
C


expectedReceiptDate
dateWhat was the last expected receipt date? Format = CCYY-MM-DD




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received)


Required when valid
C


expectedReceiptTime
stringWhat was the last expected receipt time?




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received)
C


explainDisputePriorDeliveryDate
stringExplanation of dispute initiated prior to the expected delivery date




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

expectedReceiptDate= Future Date


Required when valid
C


didCardholderCancelPriorExpectedDate
stringDid the cardholder cancel prior to the expected date?

Y or

N




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and (

whatWasNotReceived =

M (Merchandise) or

whatWasNotReceived =

S (Services))


Required when valid
C


cancellationDate
dateCancellation Date




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

didCardholderCancelPriorExpectedDate=

Y.


Required when valid.
C


cancellationMethod
stringCancellation Reason




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

didCardholderCancelPriorExpectedDate =

Y


cardholderAttemptToResolve
stringDid the cardholder attempt to resolve the dispute with the merchant?

Y or

N




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and (

whatWasNotReceived =

M (Merchandise) or

whatWasNotReceived =

S (Services)).


Required when valid.
C


attemptToResolveProhLocalLaw
stringIs attempt to resolve prohibited by local law or regulations? Valid values = Y or N.




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

cardholderAttemptToResolve =

N.



Required when valid.




Note: If user inputs

N, then application will display hard-stop error prompting the cardholder must attempt to resolve the dispute with the merchant unless it’s prohibited by local law or regulations.


merchandiseDeliveredWrongLocation
stringWas the merchandise delivered to the incorrect location?

Y or

N



Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

whatWasNotReceived=

M (Merchandise).



Required when valid.



lateDeliveryWrongLocation
stringProvide address of the agreed location or details of late delivery




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

merchandiseDeliveredWrongLocation =

Y or
merchandiseDeliveredLate =

Y



Required when valid.
N/A


cardholderReturnMerchandiseInd
stringDid the cardholder return the merchandise?

Y or

N




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

whatWasNotReceived=

M (Merchandise) and

merchandiseDeliveredLate=

Y



Required when valid.
C


cardholderReturnedMerchandiseDate
dateDate cardholder returned the merchandise. Format = CCYY-MM-DD




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

cardholderReturnMerchandiseInd=

Y


Required when valid
C


returnedMerchandiseReceivedDate
dateDate merchant received returned merchandise. ormat = CCYY-MM-DD




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

cardholderReturnMerchandiseInd=

Y


Required when valid
C


cardholderAttemptReturnMerchandise
stringDid the cardholder attempt to return the merchandise?

Yor

N




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and

cardholderReturnMerchandiseInd=

N.


Required when valid
C


attemptedReturnDate
dateDate of attempted return. Format = CCYY-MM-DD




Valid if

dispute_due_to=

NR (Merchandise/Services Not Received) and



cardholderAttemptReturnMerchandise=

Y.


Required when valid.
C


didMerchantCancelMerchandiseInd
stringDid merchant cancel the merchandise?

Yor

N




Valid if

dispute_due_to =

NR (Merchandise/Services Not Received) and

whatWasNotReceived=

M (Merchandise).


Required when valid.
C
C
C
C
C


cardholderMerchantPreviousNegotiationEvidence
stringIs there evidence of previous ongoing negotiations between the cardholder and merchant?

Y or

N




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and DateDiff(
, Today())>120 and DateDiff( Disputed Transaction's Processing Date, Today())>120


Required when valid.
C


whenNegotiationsBegin
dateWhen did the negotiations begin? Format = CCYY-MM-DD.




Valid if

dispute_due_to =

DM (Damaged or Defective Merchandise) and

cardholderMerchantPreviousNegotiationEvidence='Y'


Required when valid.
C


explainPrevNegotiation
stringExplain the previous ongoing negotiations between the cardholder and merchant.




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and

cardholderMerchantPreviousNegotiationEvidence=

Y



Required when valid.
C


cardholderFirstNotifiedIssuerDisputeDate
dateDate the cardholder first notified the issuer of the dispute. Format = CCYY-MM-DD.




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and

cardholderMerchantPreviousNegotiationEvidence=

Y




Required when valid
C


cardholderAttemptToResolve
stringDid the cardholder attempt to resolve the dispute with the merchant?

Y or

N




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise).


Required when valid.
C


attemptToResolveProhLocalLaw
stringIs attempt to resolve prohibited by local law or regulations? Valid values = Y or N.




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and

cardholderAttemptToResolve=

N.


Required when valid.




Note: If user inputs

N, then application will display hard-stop error prompting the cardholder must attempt to resolve the dispute with the merchant unless it’s prohibited by local law or regulations.
C


cardholderReturnMerchandiseInd
stringDid the cardholder return the merchandise?




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise).



Required when valid.
C


cardholderReturnedMerchandiseDate
dateDate cardholder returned the merchandise. Format = CCYY-MM-DD




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and

cardholderReturnMerchandiseInd='Y'.


Required when valid
C


merchantReceivedReturnedMerchandiseDate
dateDate merchant received the returned merchandise. Format = CCYY-MM-DD




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and

cardholderReturnMerchandiseInd=

Y.


Required when valid.
C


returnMethod
stringReturn Method




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and



cardholderReturnMerchandiseInd=

Y


Required when valid.




Domain Values:



FF=Face to Face



FE=Fed Ex



D=DHL



U=UPS



P= Postal Service



O=Other
C


shippingTrackingNumber
stringTracking Number




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and (

returnMethod=

FE(FedEx) OR

D(DHL) OR

U(UPS) OR

P(Postal Service)).
C


howMerchandiseReturned
stringExplain how the merchandise was returned




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and

returnMethod=

O (Other)


Required when valid
C


cardholderAttemptReturnMerchandise
stringDid the cardholder attempt to return the merchandise?

Y or

N




Valid if

dispute_due_to=

ND (Not as Described) and

cardholderReturnMerchandiseInd='N'.



Required when valid.
C


attemptedReturnDate
dateDate of attempted return. Format = CCYY-MM-DD




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and



cardholderAttemptReturnMerchandise=

Y.


Required when valid.
C


howChAttemptReturnAndDispOfMerchandise
stringProvide a detailed description of how the cardholder attempted to return merchandise.




Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and

cardholderAttemptReturnMerchandise=

Y




Required when valid.
C


merchantRefuseAdvise
stringProvide certification of one of the following

					<br/>

Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and <

CardholderAttemptReturnMerchandise>=

Y




Required when valid.




Values:

					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MRRM</code> = Merchant refused to accept returned merchandise
					<br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MICNRM</code> = Merchant informed cardholder not to return the merchandise
					<br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MNLER</code> = Merchant no longer exists or is not responding
				    <br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MNPCIR</code> = Merchant did not provide clear instruction on how to return
				
				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispositionOfMerchandise</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">What is the disposition of the merchandise?
					<br/>
		

Valid if ='DM' (Damaged or Defective Merchandise) and ='Y'.

					<br/>

Valid if

dispute_due_to=

DM (Damaged or Defective Merchandise) and
CardholderAttemptReturnMerchandise = Y




Required when valid.

C



dispute_due_to =

M(Misrepresentation)

C


merchandiseReceivedDate
dateDate merchandise was received. Format = CCYY-MM-DD




Valid if

dispute_due_to =

M (Misrepresentation) and

merchandiseOrServices =

Merchandise.




Required when valid.
C


serviceReceivedDate
dateDate services were received. Format = CCYY-MM-DD




Valid if

dispute_due_to =

M (Misrepresentation) and

merchandiseOrServices =

Services




Required when valid.
C


cardholderMerchantPreviousNegotiationEvidence
string Is there evidence of previous ongoing negotiations between the cardholder and merchant?

Y or

N




Valid if

dispute_due_to =

Q (Quality) and DateDiff(

merchandiseReceivedDate OR

serviceReceivedDate, Today())>120 and DateDiff( Disputed Transaction's Processing Date, Today())>120



					<strong>Required</strong> when valid.
				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">whenNegotiationsBegin</code>
				</td>
				<td style="text-align:left">date</td>
				<td style="text-align:left">When did the negotiations begin?
					<br/>
					<br/>

Valid if

dispute_due_to =

M (Misrepresentation) and

cardholderMerchantPreviousNegotiationEvidence =

Y




Required when valid.

C


explainPrevNegotiation
stringExplain the previous ongoing negotiations between the cardholder and merchant




Valid if

dispute_due_to =

M'(Misrepresentation) and

cardholderMerchantPreviousNegotiationEvidence =

Y




Required when valid.
C


cardholderFirstNotifiedIssuerDisputeDate
dateDate the cardholder first notified the issuer of the dispute. Format = CCYY-MM-DD




Valid if

dispute_due_to =

M (Misrepresentation) and

cardholderMerchantPreviousNegotiationEvidence =

Y




Required when valid
C


whatWasPurchased
stringProvide details of what was purchased




Valid if

dispute_due_to =

M (Misrepresentation)


Required when valid.
C


howMerchandiseOrServiceMisrepresented
stringHow was the merchandise or service misrepresented?




Valid if

dispute_due_to =

M (Misrepresentation)


Required when valid.
C


didCardholderCancel
stringDid the cardholder cancel the services?

Y or

N




Valid if

dispute_due_to =

M (Misrepresentation) and

merchandiseOrServices =

Services


Required when valid.
C


cancellationDate
dateCancellation Date. Format = CCYY-MM-DD




Valid if

dispute_due_to =

M (Misrepresentation) and

didCardholderCancel =

Y


Required when valid.
C


cancellationMethod
stringCancellation Reason




Valid if

dispute_due_to =

M (Misrepresentation) and

didCardholderCancel =

Y


Required when valid.
C


cardholderAttemptToResolve
stringDid the cardholder attempt to resolve the dispute with the merchant?

Y or

N




Valid if

dispute_due_to =

M (Misrepresentation) and (

didCardholderCancel =

Y or

merchandiseOrServices =

Merchandise)


Required when valid.
C


attemptToResolveProhLocalLaw
stringIs attempt to resolve prohibited by local law or regulations?

Y or

N




Valid if

dispute_due_to =

M (Misrepresentation) and

cardholderAttemptToResolve =

N


Required when valid.




Note: If user inputs

N, then application will display hard-stop error prompting the cardholder must attempt to resolve the dispute with the merchant unless it's prohibited by local law or regulations.
C


cardholderReturnMerchandiseInd
stringDid the cardholder return the merchandise?

Y or

N




Valid if

dispute_due_to =

M (Misrepresentation) and

merchandiseOrServices =

Merchandise


Required when valid.
C


cardholderReturnedMerchandiseDate
dateDate cardholder returned the merchandise. Format = CCYY-MM-DD




Valid if

dispute_due_to =

M (Misrepresentation) and

cardholderReturnMerchandiseInd =

Y


Required when valid
C


returnedMerchandiseReceivedDate
dateDate cardholder returned the merchandise




Valid if

dispute_due_to =

M (Misrepresentation) and

cardholderReturnMerchandiseInd =

Y


Required when valid
C


returnMethod
stringReturn Method




Valid if

dispute_due_to =

M (Misrepresentation) and

cardholderReturnMerchandiseInd =

Y


Required when valid




Values:



FF= Face to Face



FE= Fed Ex



D= DHL



U= UPS



P= Postal Service



O= Other
C


howMerchandiseReturned
stringExplain how the merchandise was returned




Valid if

dispute_due_to =

M (Misrepresentation) and

returnMethod =

O (Other)


Required when valid
C


shippingTrackingNumber
stringTracking number




Valid if

dispute_due_to =

M (Misrepresentation) or ReturnMethod= 'FE'(FedEx) or 'D'(DHL) or 'U'(UPS) or 'P'(Postal Service) or 'O' (Other)

					<br/><br/>
					<strong>Required</strong> when valid.
				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">cardholderAttemptReturnMerchandise</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Did the cardholder attempt to return the merchandise? 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>

Valid if

dispute_due_to =

M (Misrepresentation) and

CardholderReturnMerchandiseInd =

N.


Required when valid.

C


attemptedReturnDate
dateDate of attempted return. Format = CCYY-MM-DD




Valid if

dispute_due_to =

M (Misrepresentation) and

CardholderAttemptReturnMerchandise =

Y


Required when valid.


howChAttemptReturnAndDispOfMerchandise
stringProvide a detailed description of how the cardholder attempted to return merchandise




Valid if

dispute_due_to =

M (Misrepresentation) and

CardholderAttemptReturnMerchandise =

Y
C


merchantRefuseAdvise
stringProvide certification of one of the following




Valid if

dispute_due_to =

M (Misrepresentation) and

merchandiseOrServices =

Merchandise and

cardholderAttemptReturnMerchandise =

Y


Required when valid.




Values:



					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MRRM</code> = Merchant refused to accept returned merchandise
					<br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MICNRM</code> = Merchant informed cardholder not to return the merchandise
				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left; background-color:beige" colspan=4>
					<strong>
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">dispute_due_to</code> = 
						<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
						<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">ND</code>(Not as Described) 
					</strong>
				</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">merchandiseOrServices</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">What was purchased?
					<br/>
					<br/>

Valid if

dispute_due_to =

ND (Not as Described).


Required when valid.

C


merchandiseServiceReceivedDate
dateDate merchandise or service was received. Format = CCYY-MM-DD




Valid if

dispute_due_to =

ND (Not as Described)


Required when valid.
C


cardholderMerchantPreviousNegotiationEvidence
stringIs there evidence of previous ongoing negotiations between the cardholder and merchant?

Y or

N




Valid if

dispute_due_to =

ND (Not as Described) and DateDiff(

merchandiseServiceReceivedDate, Today())>120 and DateDiff( Disputed Transaction's Processing Date, Today())>120


Required when valid.
C


whenNegotiationsBegin
dateWhen did the negotiations begin? Format = CCYY-MM-DD




Valid if

dispute_due_to =

ND (Not as Described) and

cardholderMerchantPreviousNegotiationEvidence='Y'


Required when valid.
C


explainPrevNegotiation
stringExplain the previous ongoing negotiations between the cardholder and merchant




Valid if

dispute_due_to =

ND (Not as Described) and

cardholderMerchantPreviousNegotiationEvidence =

Y


Required when valid.


cardholderFirstNotifiedIssuerDisputeDate
dateDate the cardholder first notified the issuer of the dispute. Format = CCYY-MM-DD




Valid if

dispute_due_to =

ND (Not as Described) and

cardholderMerchantPreviousNegotiationEvidence =

Y




Required when valid
C


orderDetailsNotAsDescribed
stringProvide details of what was ordered and not as described




Valid if

dispute_due_to =

ND (Not as Described)


Required when valid
C


cardholderAttemptToResolve
stringDid the cardholder attempt to resolve the dispute with the merchant?

Y or

N




Valid if

dispute_due_to =

ND (Not as Described)


Required when valid.
C


attemptToResolveProhLocalLaw
stringIs attempt to resolve prohibited by local law or regulations?

Y or

N




Valid if

dispute_due_to =

ND (Not as Described) and

cardholderAttemptToResolve =

N.


Required when valid.




Note: If user inputs

N, then application will display hard-stop error prompting the cardholder must attempt to resolve the dispute with the merchant unless it's prohibited by local law or regulations.
C


cardholderReturnMerchandiseInd
stringDid the cardholder return the merchandise. Y or N.




Valid if

dispute_due_to =

ND (Not as Described) and

merchandiseOrServices =

'Merchandise'.


Required when valid
C


merchantReceivedReturnedMerchandiseDate
dateDate merchant received the returned merchandise. Format = CCYY-MM-DD




Valid if

dispute_due_to =

ND (Not as Described) and

cardholderReturnMerchandiseInd =

Y.


Required when valid.
C


returnMethod
stringReturn Method




Valid if

dispute_due_to =

ND (Not as Described) and



cardholderReturnMerchandiseInd =

Y


Required when valid.




Values:



FF = Face to Face



FE = Fed Ex



D = DHL



U = UPS



P = Postal Service



O = Other
C


shippingTrackingNumber
stringTracking Number




Valid if

dispute_due_to =

ND (Not as Described) and


(

returnMethod =

FE(FedEx) OR

D(DHL) OR

U (UPS) OR

P(Postal Service)) OR

O(Other)).
C


howMerchandiseReturned
stringExplain how the merchandise was returned




Valid if

dispute_due_to =

ND (Not as Described) and

returnMethod =

O (Other)


Required when valid
C


cardholderAttemptReturnMerchandise
stringDid the cardholder attempt to return the merchandise?

Y or

N




Valid if

dispute_due_to =

ND (Not as Described) and

cardholderReturnMerchandiseInd =

N.



Required when valid.
C


attemptedReturnDate
dateDate of attempted return. Format = CCYY-MM-DD




Valid if

dispute_due_to =

ND (Not as Described) and



cardholderAttemptReturnMerchandise =

Y.


Required when valid.
C


howChAttemptReturnAndDispOfMerchandise
stringProvide a detailed description of how the cardholder attempted to return merchandise




Valid if

dispute_due_to=

ND (Not as Described) and

cardholderAttemptReturnMerchandise=

Y


Required when valid.
C


merchantRefuseAdvise
stringProvide certification of one of the following




Valid if

dispute_due_to =

ND (Not as Described) and

merchandiseOrServices =

Merchandise and

cardholderAttemptReturnMerchandise =

Y


Required when valid.




Values:

					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MRRM</code> = Merchant refused to accept returned merchandise
					<br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MICNRM</code> = Merchant informed cardholder not to return the merchandise
				    <br/>
					<code>MNLER</code> = Merchant no longer exists or is not responding
					<br/>
					<code>MNPCIR</code> = Merchant did not provide clear instruction on how to return

				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">didCardholderCancel</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Did the cardholder cancel the services? 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>

Valid if

dispute_due_to =

ND (Not as Described) and



merchandiseOrServices =

Services'


Required when valid.

C


cancellationDate
dateCancellation Date. Format = CCYY-MM-DD




Valid if

dispute_due_to =

ND (Not as Described) and



didCardholderCancel =

Y.


Required when valid.
C


cancellationMethod
stringCancellation Reason




Valid if

dispute_due_to =

ND (Not as Described) and



didCardholderCancel =

Y.


Required when valid.
C


merchantAcceptCancellationInd
stringDid the merchant accept the cancellation?

Y or

N




Valid if

dispute_due_to =

ND (Not as Described) and

merchandiseOrServices =

Services and

didCardholderCancel =

Y and

cancellationDate is less than or equal to 15 days prior to current date.


Required when valid.
C


qualityOfFoodInd
stringIs dispute related to the quality of food received from eating places or restaurants?

Y or

N




Valid if

dispute_due_to =

ND (Not as Described) and

merchandiseOrServices =

Services and

MCC is

5812,

5813 or

5814.


Required when valid.
C


cancellationMethod
stringCancellation Reason




Valid if

dispute_due_to =

ND (Not as Described) and



didCardholderCancel =

Y.


Required when valid.
C


nonFiatCurrencyNotMatching
stringWas non-fiat currency or purchase of non-fungible token(s) (NFT), the non-fiat currency or non-fungible token received by the cardholder did not match the description provided at the time of the transaction? Y or N.




Valid if

dispute_due_to =

ND (Not as Described) and



MerchandiseOrServices =

Services.



Required when valid.
C


dispositionOfMerchandise
stringWhat is the disposition of the merchandise?




Valid if

dispute_due_to =

ND (Not as Described) and



CardholderAttemptReturnMerchandise =

Y.



Required when valid.
C



dispute_due_to =

Q(Quality)



merchandiseOrServices
stringWhat was purchased?




Valid if

dispute_due_to= 'Q' (Quality).
C


merchandiseReceivedDate
dateDate merchandise was received. Format = CCYY-MM-DD




Valid if

dispute_due_to =

Q (Quality) and

merchandiseOrServices =

Merchandise.


Required when valid.
C


serviceReceivedDate
dateDate services were received. Format = CCYY-MM-DD




Valid if

dispute_due_to =

Q (Quality) and

merchandiseOrServices =

Services'


Required when valid.
C


cardholderMerchantPreviousNegotiationEvidence
stringIs there evidence of previous ongoing negotiations between the cardholder and merchant?

Y or

N




Valid if

dispute_due_to =

Q (Quality) and DateDiff(

merchandiseReceivedDate OR

serviceReceivedDate, Today())>120 and DateDiff( Disputed Transaction's Processing Date, Today())>120


Required when valid.
C


whenNegotiationsBegin
dateWhen did the negotiations begin? Format = CCYY-MM-DD




Valid if

dispute_due_to =

Q (Quality) and

cardholderMerchantPreviousNegotiationEvidence =

Y


Required when valid.
C


explainPrevNegotiation
stringExplain the previous ongoing negotiations between the cardholder and merchant




Valid if

dispute_due_to =

Q (Quality) and

cardholderMerchantPreviousNegotiationEvidence =

Y


Required when valid.
C


cardholderFirstNotifiedIssuerDisputeDate
dateDate the cardholder first notified the issuer of the dispute. Format = CCYY-MM-DD




Valid if

dispute_due_to =

Q (Quality) and

cardholderMerchantPreviousNegotiationEvidence =

Y




Required when valid
C


cardholderAttemptToResolve
stringDid the cardholder attempt to resolve the dispute with the merchant?

Y or

N




Valid if

dispute_due_to =

Q (Quality)


Required when valid.
C


attemptToResolveProhLocalLaw
stringIs attempt to resolve prohibited by local law or regulations?

Y or

N




Valid if

dispute_due_to =

Q (Quality) and

cardholderAttemptToResolve =

N.


Required when valid.




Note: If user inputs

N, then application will display hard-stop error prompting the cardholder must attempt to resolve the dispute with the merchant unless it's prohibited by local law or regulations.
C


cardholderReturnMerchandiseInd
stringDid the cardholder return the merchandise?

Y or

N




Valid if

dispute_due_to =

Q (Quality) and

merchandiseOrServices=

Merchandise .


Required when valid.
C


cardholderReturnedMerchandiseDate
dateDate cardholder returned the merchandise. Format = CC-YY-MM




Valid if

dispute_due_to =

Q (Quality) and

cardholderReturnMerchandiseInd =

Y.


Required when valid.
C


merchantReceivedReturnedMerchandiseDate
dateDate merchant received the returned merchandise. Format = CCYY-MM-DD




Valid if

dispute_due_to =

Q (Quality) and

cardholderReturnMerchandiseInd =

Y.


Required when valid.
C


returnMethod
stringReturn Method




Valid if

dispute_due_to =

Q (Quality) and

cardholderReturnMerchandiseInd =

Y


Required when valid.




Values:



FF= Face to Face



FE= Fed Ex



D= DHL



U = UPS



P = Postal Service



O= Other
C


howMerchandiseReturned
stringExplain how the merchandise was returned




Valid if

dispute_due_to =

Q (Quality) and

returnMethod =

O (Other)


Required when valid
C


shippingTrackingNumber
stringTracking Number




Valid if

dispute_due_to =

Q (Quality) and


(

returnMethod =

FE(FedEx) OR

D (DHL) OR

U (UPS) OR

P(Postal Service) OR

O (Other)).
C


didCardholderPayWorkRedone
stringDid the cardholder pay to have the work redone?

Y or

N




Valid if

dispute_due_to =

Q (Quality) and

merchandiseOrServices =

Services


Required when valid.
C


cardholderAttemptReturnMerchandise
stringDid the cardholder attempt to return the merchandise?

Y or

N




Valid if

dispute_due_to =

Q (Quality) and

CardholderReturnMerchandiseInd =

N.


Required when valid.
C


attemptedReturnDate
dateDate of attempted return. Format = CCYY-MM-DD




Valid if

dispute_due_to =

Q (Quality) and



cardholderAttemptReturnMerchandise =

Y.


Required when valid.
C


howChAttemptReturnAndDispOfMerchandise
stringProvide a detailed description of how the cardholder attempted to merchandise




Valid if

dispute_due_to =

Q (Quality) and

cardholderAttemptReturnMerchandise =

Y


Required when valid.
C


merchantRefuseAdvise
stringProvide certification of one of the following




Valid if

dispute_due_to =

Q (Quality) and

merchandiseOrServices =

Merchandise and

cardholderAttemptReturnMerchandise =

Y


Required when valid.




Values:

					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MRRM</code> = Merchant refused to accept returned merchandise
					<br/>
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">MICNRM</code> = Merchant informed cardholder not to return the merchandise
					<br/>
					<code>MNLER</code> = Merchant no longer exists or is not responding
					<br/>
					<code>MNPCIR</code> = Merchant did not provide clear instruction on how to return
				</td>
				<td style="text-align:left">C</td>
			</tr>
			<tr>
				<td style="text-align:left">
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">didCardholderCancel</code>
				</td>
				<td style="text-align:left">string</td>
				<td style="text-align:left">Did the cardholder cancel the services? 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Y</code> or 
					<button aria-label="Copy Code" class="rdmd-code-copy fa"></button>
					<code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">N</code>
					<br/>
					<br/>

Valid if

dispute_due_to =

Q (Quality) and

merchandiseOrServices=

Services'


Required when valid.

C


cancellationDate
dateCancellation Date. Format = CCYY-MM-DD




Valid if

dispute_due_to =

Q (Quality) and

didCardholderCancel =

Y


Required when valid.
C


cancellationMethod
stringCancellation Reason




Valid if

dispute_due_to =

Q (Quality) and

didCardholderCancel =

Y


Required when valid.
C


merchantAcceptCancellationInd
stringDid the merchant accept the cancellation?

Y or

N




Valid if

dispute_due_to =

Q (Quality) and

merchandiseOrServices =

Services and

didCardholderCancel =

Y and

cancellationDate is less than or equal to 15 days prior to current date.


Required when valid.
C


qualityOfFoodInd
stringIs dispute related to the quality of food received from eating places or restaurants?

Y or

N




Valid if

dispute_due_to =

Q (Quality) and

MerchandiseOrServices =

Services and

MCC is

5812,

5813 or

5814


Required when valid.
C


nonFiatCurrencyNotMatching
stringWas non-fiat currency or purchase of non-fungible token(s) (NFT), the non-fiat currency or non-fungible token received by the cardholder did not match the description provided at the time of the transaction? Y or N




Valid if

dispute_due_to =

Q (Quality) and

MerchandiseOrServices =

Services



Required when valid.
C
C



dispute_due_to =

TC(Terms of Contract)



serviceReceivedDate
dateDate service were received. Format = CCYY-MM-DD




Required if

dispute_due_to =

TC (Terms of Contract (Virtual Account)) and Current Date is greater than 120 days from Disputed Transaction's Processing Date.




Optional if

dispute_due_to =

TC (Terms of Contract (Virtual Account)) and Current Date is less than 120 days from Disputed Transaction's Processing Date.
C


howTermsOfContractNotHonoredByMerchant
stringProvide details how the terms of the contract were either not honored by the merchant or not as described




Valid if

dispute_due_to=

TC (Terms of Contract (Virtual Account))




Required when valid.
C



dispute_due_to =

CL(Non-Receipt of Cash)

Note: Not applicable for non-ATM transactions.


whatWasNotReceived
stringWhat was not received?




Valid if

dispute_due_to =

CL (Non-Receipt of Cash)


Required when valid.




If not provided then application will default to domain value

C. If provided with any value other than

C then application will display an error.




Values:



C = Cash (Note: Case-sensitive, must be capital C)




Note: VROL searches for existing 'Non-Receipt of Cash' disputes for same card #, same merchant where all of the disputed transactions occurred within the 30-calendar day period (original transaction date of disputed transactions is within 30 calendar days)




If VROL search results in 2 or more disputes for same card number, user must attach a 'Cardholder Letter' document with any doc type to the dispute QN starting 3rd dispute else application will display a hard stop error.
C

Did this page help you?