DisputeItem
Represents a transaction that’s being disputed. This object is available
in API version 59.0 and later.
Supported Calls
create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()
Fields
AcquirerReferenceNumber
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: A unique identifier assigned to a transaction by the payment network if the transaction was done through a payment gateway. Available in version 61.0 and later.
ApprovedProvisionalCredit
- Type: currency
- Properties: Create, Filter, Nillable, Sort, Update
- Description: The provisional credit amount that's approved for the dispute. Available in version 60.0 and later.
CardBrand
CardLastFourDigit
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The last four digits of the credit or debit card number that's associated with this transaction. These digits are commonly used to verify the transaction and identify the cardholder. Available in version 60.0 and later.
CardSixDigitBin
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The first six digits of the credit or debit card number that's associated with this transaction. These digits are used to identify the card issuer. Available in version 60.0 and later.
CardType
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Description: Specifies the type of card used in the transaction. Available in version 61.0 and later.
-
Possible values:
- Credit Card
- Debit Card
- Prepaid Card
CaseClaimIdentifier
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: A unique identifier of the claim associated with an arbitration or compliance case. Available in version 62.0 and later.
ClaimIdentifier
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: A unique identifier of the claim associated with the chargeback. Available in version 61.0 and later.
ClearingMerchantName
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The name of the merchant or business that accepted the payment through a card transaction. Available in version 61.0 and later.
ClearingTrxnAmountLocal
- Type: double
- Properties: Create, Filter, Nillable, Sort, Update
- Description: The cleared amount of the disputed transaction in the local currency. Available in version 62.0 and later.
ClearingTrxnAmountLocalCrcy
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The cleared amount of the disputed transaction in the local currency. Available in version 62.0 and later.
DisputeId
- Type: reference
- Properties: Create, Filter, Group, Sort, Update
-
Description: The unique identifier of the transaction.
This field is a relationship field.
- Relationship Name: Dispute
- Relationship Type: Lookup
- Refers To: Dispute
DisputeReasonId
- Type: reference
- Properties: Create, Filter, Group, Nillable, Sort, Update
-
Description: The Dispute Reason associated with the dispute item. Available in
version 61.0 and later.
This field is a relationship field.
- Relationship Name: DisputeReason
- Relationship Type: Lookup
- Refers To: DisputeReason
DisputedAmount
- Type: currency
- Properties: Create, Filter, Nillable, Sort, Update
- Description: The amount in the transaction that's under question or dispute.
EnrichmentProvider
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Description: Specifies the name of the enrichment provider that provides additional information associated with the transaction, such as merchant name, address, description, and URL. Available in version 60.0 and later.
FundFlowDirection
- Type: picklist
- Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Description: Specifies the direction of funds in the transaction that's being disputed. Available in version 60.0 and later.
-
Possible values:
- Credit
- Debit
- INFLOW
- OUTFLOW
- Withdrawal
IsCardPresent
- Type: boolean
- Properties: Create, Defaulted on create, Filter, Group, Sort, Update
- Description: Indicates whether the payment card was present with the cardholder (true) or not (false) during the transaction. Available in version 61.0 and later.
- Default value: false
LastReferencedDate
- Type: dateTime
- Properties: Filter, Nillable, Sort
- Description: The timestamp for when the current user last viewed a record related to this record.
LastViewedDate
- Type: dateTime
- Properties: Filter, Nillable, Sort
- Description: The timestamp for when the current user last viewed this record. If this value is null, it’s possible that this record was referenced (LastReferencedDate) and not viewed.
MerchantAddress
- Type: address
- Properties: Filter, Nillable
- Description: The address of the merchant associated with the transaction. Available in version 60.0 and later.
MerchantCategory
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The category associated with the merchant based on the type of products or services the merchant provides. Available in version 60.0 and later.
MerchantDescription
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The description of the merchant associated with the transaction. Available in version 60.0 and later.
MerchantDetails
- Type: textarea
- Properties: Create, Nillable, Update
- Description: The merchant-related information of a transaction obtained from the payment network.
MerchantName
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The name of the merchant associated with the transaction. Available in version 60.0 and later.
MerchantUrl
- Type: url
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The website URL of the merchant associated with the transaction. Available in version 60.0 and later.
MerchantLogoUrl
- Type: url
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The logo URL of the merchant associated with the transaction. Available in version 60.0 and later.
Name
- Type: string
- Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
- Description: Name of the DisputeItem record.
PaymentNetwork
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Description: Specifies the payment network that facilitate the exchange of funds between parties involved. Available in version 61.0 and later.
-
Possible values:
- ACH
- American Express
- Diners
- Mastercard
- Visa
- Zelle
PaymentNetworkFraudCategory
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Description: Specifies the category of fraud that the fraudulent transaction belongs to.
-
Possible values:
- Card Transaction Fraud
- Card was not received as issued and there is no associated transaction
- Convenience Check Fraud Reporting
- POSCHECK
PaymentNetworkFraudRptIdentifier
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: A unique identifier assigned to a report submitted to the payment network for a fraudulent transaction.
PaymentNetworkFraudType
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Description: Specifies the type of fraud that the fraudulent transaction belongs to.
-
Possible values:
- Advance Fee Scam
- CEO Fraud Scam
- Impersonation Scam
- Investment Scam
- Invoice or Mandate Scam
- Purchase Scam
- Romance Scam
PaymentNetworkCaseType
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Description: Specifies the type of case being handled for a transaction in the payment network.
-
Possible values:
- Advance Fee Scam
- CEO Fraud Scam
- Impersonation Scam
- Investment Scam
- Invoice or Mandate Scam
- Purchase Scam
- Romance Scam
PaymentNtwkTrxnIdentifier
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: A unique identifier assigned by the payment network to track a transaction during the dispute process.
ProvisionalCreditApproverId
- Type: reference
- Properties: Create, Filter, Group, Nillable, Sort, Update
-
Description: The User associated with the Dispute. The user is the approver of
the provisional credit amount. Available in version 60.0 and
later.
This field is a relationship field.
- Relationship Name: ProvisionalCreditApprover
- Relationship Type: Lookup
- Refers To: User
ProvisionalCreditDate
- Type: date
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The date when the provisional credit amount was credited. Available in version 60.0 and later.
ProvisionalCreditStatus
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: Specifies the status of the provisional credit amount. Available in version 60.0 and later.
-
Possible values:
- Completed
- In Progress
- Initiated
- Not Applicable
ReceiverBin
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The unique identifier of the entity who filed an arbitration or compliance case. Available in version 62.0 and later.
SenderBin
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The unique identifier of the entity against which an arbitration or compliance case is filed. Available in version 62.0 and later.
Status
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: Specifies the status of the disputed transaction.
-
Possible values:
- Submitted
- Invalid
- No longer disputed
- Resolved
TransactionAmount
- Type: currency
- Properties: Create, Filter, Nillable, Sort, Update
- Description: The total amount involved in the transaction.
TransactionCode
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The unique code that identifies the type of transaction.
TransactionCurrencyCode
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The unique code associated with the currency used in this transaction.
TransactionDataSource
TransactionDate
- Type: date
- Properties: Create, Filter, Group, Sort, Update
- Description: The date of the transaction.
TransactionDescription
- Type: textarea
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The description of the transaction.
TransactionDetails
- Type: textarea
- Properties: Create, Nillable, Update
- Description: The detailed information of a transaction obtained from the payment network.
TransactionGroupIdentifier
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The unique identifier assigned to a group of related disputed transactions within a payment network system, such as Visa.
TransactionIdentifier
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The unique identifier of the transaction.
TransactionSearchExtdResult
- Type: textarea
- Properties: Create, Nillable, Update
- Description: The summary of transactions obtained from the payment network based on search criteria.
TransactionsApiSearchResult
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The search result of the transactions API. Available in version 61.0 and later.
TrxnApiAuthorizationResult
- Type: textarea
- Properties: Create, Nillable, Update
- Description: The authorization information obtained from the transactions API. Available in version 61.0 and later.
TrxnApiClrAndStlResult
- Type: textarea
- Properties: Create, Nillable, Update
- Description: The clearing and settlement information obtained from the transactions API. Available in version 61.0 and later.
TrxnClearingIdentifier
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The unique identifier assigned to a transaction during the clearing and settlement process to track the transaction's progress and facilitate funds transfer between parties. Available in version 61.0 and later.
ValidationOutcome
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: Specifies the outcome of the validation rules run on the disputed transaction.
-
Possible values:
- Automatic write-off
- Eligible
- Invalid
ValidationOutcomeReason
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The reason for the transaction's validation outcome. Available in version 60.0 and later.
Associated Objects
This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.
- DisputeItemHistory
- History is available for tracked fields of the object.