---
schema_version: "1"
id: 2f66ca67d748e5c274bd0ef7e70d13c508406077fc71ade83b0b1ceb4306de54
title: DisputeItemMerchantAlert
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/financial_services_cloud_object_reference/sforce_api_objects_disputeitemmerchantalert.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.financial_services_cloud_object_reference.meta/financial_services_cloud_object_reference/sforce_api_objects_disputeitemmerchantalert.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 484be1a8a10465870270e4b2b945d8616c384fabfe35a988f1ff5f8965a00816
description: Represents the alert sent by the card issuer to the merchant. The alert occurs through a chargeback prevention vendor like Ethoca Merchant Alerts™ for a transaction that’s being disputed. This object is available in API version 60.0 and later.
---
# DisputeItemMerchantAlert

Represents the alert sent by the card issuer to the merchant. The alert occurs through a chargeback prevention vendor like Ethoca Merchant Alerts™ for a transaction that’s being disputed. This object is available in API version 60.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Special Access Rules

These fields are available if the add-on license for Financial Services Cloud is enabled.

## Fields

### AlertDeliveryStatus

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: Specifies the delivery status of the alert associated with an individual transaction in a batch of disputed transactions.
- **Possible values**:
    - Delivered
    - Undelivered
    - Failed
    - Ignored
    - Updated

### AlertDlvrStatusDescription

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The description of the delivery status of the alert.

### AlertIdentifier

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: A unique identifier assigned to a merchant alert related to the transaction that's being disputed. The alert identifier is generated by a chargeback prevention system like Ethoca.

### DisputeItemId

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort
- **Description**: The Dispute Item associated with the merchant alert.
    
    This field is a relationship field.
- **Relationship Name**: DisputeItem
- **Relationship Type**: Lookup
- **Refers To**: DisputeItem

### DisputedTrxnBatchIdentifier

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: An unique identifier assigned to the request made by the issuer for submitting a group of disputed transactions. Each group of disputed transactions is called a batch. The batch identifier is generated by a chargeback prevention system like Ethoca.

### DisputedTrxnBatchStatus

- **Type**: picklist
- **Properties**: Create, Filter, Group, Restricted picklist, Sort, Update
- **Description**: Specifies the status of the batch of disputed transactions that includes this transaction.
- **Possible values**:
    - IN PROGRESS
    - PROCESSED

### 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.

### Name

- **Type**: string
- **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort
- **Description**: Name of the DisputeItem record.

### Outcome

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: Specifies the outcome of the alert selected by the merchant.
- **Possible values**:
    - Resolved
    - Previously Refunded
    - Unresolved
    - Not Found
    - Other

### OutcomeDescription

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The description of the alert outcome.

### OutcomeUpdateDateTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the merchant last updated the alert outcome of the transaction that's being disputed. The timestamp is represented in the ISO 8601 format.

### RefundStatus

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: Specifies the status of the refund issued by the merchant in response to the customer's dispute alert.
- **Possible values**:
    - Yes
    - No
    - Not Settled

### Source

- **Type**: picklist
- **Properties**: Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update
- **Description**: Specifies the source of the merchant alert.
- **Default value**: Ethoca
- **Possible values**:
    - Ethoca

### Type

- **Type**: picklist
- **Properties**: Create, Filter, Group, Restricted picklist, Sort, Update
- **Description**: Specifies the type of alert associated with the transaction that's being disputed.
- **Possible values**:
    - Confirmed Fraud
    - Consumer Dispute

## 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.

[DisputeItemMerchantAlertChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.financial_services_cloud_object_reference.meta/financial_services_cloud_object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.")

Change events are available for the object.

[DisputeItemMerchantAlertFeed](https://developer.salesforce.com/docs/atlas.en-us.financial_services_cloud_object_reference.meta/financial_services_cloud_object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")

Feed tracking is available for the object.

[DisputeItemMerchantAlertHistory](https://developer.salesforce.com/docs/atlas.en-us.financial_services_cloud_object_reference.meta/financial_services_cloud_object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")

History is available for tracked fields of the object.

[DisputeItemMerchantAlertOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.financial_services_cloud_object_reference.meta/financial_services_cloud_object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.")

Sharing rules are available for the object.

[DisputeItemMerchantAlertShare](https://developer.salesforce.com/docs/atlas.en-us.financial_services_cloud_object_reference.meta/financial_services_cloud_object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.")

Sharing is available for the object.