Dispute-only values used by TrustPay pages, APIs, and callbacks.
Callback Notification Type#
| Value | Constant | Description |
|---|
4 | chargeback | Formal dispute lifecycle callback |
7 | dispute_alert | Dispute Alert callback |
Dispute Alert Warning Type#
| Value | Description |
|---|
ethoca | Ethoca alert |
rdr | Rapid Dispute Resolution result |
cdrn | CDRN alert |
Dispute Alert Category#
| Value | Description |
|---|
fraud | Fraud alert |
dispute | Transaction dispute alert |
Dispute Alert Match Status#
| Value | Description |
|---|
matched | Exactly one merchant order was matched |
unmatched | No merchant order was matched |
ambiguous | More than one possible order was found |
Only matched alerts can be displayed, billed, and delivered to a merchant.Dispute Alert Match Method#
| Value | Description |
|---|
arn | Matched by Acquirer Reference Number |
card_amount_time | Matched by masked card identity, amount, currency, and transaction time |
none | No unique order match |
none is not sent in a successfully matched merchant callback.Dispute Alert Notification Status#
| Value | Description |
|---|
not_applicable | Notification does not apply to this alert |
missing_url | The original order has no usable notify_url |
pending | Waiting to be sent |
sending | Currently being sent |
retrying | A previous attempt failed and will be retried |
succeeded | Merchant returned HTTP 200 |
failed | Notification exhausted its retry policy |
Dispute Alert Fee Status#
| Value | Description |
|---|
not_applicable | No merchant fee applies |
pending | Waiting for fee processing |
processing | Fee processing is in progress |
retrying | Fee processing failed and will be retried |
succeeded | The merchant alert fee was recorded |
failed | Fee processing exhausted its retry policy |
Dispute Prevention Values#
| Field | Value | Description |
|---|
method | rdr | Rapid Dispute Resolution |
prevention_status | prevented | The case was prevented from becoming a formal dispute |
refund_status | refunded | The provider completed the automatic refund |
action_required | false | No merchant response is required |
| Value | Description |
|---|
pending | Waiting for a final decision |
won | Merchant won |
lost | Merchant lost |
| Value | Description |
|---|
needs_response | Waiting for merchant action |
responded | Evidence response was submitted |
accepted | Merchant accepted the dispute and waived defense |
no_response_allowed | No further response is permitted |
unknown | Provider response state cannot currently be confirmed |
Order Dispute Projection#
| Value | Description |
|---|
| empty string | No dispute projection |
rdr_refunded | Refunded through RDR |
chargeback_pending | Formal dispute opened; funds are held pending a decision |
chargeback_lost | Formal dispute lost |
chargeback_won | Formal dispute won |
The chargeback_* values are current machine values used by the order and callback contract. Customer-facing documentation refers to them as formal dispute states.Wire Compatibility#
The customer-facing product name is Dispute Alert. The current type = 7 callback retains these legacy machine identifiers:event_type = chargeback_alert.created
Modified at 2026-07-30 04:23:10
