---
title: "Mark transaction as alert"
method: POST
path: "/transactions/{transaction_id}/alert"
tags: ["Transactions"]
---

# Mark transaction as alert

`POST /transactions/{transaction_id}/alert`

By default, Vrio will flag the customer as Blacklisted and cancel any active order offers associated with the charge. Note - if the Alert Refund happens outside of the gateway, leave refund_transaction=0. Learn more <a href='https://vrio.zendesk.com/hc/en-us/articles/16089666241815-Disputes-Alert-Handling' target='_blank'>here</a>.

## Request body

- object
  - `date` string, date, required — Set the date of the alert.
  - `amount` string — Amount. If amount is not passed, the full amount of the transaction will be used.
  - `refund_transaction` boolean — Should the original transaction be automatically refunded at the gateway.
  - `code` string — Alert code.
  - `alert_case_id` string — Alert case ID.
  - `cancel_all_customer_order_offer` boolean — Pass this flag if you would like to cancel All active order offers associated with the customer, not just the ones associated with the charge.
  - `cancel_active_shipment` boolean — Cancel any active shipment associated with the transaction.
  - `transaction_notes` string — Apply note to the history of this transaction.

## Response `200`

OK

- object
  - `success` boolean
  - `response_code` integer
  - `response` string
  - `gateway_response_id` string
  - `gateway_response_gateway_id` string
  - `gateway_response_code` string
  - `gateway_auth_code` string
  - `gateway_response_cvv` string
  - `gateway_response_avs` string
  - `gateway_response_text` string
  - `gateway_request_text` string
  - `processor_response_text` string
  - `date_request` string, date-time, nullable
  - `date_response` string, date-time, nullable
  - `merchant_id` integer
  - `merchant_descriptor` string, nullable
  - `reason` string, nullable — Reason in case of merchant error.
  - `gateway_response_description` string
  - `gateway_hard_decline` string
  - `transaction_id` integer
  - `transaction_total` string
  - `post_data` string, nullable
  - `shipment_id` integer, nullable
  - `reattempt_data` object[]
    - `success` boolean
    - `response_code` integer
    - `response` string
    - `gateway_response_id` string
    - `gateway_response_gateway_id` string
    - `gateway_response_code` string
    - `gateway_auth_code` string
    - `gateway_response_cvv` string
    - `gateway_response_avs` string
    - `gateway_response_text` string
    - `gateway_request_text` string
    - `processor_response_text` string
    - `date_request` string, date-time, nullable
    - `date_response` string, date-time, nullable
    - `merchant_id` integer
    - `merchant_descriptor` string, nullable
    - `reason` string, nullable — Reason in case of merchant error.
    - `gateway_response_description` string
    - `gateway_hard_decline` string
    - `transaction_id` integer
    - `transaction_total` string
    - `post_data` string, nullable
    - `shipment_id` integer, nullable

## Other responses

- `400` — Process Error response
- `401` — Unauthorized response
- `403` — Forbidden response
- `500` — Error response

---

[API](https://skmtc.net/vrio/apis/crm-configuration.md) · [All operations](https://skmtc.net/vrio/apis/crm-configuration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vrio/crm-configuration/revisions/62037010356e/schema)