---
title: "Send Notifications"
method: PATCH
path: "/v1/antifraud/notifications/{id}"
tags: ["Support Services"]
---

# Send Notifications

`PATCH /v1/antifraud/notifications/{id}`

API to send notifications about an evaluated transaction.
The types of notifications:
- RFI: Notify a request for information (internal, from a bank, or from any entity)
- Chargeback: Notify a chargeback (internal, from a bank, or from any entity)
- Status 
   - Collected: Transaction payment was settled
   - Not Collected: Transaction payments was failed
   - Cancelled: Transaction was cancelled
   - Finalized: Transaction finalized OK
   - Refunded: Transaction payment was refunded
   - Authorized: Transaction payment was authorized
   - Recovering: In case a strategy has been applied, informs the result. See [Strategies](https://api-koin.readme.io/reference/strategies)
- Info: Other type of information

## Path parameters

- `id` string, required

## Query parameters

- `field` 'EVALUATION_ID' | 'REFERENCE_ID'

## Request body

- union
  - object
    - `type` 'CHARGEBACK', required — Notification type
    - `sub_type` 'FRAUD' | 'NON_FRAUD' | 'PENDING' — Notification subtype
    - `message` string — Descriptive message about notification
    - `notification_date` string, required — Notification date
    - `details` object — Notification details. It's a set of key/value pairs
  - object
    - `type` 'INFO', required — Notification type
    - `message` string — Descriptive message about notification
    - `notification_date` string, required — Notification date
    - `details` object — Notification details. It's a set of key/value pairs
  - object
    - `type` 'STATUS', required — Notification type
    - `sub_type` 'COLLECTED' | 'NOT_COLLECTED' | 'CANCELLED' | 'FINALIZED' | 'RECOVERING' | 'REFUNDED' | 'AUTHORIZED', required — Notification subtype
    - `message` string — Descriptive message about notification
    - `notification_date` string, required — Notification date
    - `details` object — Notification details. It's a set of key/value pairs
    - `reason` string — Reason for the notification. Applies to CANCELLED and NOT_COLLECTED sub_types. For CANCELLED sub_type, allowed values are COLLECT_ERROR, REQUESTED_BY_CUSTOMER, REQUESTED_BY_COMMERCE. For NOT_COLLECTED sub_type, it is a free text field.
    - `suspect` boolean — Indicates whether the transaction is suspected of fraud. Applies to NOT_COLLECTED sub_type.
    - `authorization_code` string — Authorization code. Applies to COLLECTED sub_type.
    - `payment_id` string — Payment Identifier. Applies to COLLECTED sub_type.
    - `full` boolean — Indicates if it is a full refund. Applies to REFUNDED sub_type.
    - `strategies` StrategiesNotification[] — Strategies applied. Applies to RECOVERING sub_type.
      - `type` 'DocumentScan' | 'VerificationCode' | 'CollectAuthRecovery' — Strategy type
      - `results` ResultsNotification[]
        - `channel` string — Channel applied to strategy
        - `provider` '3DS2' — Provider for the strategy. Used in case of CollectAuthRecovery strategy
        - `mode` 'FRICTIONLESS' | 'CHALLENGE' — Mode for the strategy. Used in case of CollectAuthRecovery strategy
        - `status` 'Accept' | 'Reject' — Strategy status
        - `reason` string — Extra additional information of the strategy applied
        - `images` ImageNotification[]
          - `document_id` string — Image identifier
          - `category` string — Image category
          - `url` string — Image url
          - `created` string — Image created date
  - object
    - `type` 'RFI', required — Notification type
    - `sub_type` 'FRAUD' | 'NON_FRAUD' | 'PENDING' — Notification subtype
    - `message` string — Descriptive message about notification
    - `notification_date` string, required — Notification date
    - `details` object — Notification details. It's a set of key/value pairs

## Response `200`

Notifications response

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/koin/apis/payments-api.md) · [All operations](https://skmtc.net/koin/apis/payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/koin/payments-api/versions/6f2c01e43fe2/schema)