GuidesAPI Reference
API Reference

Update Alert Outcome

The Update Alert Outcome endpoint allows merchants and platforms who manage refunds themselves to notify Chargeflow of the final outcome for a given alert. Updating the outcome ensures Chargeflow can report back to the alert provider (Verifi & Ethoca) and prevent escalation to a chargeback.

This endpoint is only required if you are using the Merchant-Managed Handling integration model. In this case, it is crucial to report back the outcomes of CDRN and Ethoca alerts. If such cases are resolved by issuing refunds but the outcomes are not reported, they may still escalate into chargebacks.

Important Notes

  • You are only required to update outcomes for alerts of type cdrn and ethoca. Updating these outcomes is mandatory in Merchant-Managed Handling.
  • tc40 alerts are automatically marked as "acknowledged" and do not require an update.
  • rdr alerts are automatically refunded and therefore do not require an outcome update.
  • Outcomes may only be updated for alerts with a non-final outcome (null or pending). You can check the current outcome using the Get Alert by Id (GET /alerts/{id}) endpoint.
  • Once submitted, the outcome is final and cannot be changed. Any duplicate submission for the same alert will result in an error.
  • You can only update outcomes for alerts associated with your own Chargeflow account.

Allowed Outcome Values

OutcomeDescription
refundedThe transaction was refunded successfully.
transaction_not_foundNo matching transaction could be found to process a refund.
previously_refundedThe transaction was already refunded before the alert.
duplicateThe alert was identified as a duplicate of a previous alert.
declineThe refund request was declined, no refund was issued.
errorA general error occurred (e.g., insufficient funds, invalid card, other).
Language
Credentials
Header
Click Try It! to start a request and see the response here!