Create alert outcome

Create and record the outcome of a pre-chargeback alert (e.g., refunded, resolved, accepted). Pre-chargeback alerts are early warnings that allow merchants to take action before a chargeback is filed.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Pre-chargeback alerts are early warnings — sent by card networks and issuers through Ethoca and Verifi (CDRN / RDR) — that let you resolve a transaction before it turns into a chargeback. Justt receives these alerts, normalizes them, and pushes each one to you through the pre_chargeback_alert.received webhook.

Use this endpoint to report back what you did with an alert (for example: refunded the customer, stopped the order, or couldn't act in time). Justt records your response and relays it to the alert provider to complete the resolution.

Typical flow

  1. Receive a pre_chargeback_alert.received webhook and match it to the order on your side.
  2. Take action (issue a refund, stop fulfillment, etc.).
  3. Call this endpoint with the result, using the alert's internalAlertId (from the webhook) as alertId.

This endpoint applies to Ethoca and Verifi CDRN alerts. Verifi RDR alerts resolve automatically through a network-driven refund and don't require a response here — track them through the pre_chargeback_alert.refund.succeeded / pre_chargeback_alert.refund.failed webhook events instead.

Choosing outcome and refunded

outcome and refunded are not free-form — the valid values depend on the provider, and for Ethoca also on the alert type. providerName accepts Ethoca and Verifi CDRN only; Verifi RDR is not supported here (RDR resolves automatically via refund — track it through the pre_chargeback_alert.refund.* webhooks, not this endpoint).

Ethoca — report the refund in refunded and the resolution in outcome. The valid outcome values depend on whether the alert is a fraud alert or a customer-dispute alert.

Ethoca — fraud alerts

outcomeMeaningTypical refunded
stoppedOrder stopped before fulfillmentrefunded
partially_stoppedPart of the order stoppedrefunded
previously_cancelledTransaction already cancelled before the alertrefunded / not settled
missedToo late — order shipped or service consumednot refunded
notfoundOrder could not be locatednot refunded
account_suspendedCustomer account suspendednot refunded
shipper_contactedIntercept of goods being attemptednot refunded
otherAnything else — explain in comments

Ethoca — customer-dispute alerts

outcomeMeaningTypical refunded
resolvedResolved with the customerrefunded
previously_refundedRefund already processedrefunded
unresolved_disputeMerchant disagrees with the dispute reasonnot refunded
otherAnything else — explain in comments

Verifi CDRN — a single set of numeric reason codes. The code you send already states whether a credit was processed, so refunded just mirrors that result.

outcomeMeaningCredit result
100Case resolved — credit & cancellation processedRefunded
101Case resolved — partial credit & cancellation processedRefunded (partial)
951Previously credited for the case amount, no balance remainingRefunded
102Case resolved — authorization cancelledNot settled
130Cancellation processedNot settled
900Unmatched case — general / otherNot refunded
901Unmatched case — merchant not participatingNot refunded
902Unmatched case — unable to locate original transactionNot refunded
940Duplicate requestNot refunded
950Merchant account closed — unable to process creditNot refunded
952Transaction previously received a chargeback, no balance remainingNot refunded
953Request is outside the eligibility timeframeNot refunded
954Transaction 3-D Secure authenticated successfullyNot refunded
955Could not honor the cancel requestNot refunded
956Matched — unable to stop order fulfillmentNot refunded
957Matched — proceed with chargeback for resolutionNot refunded

Body Params

Alert outcome data including alert ID, provider name, and outcome details

string
enum
required

The provider name of the alert

Allowed:
string
required

A unique alert Identifier (UUID) set by Justt

string
enum

Whether the transaction was refunded, not refunded, or not settled

Allowed:
string
enum

The outcome for the alert

string
length ≤ 500

Additional comments to be provided with the outcome

Headers
string

If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json