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.
cardholderDeceased
bool
Certification that the cardholder is deceased
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.
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
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
bool
Contact 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
bool
EmailValid if
contactMethodWithMerchantInd
=
true
When valid, at least one of the following fields must be set to
true
:
contactMethodMerchantEmailInd
contactMethodMerchantCallCenterInd
contactMethodMerchantMailInd
contactMethodMerchantSMSInd
contactMethodMerchantInPersonInd
contactMethodMerchantWebformInd
C
contactMethodMerchantCallCenterInd
bool
Call 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
bool
Mail
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
bool
SMS/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
bool
In-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
bool
Webform/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
string
Phone Number
Valid if
contactMethodMerchantCallCenterInd
=
true
or
contactMethodMerchantSMSInd
=
true
Required when valid.
C
contactMerchantDetailsEmailAddress
string
Email Address
Valid if
contactMethodMerchantEmailInd
=
true
Required when valid.
C
contactMerchantDetailsPhysicalAddress
string
Physical Address
Valid if
contactMethodMerchantWebformInd
=
true
or
contactMethodMerchantInPersonInd
= true
Required when valid.
C
contactMerchantDetailsApplicationName
string
Application Name
Valid if
contactMethodMerchantWebformInd
=
true
Required 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) and
cancellationDate
is not
null
.
C
otherFormOfPaymentDesc
string
Describe other form of payment
Valid if
otherFormOfPaymentInd
=
true
Required 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
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
string
Cancellation 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
string
Is attempt to resolve prohibited by local law or regulations? Valid values =
Y
or
N
Valid if
dispute_due_to
=
CS
(Cancelled Merchandies/Services) or
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.
cancellationPolicyProvidedInd
string
Was a cancellation policy provided?
Y
or
N
Required if
dispute_due_to
=
CS
(Cancelled Merchandise/Services) and any of the following is
true
:
cardholderReceiveMerchandiseInd
=
N
; or
didCardholderCancelBeforeShipping
=
Y
; or
(
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
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
Cancellation Date.
Required if dispute_due_to
='CS'
(Cancelled Merchandise/Services) and MerchandiseOrServices
='Services'
and DidCardholderCancel
='Y'
or CertificationGuaranteedReservation
='GR'
(The cardholder properly cancelled the guaranteed reservation) or CertificationGuaranteedReservation
='RC'
(The cardholder attempted to cancel within 24 hours of delivery of the reservation confirmation) or MerchandiseOrServices
='Merchandise'
and DidCardholderCancelBeforeShipping
= 'Y'
or MerchandiseOrServices
='Merchandise'
and DidCardholderCancel
='Y'
and CardholderReceiveMerchandiseInd
='N'
Optional if DisputeDueTo
='CS'
(Cancelled Merchandise/Services) and MerchandiseOrServices
='Merchandise'
and DidCardholderCancelBeforeShipping
='N'
C
cancellationMethod
string
Cancellation Method
Required if DisputeDueTo
='CS'
(Cancelled Merchandise/Services) and (MerchandiseOrServices
='Services'
and DidCardholderCancel
='Y'
) or (MerchandiseOrServices
='Merchandise'
and DidCardholderCancel
='Y'
and CardholderReceiveMerchandiseInd
='N'
) or (MerchandiseOrServices
='Merchandise'
and DidCardholderCancelBeforeShipping
='Y'
)
Optional if DisputeDueTo
='CS'
(Cancelled Merchandise/Services) and DidCardholderCancelBeforeShipping
='N'
C
disputeRelateToInd
string
Is the dispute related to one of the following?
Y
or
N
- 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
date
Contract date. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
CS
(Cancelled Merchandise/Services) and
disputeRelateToInd
=
N
Required 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) and
merchandiseOrServices
=
Services
.
Required when valid.
Values:
T
= Timeshare
G
= Guaranteed Reservation
O
= Other
C
whatWasPurchased
string
Describe what was purchased?
Valid if
dispute_due_to
=
CS
(Cancelled Merchandise/Services) and (
merchandiseOrServices
=
Merchandise
or
serviceType
=
O
(Other))
Required when valid.
C
cardholderReceiveMerchandiseInd
string
Did cardholder receive the merchandise?
Y
or
N
.
Valid if
dispute_due_to
=
CS
(Cancelled Merchandise/Services) and
merchandiseOrServices
=
Merchandise
Required 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) and
merchandiseOrServices
=
Merchandise
Required 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) and
merchandiseOrServices
=
Merchandise
Required when valid.
C
cardholderReturnedMerchandiseDate
date
Date cardholder returned the merchandise - CCYY-MM-DD
Valid if
disputeDueTo
=
CS
(Cancelled Merchandise/Services) and
cardholderReturnMerchandiseInd
=
Y
Required when valid
C
returnedMerchandiseReceivedDate
date
Date merchant received returned merchandise. Format = CCYY-MM-DD
Valid if
disputeDueTo
=
CS
(Cancelled Merchandise/Services) and
cardholderReturnMerchandiseInd
=
Y
Required when valid.
C
returnMethod
string
Return 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
string
Explain how the merchandise was returned
Valid if
dispute_due_to
=
CS
(Cancelled Merchandise/Services) and
returnMethod
=
O
(Other)
Required when valid.
C
shippingTrackingNumber
string
Tracking 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
string
Did 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
date
Date of attempted return. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
CS
(Cancelled Merchandise/Services) and
cardholderAttemptReturnMerchandise
=
Y
Required 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) 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:
MRRA
= Merchant refused to provide return authorization
MRRM
= Merchant refused to accept returned merchandise
MICNRM
= Merchant informed cardholder not to return the merchandise
C
didCardholderCancel
string
Did 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
string
Did 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
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) 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
date
Date 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
string
Certification 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
dispositionOfMerchandise
string What is the disposition of the merchandise?
Valid if
dispute_due_to
=
CS
(Cancelled Merchandise/Services) and
CardholderAttemptReturnMerchandise
=
Y
Required when valid.
C
dispute_due_to
=
CM
(Counterfeit Merchandise)
whatWasOrdered
string
What was ordered?
Valid if
dispute_due_to
=
CM
(Counterfeit Merchandise)
Required when valid.
C
merchandiseIdentifiedAsCounterfeit
string
Certification the merchandise was identified as counterfeit by one of the following
Valid if
dispute_due_to
=
CM
(Counterfeit Merchandise)
Values:
O
- The owner of the intellectual property or its authorized representative
A
- Customs agency, law enforcement agency or other government agency
T
- A third-party expert
Required when valid.
C
merchandiseWasCounterfeitDate
date
Date the cardholder received the merchandise or received notification that the merchandise was counterfeit. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
CM
(Counterfeit Merchandise)
Required when valid
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
infoMerchandiseToBeCounterfeit
string
Provide information about the entity that indicated the merchandise to be counterfeit
Valid if
dispute_due_to
=
CM
(Counterfeit Merchandise)
Required when valid
Note : Include the name of the entity providing the notification and validation that the entity is qualified to provide the notification
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 credit
O
= 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.
C
creditVoucherTransactionReceiptDated
string
Is the credit voucher, transaction receipt, or refund acknowledgement dated?
Y
or
N
Valid if
dispute_due_to
=
CN
(Credit Not Processed) and
creditVoucherTransactionReceipt
=
Y
.
Required when valid documentation is required.
C
creditVoucherOrTransactionReceiptDate
date
Date 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
date
Date 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
dispute_due_to
=
NR
(Merchandise/Services Not Received)
merchantInLiquidationOrReceivershipInd
string
Is 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
string
Valid 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
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
or
N
Valid 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
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
string
Did 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
string
Did 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
date
Date 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
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
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
string
Was 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
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) and
nonReceiptOfTravelServicesInd
=
Y
Required when valid.
C
bondAuthLetterOrAdviceDate
date
Date of the letter or advice from the bonding authority/insurance scheme. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
'NR
(Merchandise/Services Not Received) and
disputeInvolveBondingAuthorityInd
=
Y
Required 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) and
purchaseInfoAvailableInd
=
False
Optional if
dispute_due_to
=
NR
(Merchandise/Services Not Received) and
purchaseInfoAvailableInd
= `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) and
expectedReceiptDate
= Future Date
Required when valid
C
didCardholderCancelPriorExpectedDate
string
Did 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
date
Cancellation Date
Valid if
dispute_due_to
=
NR
(Merchandise/Services Not Received) and
didCardholderCancelPriorExpectedDate
=
Y
.
Required when valid.
C
cancellationMethod
string
Cancellation Reason
Valid if
dispute_due_to
=
NR
(Merchandise/Services Not Received) and
didCardholderCancelPriorExpectedDate
=
Y
cardholderAttemptToResolve
string
Did 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
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) 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
string
Was 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
string
Provide 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.
NA
cardholderReturnMerchandiseInd
string
Did 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
date
Date 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
date
Date 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
string
Did the cardholder attempt to return the merchandise?
Y
or
N
Valid if
dispute_due_to
=
NR
(Merchandise/Services Not Received) and
cardholderReturnMerchandiseInd
=
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) and
cardholderAttemptReturnMerchandise
=
Y
.
Required when valid.
C
didMerchantCancelMerchandiseInd
string
Did merchant cancel the merchandise?
Y
or
N
Valid if
dispute_due_to
=
NR
(Merchandise/Services Not Received) and
whatWasNotReceived
=
M
(Merchandise).
Required when valid.
C
nonFiatCurrencyNotDelivered
string
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?
Y
or
N
Valid if
dispute_due_to
=
NR
(Merchandise/Services Not Received) and
whatWasNotReceived
=
S
(Services).
Required when valid.
C
merchandiseDeliveredLate
string
Was the merchandise delivered late?
Y
or
N
Valid if
dispute_due_to
=
NR
(Merchandise/Services Not Received) and
whatWasNotReceived
=
M
(Merchandise).
Required when valid.
C
merchantInBankruptcyLiquidationInd
string
Is merchant in bankruptcy/liquidation?
Y
or
N
Valid if
dispute_due_to
=
NR
(Merchandise/Services Not Received) and
Required when valid.
C
dispute_due_to
=
DM
(Damaged or Defective Merchandise)
damagedOrDefectiveOrderInfo
string
What was ordered and how it was damaged or defective?
Valid if
dispute_due_to
=
DM
(Damaged or Defective Merchandise).
Required when valid.
C
merchantCancelMerchandiseDate
data
Date merchant cancelled merchandise
Valid if
dispute_due_to
=
DM
(Damaged or Defective Merchandise).
Required when valid.
C
merchandiseReceivedDate
date
Date merchandise was received. Format = CCYY-MM=DD
Valid if
dispute_due_to
=
DM
(Damaged or Defective Merchandise).
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
=
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) and
cardholderMerchantPreviousNegotiationEvidence
='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) and
cardholderMerchantPreviousNegotiationEvidence
=
Y
Required 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) and
cardholderMerchantPreviousNegotiationEvidence
=
Y
Required when valid
C
cardholderAttemptToResolve
string
Did 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
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) 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
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) and
cardholderReturnMerchandiseInd
='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) and
cardholderReturnMerchandiseInd
=
Y
.
Required when valid.
C
returnMethod
string
Return 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
string
Tracking 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
string
Explain how the merchandise was returned
Valid if
dispute_due_to
=
DM
(Damaged or Defective Merchandise) and
returnMethod
=
O
(Other)
Required when valid
C
cardholderAttemptReturnMerchandise
string
Did 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
date
Date 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
string
Provide 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
string
Provide certification of one of the following
Valid if
dispute_due_to
=
DM
(Damaged or Defective Merchandise) and <
CardholderAttemptReturnMerchandise
>=
Y
Required when valid.
Values:
MRRA
= Merchant refused to provide return authorization
MRRM
= Merchant refused to accept returned merchandise
MICNRM
= Merchant informed cardholder not to return the merchandise
MNLER
= Merchant no longer exists or is not responding
MNPCIR
= Merchant did not provide clear instruction on how to return
C
dispositionOfMerchandise
string
What is the disposition of the merchandise?
Valid if ='DM' (Damaged or Defective Merchandise) and ='Y'.
Valid if
dispute_due_to
=
DM
(Damaged or Defective Merchandise) and
CardholderAttemptReturnMerchandise
= Y
Required when valid.
C
dispute_due_to
=
M
(Misrepresentation)
merchandiseOrServices
string
What was purchased?
Valid if
dispute_due_to
=
M
(Misrepresentation)
Required when valid.
C
merchandiseReceivedDate
date
Date merchandise was received. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
M
(Misrepresentation) and
merchandiseOrServices
=
Merchandise
.
Required when valid.
C
serviceReceivedDate
date
Date 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
Required when valid.
C
whenNegotiationsBegin
date
When did the negotiations begin?
Valid if
dispute_due_to
=
M
(Misrepresentation) and
cardholderMerchantPreviousNegotiationEvidence
=
Y
Required when valid.
C
explainPrevNegotiation
string
Explain the previous ongoing negotiations between the cardholder and merchant
Valid if
dispute_due_to
=
M'
(Misrepresentation) and
cardholderMerchantPreviousNegotiationEvidence
=
Y
Required 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) and
cardholderMerchantPreviousNegotiationEvidence
=
Y
Required 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
or
N
Valid if
dispute_due_to
=
M
(Misrepresentation) and
merchandiseOrServices
=
Services
Required when valid.
C
cancellationDate
date
Cancellation Date. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
M
(Misrepresentation) and
didCardholderCancel
=
Y
Required when valid.
C
cancellationMethod
string
Cancellation Reason
Valid if
dispute_due_to
=
M
(Misrepresentation) and
didCardholderCancel
=
Y
Required when valid.
C
cardholderAttemptToResolve
string
Did 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
string
Is 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
string
Did the cardholder return the merchandise?
Y
or
N
Valid if
dispute_due_to
=
M
(Misrepresentation) and
merchandiseOrServices
=
Merchandise
Required when valid.
C
cardholderReturnedMerchandiseDate
date
Date cardholder returned the merchandise. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
M
(Misrepresentation) and
cardholderReturnMerchandiseInd
=
Y
Required when valid
C
returnedMerchandiseReceivedDate
date
Date cardholder returned the merchandise
Valid if
dispute_due_to
=
M
(Misrepresentation) and
cardholderReturnMerchandiseInd
=
Y
Required when valid
C
returnMethod
string
Return 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
string
Explain how the merchandise was returned
Valid if
dispute_due_to
=
M
(Misrepresentation) and
returnMethod
=
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)
Required when valid.
C
cardholderAttemptReturnMerchandise
string
Did the cardholder attempt to return the merchandise?
Y
or
N
Valid if
dispute_due_to
=
M
(Misrepresentation) and
CardholderReturnMerchandiseInd
=
N
.
Required when valid.
C
attemptedReturnDate
date
Date of attempted return. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
M
(Misrepresentation) and
CardholderAttemptReturnMerchandise
=
Y
Required when valid.
howChAttemptReturnAndDispOfMerchandise
string
Provide a detailed description of how the cardholder attempted to return merchandise
Valid if
dispute_due_to
=
M
(Misrepresentation) and
CardholderAttemptReturnMerchandise
=
Y
C
merchantRefuseAdvise
string
Provide certification of one of the following
Valid if
dispute_due_to
=
M
(Misrepresentation) and
merchandiseOrServices
=
Merchandise
and
cardholderAttemptReturnMerchandise
=
Y
Required when valid.
Values:
MRRA
= Merchant refused to provide return authorization
MRRM
= Merchant refused to accept returned merchandise
MICNRM
= Merchant informed cardholder not to return the merchandise
C
dispute_due_to
=
ND
(Not as Described)
merchandiseOrServices
string
What was purchased?
Valid if
dispute_due_to
=
ND
(Not as Described).
Required when valid.
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
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
date
When 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
string
Explain 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
date
Date 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
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
or
N
Valid 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
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
string
Did 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
date
Date 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
string
Return 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
string
Tracking 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
string
Explain how the merchandise was returned
Valid if
dispute_due_to
=
ND
(Not as Described) and
returnMethod
=
O
(Other)
Required when valid
C
cardholderAttemptReturnMerchandise
string
Did 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
date
Date of attempted return. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
ND
(Not as Described) and
cardholderAttemptReturnMerchandise
=
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) and
cardholderAttemptReturnMerchandise
=
Y
Required when valid.
C
merchantRefuseAdvise
string
Provide 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:
MRRA
= Merchant refused to provide return authorization
MRRM
= Merchant refused to accept returned merchandise
MICNRM
= Merchant informed cardholder not to return the merchandise
MNLER
= Merchant no longer exists or is not responding
MNPCIR
= Merchant did not provide clear instruction on how to return
C
didCardholderCancel
string
Did the cardholder cancel the services?
Y
or
N
Valid if
dispute_due_to
=
ND
(Not as Described) and
merchandiseOrServices
=
Services'
Required when valid.
C
cancellationDate
date
Cancellation Date. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
ND
(Not as Described) and
didCardholderCancel
=
Y
.
Required when valid.
C
cancellationMethod
string
Cancellation Reason
Valid if
dispute_due_to
=
ND
(Not as Described) and
didCardholderCancel
=
Y
.
Required when valid.
C
merchantAcceptCancellationInd
string
Did 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
string
Is 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
string
Cancellation Reason
Valid if
dispute_due_to
=
ND
(Not as Described) and
didCardholderCancel
=
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) and
MerchandiseOrServices
=
Services
.
Required when valid.
C
dispositionOfMerchandise
string
What 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
string
What was purchased?
Valid if
dispute_due_to= 'Q' (Quality).
Required when valid.
Values:
Merchandise
Services
C
purchasedInfoAndQualityIssue
string
Provide information about what was purchased and the quality issue
Valid if
dispute_due_to
=
Q
(Quality).
Required when valid.
C
merchandiseReceivedDate
date
Date merchandise was received. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
Q
(Quality) and
merchandiseOrServices
=
Merchandise
.
Required when valid.
C
serviceReceivedDate
date
Date services were received. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
Q
(Quality) 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
Required when valid.
C
whenNegotiationsBegin
date
When did the negotiations begin? Format = CCYY-MM-DD
Valid if
dispute_due_to
=
Q
(Quality) and
cardholderMerchantPreviousNegotiationEvidence
=
Y
Required when valid.
C
explainPrevNegotiation
string
Explain the previous ongoing negotiations between the cardholder and merchant
Valid if
dispute_due_to
=
Q
(Quality) and
cardholderMerchantPreviousNegotiationEvidence
=
Y
Required 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) and
cardholderMerchantPreviousNegotiationEvidence
=
Y
Required when valid
C
cardholderAttemptToResolve
string
Did 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
string
Is 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
string
Did the cardholder return the merchandise?
Y
or
N
Valid if
dispute_due_to
=
Q
(Quality) and
merchandiseOrServices
=
Merchandise
.
Required when valid.
C
cardholderReturnedMerchandiseDate
date
Date cardholder returned the merchandise. Format = CC-YY-MM
Valid if
dispute_due_to
=
Q
(Quality) and
cardholderReturnMerchandiseInd
=
Y
.
Required when valid.
C
merchantReceivedReturnedMerchandiseDate
date
Date merchant received the returned merchandise. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
Q
(Quality) and
cardholderReturnMerchandiseInd
=
Y
.
Required when valid.
C
returnMethod
string
Return 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
string
Explain how the merchandise was returned
Valid if
dispute_due_to
=
Q
(Quality) and
returnMethod
=
O
(Other)
Required when valid
C
shippingTrackingNumber
string
Tracking 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
string
Did 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
string
Did 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
date
Date of attempted return. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
Q
(Quality) and
cardholderAttemptReturnMerchandise
=
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) and
cardholderAttemptReturnMerchandise
=
Y
Required when valid.
C
merchantRefuseAdvise
string
Provide certification of one of the following
Valid if
dispute_due_to
=
Q
(Quality) and
merchandiseOrServices
=
Merchandise
and
cardholderAttemptReturnMerchandise
=
Y
Required when valid.
Values:
MRRA
= Merchant refused to provide return authorization
MRRM
= Merchant refused to accept returned merchandise
MICNRM
= Merchant informed cardholder not to return the merchandise
MNLER
= Merchant no longer exists or is not responding
MNPCIR
= Merchant did not provide clear instruction on how to return
C
didCardholderCancel
string
Did the cardholder cancel the services?
Y
or
N
Valid if
dispute_due_to
=
Q
(Quality) and
merchandiseOrServices
=
Services'
Required when valid.
C
cancellationDate
date
Cancellation Date. Format = CCYY-MM-DD
Valid if
dispute_due_to
=
Q
(Quality) and
didCardholderCancel
=
Y
Required when valid.
C
cancellationMethod
string
Cancellation Reason
Valid if
dispute_due_to
=
Q
(Quality) and
didCardholderCancel
=
Y
Required when valid.
C
merchantAcceptCancellationInd
string
Did 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
string
Is 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
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
=
Q
(Quality) and
MerchandiseOrServices
=
Services
Required when valid.
C
dispositionOfMerchandise
string
What is the disposition of the merchandise?
Valid if
dispute_due_to
=
Q
(Quality) and
CardholderAttemptReturnMerchandise
=
Y
Required when valid.
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)
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 than
C
then application will display an error.
Values:
C
= Cash
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 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