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 <= 180 calendar days from Transaction Date for non adjustment transaction or if Processing Date <= 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:
-
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.
-
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'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'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'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&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 | string | Explain 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 | number | Processed 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) andincorrectCurrencyReason=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 | string | Certification that the Cardholder did not agree to Dynamic Currency Conversion and did not make an active choice. Valid values = Y orN.Valid if dispute_due_to=IC (Incorrect Currency) andincorrectCurrencyReason=DD (DCC Dispute)Required when valid. | C | |
dispute_due_to =IT (Incorrect Transaction Code) | C | |||
rolTransactionId | long | Valid ifdispute_due_to=IT (Incorrect Transaction Code) andtransactionCodeIncorrect=CRI (Credit instead of reversal or adjustment)This will be VROL internal transaction id. User must provide one of the two fields rolTransactionId orincorrectTransactionId. These fields will be used to initiate transaction inquiry to search for supporting transaction. If provided, this field will take precedence overincorrectTransactionId. | C | |
incorrectTransactionId | string | Valid ifdispute_due_to=IT (Incorrect Transaction Code) andtransactionCodeIncorrect=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 | string | Explain why the credit refund was processed in error Valid if dispute_due_to=IT (Incorrect Transaction Code) andtransactionCodeIncorrect=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 existsThis 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 existsThis 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 existsThis is VROL internal transaction id | C | |
dispute_due_to =IA (Incorrect Amount) | C | |||
| C | ||||
issuerEvidenceMerchantPassedOnFundsInd | string | Does the issuer have evidence that the first merchant passed on the funds to the second merchant? Valid values =YorNValid if ( dispute_due_to=D (Duplicate) ordispute_due_to=P (Paid by other Means)) andprovidingPaymentProofOtherMeans=V (Voucher from the third party))Required when valid. Note: If user inputs Y, then the attachments docs are required. If user inputsN, then dispute will be blocked with a hard stop error. | C | |
cardholderAttemptToResolve | string | Did the cardholder attempt to resolve the dispute with the merchant? Required if dispute_due_to=P (Paid by other Means) AND (otherTranSameMerchantInd=Y orissuerOrCardholderOtherAcctWithDiffVisaCardInd=Y)Valid values = Y or N. Optional if dispute_due_to=D (Duplicate) AND (otherTranSameMerchantInd=Y orissuerOrCardholderOtherAcctWithDiffVisaCardInd=Y) | C | |
attemptToResolveProhLocalLaw | string | Is attempt to resolve prohibited by local law or regulations? Valid values =Y orNValid if dispute_due_to=D(Duplicate) ordispute_due_to=P (Paid by other Means) andcardholderAttemptToResolve=1NRequired 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 | string | Is 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) ordispute_due_to=P (Paid by other Means)) andissuerOrCardholderOtherAcctWithDiffVisaCardInd=N.Valid if ( | 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:
accountStatuswith one of the following values:
AC = Account closed
CP= Credit problem
F = Fraud
oneAuthForMultipleSalesInd- Was one authorization used for multiples sales?YorN
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 | date | Cancellation 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 ANDcardholderDeceased=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 oraccountClosureDate for all jurisdictions. | C | |
contactMethodWithMerchantInd | bool | Contact method with merchant For other jurisdiction other than Europe regional or domestic: Valid if dispute_due_to =CR (Cancelled Recurring Transaction) andcancellationDate is not null.Required when valid. | C | |
contactMethodMerchantEmailInd | bool | EmailValid ifcontactMethodWithMerchantInd =trueWhen valid, at least one of the following fields must be set totrue:contactMethodMerchantEmailIndcontactMethodMerchantCallCenterIndcontactMethodMerchantMailIndcontactMethodMerchantSMSIndcontactMethodMerchantInPersonIndcontactMethodMerchantWebformInd | C | |
contactMethodMerchantCallCenterInd | bool | Call Center Phone Number Valid if contactMethodWithMerchantInd =trueWhen valid, at least one of the following fields must be set to true:contactMethodMerchantEmailIndcontactMethodMerchantCallCenterIndcontactMethodMerchantMailIndcontactMethodMerchantSMSIndcontactMethodMerchantInPersonIndcontactMethodMerchantWebformInd | C | |
contactMethodMerchantMailInd | bool | Mail Valid if contactMethodWithMerchantInd =trueWhen valid, at least one of the following fields must be set to true:contactMethodMerchantEmailIndcontactMethodMerchantCallCenterIndcontactMethodMerchantMailIndcontactMethodMerchantSMSIndcontactMethodMerchantInPersonIndcontactMethodMerchantWebformInd | C | |
contactMethodMerchantSMSInd | bool | SMS/Text Message Valid if contactMethodWithMerchantInd =trueWhen valid, at least one of the following fields must be set to true:contactMethodMerchantEmailIndcontactMethodMerchantCallCenterIndcontactMethodMerchantMailIndcontactMethodMerchantSMSIndcontactMethodMerchantInPersonIndcontactMethodMerchantWebformInd | C | |
contactMethodMerchantInPersonInd | bool | In-Person Valid if contactMethodWithMerchantInd =trueWhen valid, at least one of the following fields must be set to true:contactMethodMerchantEmailIndcontactMethodMerchantCallCenterIndcontactMethodMerchantMailIndcontactMethodMerchantSMSIndcontactMethodMerchantInPersonIndcontactMethodMerchantWebformInd | C | |
contactMethodMerchantWebformInd | bool | Webform/Application Name Valid if contactMethodWithMerchantInd =trueWhen valid, at least one of the following fields must be set to true:contactMethodMerchantEmailIndcontactMethodMerchantCallCenterIndcontactMethodMerchantMailIndcontactMethodMerchantSMSIndcontactMethodMerchantInPersonIndcontactMethodMerchantWebformInd | C | |
contactMerchantDetailsPhoneNumber | string | Phone Number Valid if contactMethodMerchantCallCenterInd =true orcontactMethodMerchantSMSInd =trueRequired when valid. | C | |
contactMerchantDetailsEmailAddress | string | Email Address Valid if contactMethodMerchantEmailInd =trueRequired when valid. | C | |
contactMerchantDetailsPhysicalAddress | string | Physical Address Valid if contactMethodMerchantWebformInd =true orcontactMethodMerchantInPersonInd = trueRequired when valid. | C | |
contactMerchantDetailsApplicationName | string | Application Name Valid if contactMethodMerchantWebformInd =trueRequired when valid. | C | |
otherFormOfPaymentInd | bool | Other Form of Payment For other jurisdiction other than Europe regional or domestic: Valid if dispute_due_to =CR (Cancelled Recurring Transaction) andcancellationDate is notnull. | C | |
otherFormOfPaymentDesc | string | Describe other form of payment Valid if otherFormOfPaymentInd =trueRequired when valid. | C | |
accountClosureDate | date | Date 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 ANDcardholderDeceased =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 | string | Cancellation Reason Valid if dispute_due_to =CR (Cancelled Recurring Transaction) and user supplied value incancellationDateRequired when valid. | C | |
dispute_due_to =CS(Cancelled Merchandise/Service) | ||||
attemptToResolveProhLocalLaw | string | Is attempt to resolve prohibited by local law or regulations? Valid values =Y orNValid if dispute_due_to=CS(Cancelled Merchandies/Services) andcardholderAttemptToResolve=NRequired 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 | |
disputeRelateToOffpremisesDistanceSellInd | string | Does 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 |
| C | |
contractDate | date | Contract date. Format = CCYY-MM-DD Valid if dispute_due_to =CS (Cancelled Merchandise/Services) anddisputeRelateToInd =NRequired when valid | C | |
merchandiseOrServices | string | What was purchased? Valid if dispute_due_to =CS (Cancelled Merchandise/Services)Required when valid. | C | |
serviceType | string | Type of service Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andmerchandiseOrServices =Services.Required when valid. Values: T = TimeshareG = Guaranteed ReservationO = Other | C | |
whatWasPurchased | string | Describe what was purchased? Valid if dispute_due_to =CS (Cancelled Merchandise/Services) and (merchandiseOrServices =Merchandise orserviceType =O (Other))Required when valid. | C | |
cardholderReceiveMerchandiseInd | string | Did cardholder receive the merchandise?Y orN.Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andmerchandiseOrServices =MerchandiseRequired when valid. | C | |
chReceivedOrExpectedMerchandise | date | Date the cardholder received or expected to receive the merchandise. Format = CCYY-MM-DD Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andmerchandiseOrServices =MerchandiseRequired when valid. | C | |
cardholderAttemptToResolve | string | Did 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 | string | Did the cardholder return the merchandise? Valid if disputeDueTo =ND (Not as Described) andmerchandiseOrServices =MerchandiseRequired when valid. | C | |
cardholderReturnedMerchandiseDate | date | Date cardholder returned the merchandise - CCYY-MM-DD Valid if disputeDueTo =CS (Cancelled Merchandise/Services) andcardholderReturnMerchandiseInd =YRequired when valid | C | |
returnedMerchandiseReceivedDate | date | Date merchant received returned merchandise. Format = CCYY-MM-DD Valid if disputeDueTo =CS (Cancelled Merchandise/Services) andcardholderReturnMerchandiseInd =YRequired when valid. | C | |
returnMethod | string | Return Method Required if dispute_due_to =CS (Cancelled Merchandise/Services)) andcardholderReturnMerchandiseInd =Y.Values: FF = Face to FaceFE= Fed ExD= DHLU= UPSP = Postal ServiceO = Other | C | |
howMerchandiseReturned | string | Explain how the merchandise was returned Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andreturnMethod=O (Other)Required when valid. | C | |
shippingTrackingNumber | string | Tracking Number Valid if dispute_due_to=CS (Cancelled Merchandise/Services) and (returnMethod=FE(FedEx) orD(DHL) orU(UPS) orP(Postal Service) orO' (Other)) | C | |
cardholderAttemptReturnMerchandise | string | Did the cardholder attempt to return the merchandise?Y orNValid if dispute_due_to =CS (Cancelled Merchandise/Services) andcardholderReturnMerchandiseInd =N.Required when valid. | C | |
attemptedReturnDate | date | Date of attempted return. Format = CCYY-MM-DD Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andcardholderAttemptReturnMerchandise =YRequired when valid. | C | |
howChAttemptReturnAndDispOfMerchandise | string | Provide a detailed description of how the cardholder attempted to return merchandise Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andcardholderAttemptReturnMerchandise =YRequired when valid. | C | |
merchantRefuseAdvise | string | Provide certification of one of the following Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andmerchandiseOrServices =Merchandise andcardholderAttemptReturnMerchandise =YRequired when valid. Values: MRRM = Merchant refused to accept returned merchandiseMICNRM = Merchant informed cardholder not to return the merchandise | C | |
didCardholderCancel | string | Did the cardholder cancel?Y orNRequired if dispute_due_to =CS (Cancelled Merchandise/Services) and (cardholderReceiveMerchandiseInd =N orserviceType =O (Other) orT=(Timeshare))Optional when dispute_due_to =CS (Cancelled Merchandise/Services) andcardholderReceiveMerchandiseInd =YNote: If serviceType =O (Other) and user inputsN, then application will display hard stop error. | C | |
didCardholderCancelBeforeShipping | string | Did cardholder cancel before ship date?Y orNRequired if dispute_due_to=CS (Cancelled Merchandise/Services) andcardholderReceiveMerchandiseInd =Y anddidCardholderCancel =Y | C | |
timeshareDate | date | Date 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) andserviceType =T (Timeshare).For Europe Regions: Required if dispute_due_to =CS (Cancelled Merchandise/Services) andserviceType =T (Timeshare) anddisputeRelateToInd isYOptional if dispute_due_to =CS (Cancelled Merchandise/Services) andserviceType =T (Timeshare) anddisputeRelateToInd isN | C | |
dateOfService | date | Date of service or expected service. Format = CCYY-MM-DD Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andserviceType=G (Guaranteed Reservation) orO (Other)Required when valid. | C | |
certificationGuaranteedReservation | string | Certification of one of the following Valid if dispute_due_to =CS (Cancelled Merchandise/Services) andserviceType =G (Guaranteed Reservation)Required when valid. Values: GR - The cardholder properly cancelled the guaranteed reservationRC - The cardholder attempted to cancel within 24 hours of delivery of the reservation confirmationAR - The merchant billed a no show transaction for more than one day’s accommodation or rental | C | |
dispositionOfMerchandise | string | What is the disposition of the merchandise?Valid if | C | |
dispute_due_to =CM(Counterfeit Merchandise)Note: Documentation is required. | C | |||
| C | ||||
descCounterfeitMerchandise | string | Describe the counterfeit merchandise Valid if dispute_due_to =CM (Counterfeit Merchandise)Required when valid. | C | |
descDispOfCounterfeitMerchandise | string | Describe 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 | string | Certification 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 creditO = Original credit prohibited by local laws or regulations | C | |
explain | string | Explain 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. Valid if | C | |
creditVoucherOrTransactionReceiptDate | date | Date of credit voucher, transaction receipt or refund acknowledgement Valid if dispute_due_to =CN (Credit Not Processed) andcreditVoucherTransactionReceiptDated =YRequired when valid documentation is required. | C | |
cardholderCancelledReturnedMerchDate | date | Date the cardholder cancelled the service or returned the merchandise. Format = CCYY-MM-DD Valid if dispute_due_to =CN (Credit Not Processed) andcreditVoucherTransactionReceiptDated=NRequired when valid | C | |
explainCreditIssuedLateDetailsOfNegotiations | string | Explanation for credit issued late details of negotiation Valid if dispute_due_to =CN (Credit not processed) andcreditVoucherOrTransactionReceiptDate orCardholderCancelledReturnedMerchDate 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 | date | Date merchant cancelled merchandise Valid if dispute_due_to =NR (Merchandise/Services Not Received).Required when valid. | C | |
merchantInLiquidationOrReceivershipInd | string | Is the merchant in liquidation or receivership?Y orNValid if dispute_due_to=NR (Merchandise/Services Not Received) and jurisdiction is France domestic.Required when valid. | C | |
whatWasNotReceived | string | Valid ifdispute_due_to =NR (Merchandise/Services Not Received)Required when valid. Values: M = Merchandise,S = ServicesNotes:
| C | |
thirdPartyGiftCardInd | string | Is 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 orNValid if dispute_due_to=NR (Merchandise/Services Not Received)Required when valid. | C | |
visaComCardVirtualAccInd | string | Does the dispute involve a Visa Commercial Card Virtual Account?Y orNValid if dispute_due_to=NR (Merchandise/Services Not Received) andwhatWasNotReceived =S (Services) and productId from original transaction =G,K,S orXRequired when valid. | C | |
virtualAccFinancialLossInd | string | Did virtual account holder suffer a financial loss?Y orNValid if dispute_due_to =NR (Merchandise/Services Not Received) andvisaComCardVirtualAccInd =YRequired when valid. | C | |
didMerchantCancelInd | string | Did merchant cancel services?Y orNValid if dispute_due_to =NR (Merchandise/Services Not Received) andwhatWasNotReceived =S (Services)Required when valid. | C | |
merchantCancellationDate | date | Date merchant cancelled services. Format = CCYY-MM-DD Valid if dispute_due_to=NR (Merchandise/Services Not Received) anddidMerchantCancelInd =YRequired when valid. | C | |
nonReceiptOfTravelServicesInd | string | Does the dispute relate to non-receipt of travel services from a merchant that was unable to provide services due to insolvency/bankruptcy?Y orNValid if dispute_due_to=NR (Merchandise/Services Not Received) andwhatWasNotReceived =S (Services).Required when valid. Note: Valid for Europe Regional or Europe Domestic disputes | C | |
disputeInvolveBondingAuthorityInd | string | Was there a bond/insurance scheme?Y orNValid if dispute_due_to =NR (Merchandise/Services Not Received) andnonReceiptOfTravelServicesInd =YRequired when valid. Note: Valid for Europe Regional or Europe Domestic disputes | C | |
explainAttemptToResolveWithBondAuth | string | Provide 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) andnonReceiptOfTravelServicesInd =YRequired when valid. | C | |
purchasedInfo | string | Provide detailed description of what was purchased and an explanation of the dispute Required if dispute_due_to =NR (Merchandise/Services Not Received) andpurchaseInfoAvailableInd =FalseOptional if dispute_due_to =NR (Merchandise/Services Not Received) andpurchaseInfoAvailableInd= `True | C | |
expectedReceiptDate | date | What 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 | string | What was the last expected receipt time? Valid if dispute_due_to=NR (Merchandise/Services Not Received) | C | |
explainDisputePriorDeliveryDate | string | Explanation of dispute initiated prior to the expected delivery date Valid if dispute_due_to=NR (Merchandise/Services Not Received) andexpectedReceiptDate= Future DateRequired when valid | C | |
didCardholderCancelPriorExpectedDate | string | Did the cardholder cancel prior to the expected date?Y orNValid if dispute_due_to =NR (Merchandise/Services Not Received) and (whatWasNotReceived =M (Merchandise) orwhatWasNotReceived =S (Services))Required when valid | C | |
cancellationDate | date | Cancellation Date Valid if dispute_due_to=NR (Merchandise/Services Not Received) anddidCardholderCancelPriorExpectedDate=Y.Required when valid. | C | |
cancellationMethod | string | Cancellation Reason Valid if dispute_due_to=NR (Merchandise/Services Not Received) anddidCardholderCancelPriorExpectedDate =Y | ||
cardholderAttemptToResolve | string | Did the cardholder attempt to resolve the dispute with the merchant?Y orNValid if dispute_due_to =NR (Merchandise/Services Not Received) and (whatWasNotReceived =M (Merchandise) orwhatWasNotReceived =S (Services)).Required when valid. | C | |
attemptToResolveProhLocalLaw | string | Is attempt to resolve prohibited by local law or regulations? Valid values = Y or N. Valid if dispute_due_to =NR (Merchandise/Services Not Received) andcardholderAttemptToResolve =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 | string | Was the merchandise delivered to the incorrect location?Y orNValid if | ||
lateDeliveryWrongLocation | string | Provide address of the agreed location or details of late delivery Valid if dispute_due_to =NR (Merchandise/Services Not Received) andmerchandiseDeliveredWrongLocation =Y ormerchandiseDeliveredLate =YRequired when valid. | N/A | |
cardholderReturnMerchandiseInd | string | Did the cardholder return the merchandise?Y orNValid if dispute_due_to=NR (Merchandise/Services Not Received) andwhatWasNotReceived=M (Merchandise) andmerchandiseDeliveredLate=YRequired when valid. | C | |
cardholderReturnedMerchandiseDate | date | Date cardholder returned the merchandise. Format = CCYY-MM-DD Valid if dispute_due_to=NR (Merchandise/Services Not Received) andcardholderReturnMerchandiseInd=YRequired when valid | C | |
returnedMerchandiseReceivedDate | date | Date merchant received returned merchandise. ormat = CCYY-MM-DD Valid if dispute_due_to =NR (Merchandise/Services Not Received) andcardholderReturnMerchandiseInd=YRequired when valid | C | |
cardholderAttemptReturnMerchandise | string | Did the cardholder attempt to return the merchandise?YorNValid if dispute_due_to=NR (Merchandise/Services Not Received) andcardholderReturnMerchandiseInd=N.Required when valid | C | |
attemptedReturnDate | date | Date of attempted return. Format = CCYY-MM-DD Valid if dispute_due_to=NR (Merchandise/Services Not Received) andcardholderAttemptReturnMerchandise=Y.Required when valid. | C | |
didMerchantCancelMerchandiseInd | string | Did merchant cancel the merchandise?YorNValid if dispute_due_to =NR (Merchandise/Services Not Received) andwhatWasNotReceived=M (Merchandise).Required when valid. | C | |
| C | ||||
| C | ||||
| C | ||||
| C | ||||
cardholderMerchantPreviousNegotiationEvidence | string | Is there evidence of previous ongoing negotiations between the cardholder and merchant?Y orNValid 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 | date | When did the negotiations begin? Format = CCYY-MM-DD. Valid if dispute_due_to =DM (Damaged or Defective Merchandise) andcardholderMerchantPreviousNegotiationEvidence='Y'Required when valid. | C | |
explainPrevNegotiation | string | Explain the previous ongoing negotiations between the cardholder and merchant. Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andcardholderMerchantPreviousNegotiationEvidence=YRequired when valid. | C | |
cardholderFirstNotifiedIssuerDisputeDate | date | Date the cardholder first notified the issuer of the dispute. Format = CCYY-MM-DD. Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andcardholderMerchantPreviousNegotiationEvidence=YRequired when valid | C | |
cardholderAttemptToResolve | string | Did the cardholder attempt to resolve the dispute with the merchant?Y orNValid if dispute_due_to=DM (Damaged or Defective Merchandise).Required when valid. | C | |
attemptToResolveProhLocalLaw | string | Is attempt to resolve prohibited by local law or regulations? Valid values = Y or N. Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andcardholderAttemptToResolve=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 | string | Did the cardholder return the merchandise? Valid if dispute_due_to=DM (Damaged or Defective Merchandise).Required when valid. | C | |
cardholderReturnedMerchandiseDate | date | Date cardholder returned the merchandise. Format = CCYY-MM-DD Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andcardholderReturnMerchandiseInd='Y'.Required when valid | C | |
merchantReceivedReturnedMerchandiseDate | date | Date merchant received the returned merchandise. Format = CCYY-MM-DD Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andcardholderReturnMerchandiseInd=Y.Required when valid. | C | |
returnMethod | string | Return Method Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andcardholderReturnMerchandiseInd=YRequired when valid. Domain Values: FF=Face to FaceFE=Fed ExD=DHLU=UPSP= Postal ServiceO=Other | C | |
shippingTrackingNumber | string | Tracking Number Valid if dispute_due_to=DM (Damaged or Defective Merchandise) and (returnMethod=FE(FedEx) ORD(DHL) ORU(UPS) ORP(Postal Service)). | C | |
howMerchandiseReturned | string | Explain how the merchandise was returned Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andreturnMethod=O (Other)Required when valid | C | |
cardholderAttemptReturnMerchandise | string | Did the cardholder attempt to return the merchandise?Y orNValid if dispute_due_to=ND (Not as Described) andcardholderReturnMerchandiseInd='N'.Required when valid. | C | |
attemptedReturnDate | date | Date of attempted return. Format = CCYY-MM-DD Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andcardholderAttemptReturnMerchandise=Y.Required when valid. | C | |
howChAttemptReturnAndDispOfMerchandise | string | Provide a detailed description of how the cardholder attempted to return merchandise. Valid if dispute_due_to=DM (Damaged or Defective Merchandise) andcardholderAttemptReturnMerchandise=YRequired when valid. | C | |
merchantRefuseAdvise | string | Provide certification of one of the followingValid if Valid if ='DM' (Damaged or Defective Merchandise) and ='Y'. Valid if | C | |
dispute_due_to =M(Misrepresentation) | C | |||
merchandiseReceivedDate | date | Date merchandise was received. Format = CCYY-MM-DD Valid if dispute_due_to =M (Misrepresentation) andmerchandiseOrServices =Merchandise.Required when valid. | C | |
serviceReceivedDate | date | Date services were received. Format = CCYY-MM-DD Valid if dispute_due_to =M (Misrepresentation) andmerchandiseOrServices =ServicesRequired when valid. | C | |
cardholderMerchantPreviousNegotiationEvidence | string | Is there evidence of previous ongoing negotiations between the cardholder and merchant?Y orNValid if dispute_due_to =Q (Quality) and DateDiff(merchandiseReceivedDate ORserviceReceivedDate, Today())>120 and DateDiff( Disputed Transaction's Processing Date, Today())>120Valid if | C | |
explainPrevNegotiation | string | Explain the previous ongoing negotiations between the cardholder and merchant Valid if dispute_due_to =M'(Misrepresentation) andcardholderMerchantPreviousNegotiationEvidence =YRequired when valid. | C | |
cardholderFirstNotifiedIssuerDisputeDate | date | Date the cardholder first notified the issuer of the dispute. Format = CCYY-MM-DD Valid if dispute_due_to =M (Misrepresentation) andcardholderMerchantPreviousNegotiationEvidence =YRequired when valid | C | |
whatWasPurchased | string | Provide details of what was purchased Valid if dispute_due_to =M (Misrepresentation)Required when valid. | C | |
howMerchandiseOrServiceMisrepresented | string | How was the merchandise or service misrepresented? Valid if dispute_due_to =M (Misrepresentation)Required when valid. | C | |
didCardholderCancel | string | Did the cardholder cancel the services?Y orNValid if dispute_due_to =M (Misrepresentation) andmerchandiseOrServices =ServicesRequired when valid. | C | |
cancellationDate | date | Cancellation Date. Format = CCYY-MM-DD Valid if dispute_due_to =M (Misrepresentation) anddidCardholderCancel =YRequired when valid. | C | |
cancellationMethod | string | Cancellation Reason Valid if dispute_due_to =M (Misrepresentation) anddidCardholderCancel =YRequired when valid. | C | |
cardholderAttemptToResolve | string | Did the cardholder attempt to resolve the dispute with the merchant?Y orNValid if dispute_due_to =M (Misrepresentation) and (didCardholderCancel =Y ormerchandiseOrServices =Merchandise)Required when valid. | C | |
attemptToResolveProhLocalLaw | string | Is attempt to resolve prohibited by local law or regulations?Y orNValid if dispute_due_to =M (Misrepresentation) andcardholderAttemptToResolve =NRequired 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 | string | Did the cardholder return the merchandise?Y orNValid if dispute_due_to =M (Misrepresentation) andmerchandiseOrServices =MerchandiseRequired when valid. | C | |
cardholderReturnedMerchandiseDate | date | Date cardholder returned the merchandise. Format = CCYY-MM-DD Valid if dispute_due_to =M (Misrepresentation) andcardholderReturnMerchandiseInd =YRequired when valid | C | |
returnedMerchandiseReceivedDate | date | Date cardholder returned the merchandise Valid if dispute_due_to =M (Misrepresentation) andcardholderReturnMerchandiseInd =YRequired when valid | C | |
returnMethod | string | Return Method Valid if dispute_due_to =M (Misrepresentation) andcardholderReturnMerchandiseInd =YRequired when valid Values: FF= Face to FaceFE= Fed ExD= DHLU= UPSP= Postal ServiceO= Other | C | |
howMerchandiseReturned | string | Explain how the merchandise was returned Valid if dispute_due_to =M (Misrepresentation) andreturnMethod =O (Other)Required when valid | C | |
shippingTrackingNumber | string | Tracking 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) Valid if | C | |
attemptedReturnDate | date | Date of attempted return. Format = CCYY-MM-DD Valid if dispute_due_to =M (Misrepresentation) andCardholderAttemptReturnMerchandise =YRequired when valid. | ||
howChAttemptReturnAndDispOfMerchandise | string | Provide a detailed description of how the cardholder attempted to return merchandise Valid if dispute_due_to =M (Misrepresentation) andCardholderAttemptReturnMerchandise =Y | C | |
merchantRefuseAdvise | string | Provide certification of one of the following Valid if dispute_due_to =M (Misrepresentation) andmerchandiseOrServices =Merchandise andcardholderAttemptReturnMerchandise =YRequired when valid. Values: Valid if | C | |
merchandiseServiceReceivedDate | date | Date merchandise or service was received. Format = CCYY-MM-DD Valid if dispute_due_to =ND (Not as Described)Required when valid. | C | |
cardholderMerchantPreviousNegotiationEvidence | string | Is there evidence of previous ongoing negotiations between the cardholder and merchant?Y orNValid if dispute_due_to =ND (Not as Described) and DateDiff(merchandiseServiceReceivedDate, Today())>120 and DateDiff( Disputed Transaction's Processing Date, Today())>120Required when valid. | C | |
whenNegotiationsBegin | date | When did the negotiations begin? Format = CCYY-MM-DD Valid if dispute_due_to =ND (Not as Described) andcardholderMerchantPreviousNegotiationEvidence='Y'Required when valid. | C | |
explainPrevNegotiation | string | Explain the previous ongoing negotiations between the cardholder and merchant Valid if dispute_due_to =ND (Not as Described) andcardholderMerchantPreviousNegotiationEvidence =YRequired when valid. | ||
cardholderFirstNotifiedIssuerDisputeDate | date | Date the cardholder first notified the issuer of the dispute. Format = CCYY-MM-DD Valid if dispute_due_to =ND (Not as Described) andcardholderMerchantPreviousNegotiationEvidence =YRequired when valid | C | |
orderDetailsNotAsDescribed | string | Provide details of what was ordered and not as described Valid if dispute_due_to =ND (Not as Described)Required when valid | C | |
cardholderAttemptToResolve | string | Did the cardholder attempt to resolve the dispute with the merchant?Y orNValid if dispute_due_to =ND (Not as Described)Required when valid. | C | |
attemptToResolveProhLocalLaw | string | Is attempt to resolve prohibited by local law or regulations?Y orNValid if dispute_due_to =ND (Not as Described) andcardholderAttemptToResolve =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 | string | Did the cardholder return the merchandise. Y or N. Valid if dispute_due_to =ND (Not as Described) andmerchandiseOrServices ='Merchandise'.Required when valid | C | |
merchantReceivedReturnedMerchandiseDate | date | Date merchant received the returned merchandise. Format = CCYY-MM-DD Valid if dispute_due_to =ND (Not as Described) andcardholderReturnMerchandiseInd =Y.Required when valid. | C | |
returnMethod | string | Return Method Valid if dispute_due_to =ND (Not as Described) andcardholderReturnMerchandiseInd =YRequired when valid. Values: FF = Face to FaceFE = Fed ExD = DHLU = UPSP = Postal ServiceO = Other | C | |
shippingTrackingNumber | string | Tracking Number Valid if dispute_due_to =ND (Not as Described) and( returnMethod =FE(FedEx) ORD(DHL) ORU (UPS) ORP(Postal Service)) ORO(Other)). | C | |
howMerchandiseReturned | string | Explain how the merchandise was returned Valid if dispute_due_to =ND (Not as Described) andreturnMethod =O (Other)Required when valid | C | |
cardholderAttemptReturnMerchandise | string | Did the cardholder attempt to return the merchandise?Y orNValid if dispute_due_to =ND (Not as Described) andcardholderReturnMerchandiseInd =N.Required when valid. | C | |
attemptedReturnDate | date | Date of attempted return. Format = CCYY-MM-DD Valid if dispute_due_to =ND (Not as Described) andcardholderAttemptReturnMerchandise =Y.Required when valid. | C | |
howChAttemptReturnAndDispOfMerchandise | string | Provide a detailed description of how the cardholder attempted to return merchandise Valid if dispute_due_to=ND (Not as Described) andcardholderAttemptReturnMerchandise=YRequired when valid. | C | |
merchantRefuseAdvise | string | Provide certification of one of the following Valid if dispute_due_to =ND (Not as Described) andmerchandiseOrServices =Merchandise andcardholderAttemptReturnMerchandise =YRequired when valid. Values: Valid if | C | |
cancellationDate | date | Cancellation Date. Format = CCYY-MM-DD Valid if dispute_due_to =ND (Not as Described) anddidCardholderCancel =Y.Required when valid. | C | |
cancellationMethod | string | Cancellation Reason Valid if dispute_due_to =ND (Not as Described) anddidCardholderCancel =Y.Required when valid. | C | |
merchantAcceptCancellationInd | string | Did the merchant accept the cancellation?Y orNValid if dispute_due_to =ND (Not as Described) andmerchandiseOrServices =Services anddidCardholderCancel =Y andcancellationDate is less than or equal to 15 days prior to current date.Required when valid. | C | |
qualityOfFoodInd | string | Is dispute related to the quality of food received from eating places or restaurants?Y orNValid if dispute_due_to =ND (Not as Described) andmerchandiseOrServices =Services andMCC is5812,5813 or5814.Required when valid. | C | |
cancellationMethod | string | Cancellation Reason Valid if dispute_due_to =ND (Not as Described) anddidCardholderCancel =Y.Required when valid. | C | |
nonFiatCurrencyNotMatching | string | Was 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) andMerchandiseOrServices =Services.Required when valid. | C | |
dispositionOfMerchandise | string | What is the disposition of the merchandise? Valid if dispute_due_to =ND (Not as Described) andCardholderAttemptReturnMerchandise =Y.Required when valid. | C | |
dispute_due_to =Q(Quality) | ||||
merchandiseOrServices | string | What was purchased? Valid if dispute_due_to= 'Q' (Quality). | C | |
merchandiseReceivedDate | date | Date merchandise was received. Format = CCYY-MM-DD Valid if dispute_due_to =Q (Quality) andmerchandiseOrServices =Merchandise.Required when valid. | C | |
serviceReceivedDate | date | Date services were received. Format = CCYY-MM-DD Valid if dispute_due_to =Q (Quality) andmerchandiseOrServices =Services'Required when valid. | C | |
cardholderMerchantPreviousNegotiationEvidence | string | Is there evidence of previous ongoing negotiations between the cardholder and merchant?Y orNValid if dispute_due_to =Q (Quality) and DateDiff(merchandiseReceivedDate ORserviceReceivedDate, Today())>120 and DateDiff( Disputed Transaction's Processing Date, Today())>120Required when valid. | C | |
whenNegotiationsBegin | date | When did the negotiations begin? Format = CCYY-MM-DD Valid if dispute_due_to =Q (Quality) andcardholderMerchantPreviousNegotiationEvidence =YRequired when valid. | C | |
explainPrevNegotiation | string | Explain the previous ongoing negotiations between the cardholder and merchant Valid if dispute_due_to =Q (Quality) andcardholderMerchantPreviousNegotiationEvidence =YRequired when valid. | C | |
cardholderFirstNotifiedIssuerDisputeDate | date | Date the cardholder first notified the issuer of the dispute. Format = CCYY-MM-DD Valid if dispute_due_to =Q (Quality) andcardholderMerchantPreviousNegotiationEvidence =YRequired when valid | C | |
cardholderAttemptToResolve | string | Did the cardholder attempt to resolve the dispute with the merchant?Y orNValid if dispute_due_to =Q (Quality)Required when valid. | C | |
attemptToResolveProhLocalLaw | string | Is attempt to resolve prohibited by local law or regulations?Y orNValid if dispute_due_to =Q (Quality) andcardholderAttemptToResolve =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 | string | Did the cardholder return the merchandise?Y orNValid if dispute_due_to =Q (Quality) andmerchandiseOrServices=Merchandise .Required when valid. | C | |
cardholderReturnedMerchandiseDate | date | Date cardholder returned the merchandise. Format = CC-YY-MM Valid if dispute_due_to =Q (Quality) andcardholderReturnMerchandiseInd =Y.Required when valid. | C | |
merchantReceivedReturnedMerchandiseDate | date | Date merchant received the returned merchandise. Format = CCYY-MM-DD Valid if dispute_due_to =Q (Quality) andcardholderReturnMerchandiseInd =Y.Required when valid. | C | |
returnMethod | string | Return Method Valid if dispute_due_to =Q (Quality) andcardholderReturnMerchandiseInd =YRequired when valid. Values: FF= Face to FaceFE= Fed ExD= DHLU = UPSP = Postal ServiceO= Other | C | |
howMerchandiseReturned | string | Explain how the merchandise was returned Valid if dispute_due_to =Q (Quality) andreturnMethod =O (Other)Required when valid | C | |
shippingTrackingNumber | string | Tracking Number Valid if dispute_due_to =Q (Quality) and( returnMethod =FE(FedEx) ORD (DHL) ORU (UPS) ORP(Postal Service) ORO (Other)). | C | |
didCardholderPayWorkRedone | string | Did the cardholder pay to have the work redone?Y orNValid if dispute_due_to =Q (Quality) andmerchandiseOrServices =ServicesRequired when valid. | C | |
cardholderAttemptReturnMerchandise | string | Did the cardholder attempt to return the merchandise?Y orNValid if dispute_due_to =Q (Quality) andCardholderReturnMerchandiseInd =N.Required when valid. | C | |
attemptedReturnDate | date | Date of attempted return. Format = CCYY-MM-DD Valid if dispute_due_to =Q (Quality) andcardholderAttemptReturnMerchandise =Y.Required when valid. | C | |
howChAttemptReturnAndDispOfMerchandise | string | Provide a detailed description of how the cardholder attempted to merchandise Valid if dispute_due_to =Q (Quality) andcardholderAttemptReturnMerchandise =YRequired when valid. | C | |
merchantRefuseAdvise | string | Provide certification of one of the following Valid if dispute_due_to =Q (Quality) andmerchandiseOrServices =Merchandise andcardholderAttemptReturnMerchandise =YRequired when valid. Values: Valid if | C | |
cancellationDate | date | Cancellation Date. Format = CCYY-MM-DD Valid if dispute_due_to =Q (Quality) anddidCardholderCancel =YRequired when valid. | C | |
cancellationMethod | string | Cancellation Reason Valid if dispute_due_to =Q (Quality) anddidCardholderCancel =YRequired when valid. | C | |
merchantAcceptCancellationInd | string | Did the merchant accept the cancellation?Y orNValid if dispute_due_to =Q (Quality) andmerchandiseOrServices =Services anddidCardholderCancel =Y andcancellationDate is less than or equal to 15 days prior to current date.Required when valid. | C | |
qualityOfFoodInd | string | Is dispute related to the quality of food received from eating places or restaurants?Y orNValid if dispute_due_to =Q (Quality) andMerchandiseOrServices =Services andMCC is5812,5813 or5814Required when valid. | C | |
nonFiatCurrencyNotMatching | string | Was 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 NValid if dispute_due_to =Q (Quality) andMerchandiseOrServices =ServicesRequired when valid. | C | |
| C | ||||
dispute_due_to =TC(Terms of Contract) | ||||
serviceReceivedDate | date | Date 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 | string | Provide 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 | string | What 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 thanC 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 | |
Updated 8 days ago