---
title: "payments.pre-chargeback-alert.received"
method: POST
path: "preChargebackAlertReceived"
---

# payments.pre-chargeback-alert.received

`POST preChargebackAlertReceived` (webhook)

Triggered when Evervault receives a new pre-chargeback alert for your app. The `data`
field contains the full Pre-Chargeback Alert object.

## Payload

- object
  - `id` string: The id of the webhook event.
  - `type` 'payments.pre-chargeback-alert.received': The type of webhook event.
  - `data` PreChargebackAlert: A pre-chargeback alert received from Ethoca or Verifi RDR.
    - `id` string, required: A unique identifier for the alert.
    - `merchantId` string, required: The Evervault Merchant ID associated with the alert.
    - `alertType` 'ETHOCA_ALERT' | 'VERIFI_RDR', required: The alert network that originated the alert.
    - `alertNetworkId` string, nullable: The alert identifier from the alert network.
    - `status` 'ACTION_REQUIRED' | 'RESOLVED' | 'INVALID', required: The current status of the alert. `ACTION_REQUIRED` only applies to Ethoca alerts.
    - `chargebackReasonCode` string, nullable: The reason code identifying why the dispute was raised.
    - `transactionAmountInCents` integer, nullable: The disputed transaction amount in cents.
    - `transactionCurrencyCode` string, nullable: The ISO 4217 currency code of the disputed transaction.
    - `transactionAuthorizedAt` string, date-time, nullable: When the transaction was authorized, as an ISO 8601 timestamp in UTC.
    - `actionRequiredDeadline` string, date-time, nullable: The deadline by which an Ethoca alert must be actioned. After this time the chargeback proceeds regardless of whether you refunded the customer.
    - `transactionAuthorizationCode` string, nullable: The authorization code for the disputed transaction.
    - `transactionAcquirerReferenceNumber` string, nullable: The Acquirer Reference Number (ARN). Useful when communicating with your PSP to identify the transaction.
    - `transactionStatementDescriptor` string, nullable: The descriptor that appeared on the cardholder's statement.
    - `transactionCardBin` string, nullable: The first 6–11 digits of the card number. Also included in `card.bin`.
    - `card` object, nullable: Card details for the disputed transaction, when available.
      - `bin` string, nullable: The BIN/IIN of the card.
      - `lastFour` string, nullable: The last four digits of the card number.
      - `brand` string, nullable: The card scheme (for example `VISA` or `MASTERCARD`).
      - `issuer` string, nullable: The issuing bank name.
    - `transactionRefundOutcome` 'REFUNDED' | 'NOT_REFUNDED' | 'null', nullable: Populated when a refund outcome is known. For Verifi RDR, this is set automatically.
    - `transactionNetworkId` string, nullable: The network transaction identifier, when available.
    - `subscriptionCancelOutcome` string, nullable: The outcome of a subscription cancellation, when available.
    - `note` string, nullable: An optional note stored with the alert for your own records.
    - `integrationId` string, nullable: An optional integration identifier associated with the alert.
    - `integrationTransactionId` string, nullable: An optional integration transaction identifier associated with the alert.
    - `createdAt` string, date-time, required: When the alert was created, as an ISO 8601 timestamp in UTC.
  - `createdAt` string, date-time: When the webhook event was created.

---

[API](https://skmtc.dev/evervault/apis/evervault-api.md) - [All operations](https://skmtc.dev/evervault/apis/evervault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evervault/apis/evervault-api/revisions/8d0ca833fa04?raw)