post https://api.chargeflow.io/public/2025-04-01/alerts//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
cdrnandethoca. Updating these outcomes is mandatory in Merchant-Managed Handling. tc40alerts are automatically marked as"acknowledged"and do not require an update.rdralerts are automatically refunded and therefore do not require an outcome update.- Outcomes may only be updated for alerts with a non-final outcome (
nullorpending). 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
| Outcome | Description |
|---|---|
refunded | The transaction was refunded successfully. |
transaction_not_found | No matching transaction could be found to process a refund. |
previously_refunded | The transaction was already refunded before the alert. |
duplicate | The alert was identified as a duplicate of a previous alert. |
decline | The refund request was declined, no refund was issued. |
error | A general error occurred (e.g., insufficient funds, invalid card, other). |