---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/push-notifications/index.md
  - https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/index.md
  - https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/index.md
  - href: en/push-notifications/index.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

{% note info "API notifications are not related to push-api — the old scheme of working with Yandex. Market." %}

 

{% endnote %}

# How to work with notifications

You can enable API notifications and Yandex.Market will send you a request. [POST notification](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md) with information about [the event](*notification-type) every time it happens.

This is an optional integration, you don't have to enable notifications. However, with their help, you will be able to quickly respond to changes in orders, non-purchases and refunds, as well as to requests for cancellation of the order.

The market exchanges data only with stores that operate over HTTPS using an SSL certificate. It must be signed by an official certification authority, a self-signed certificate will not work. Information about certification authorities can be found on the Internet.

{% note tip "Check each request against IP address ranges." %}

The security of your integration depends on it. — this way you will make sure that the request came from Yandex.Market.

Ranges of IP addresses used by the Market:

* [5.45.207.0/25](*ip-range-5-45-207)
* [141.8.142.0/25](*ip-range-141-8-142)
* [5.255.253.0/25](*ip-range-5-255-253)

{% endnote %}


## Enabling integration {#how-to-start}

![Screenshot of enabling integration](../_images/new-notification.png)

To receive notifications from Yandex.Market:

1. In the seller's account on the Market, click on the icon of your account → **Settings** and in the menu on the left, select **APIs and modules** → tab **API notifications**.

1. Click the button **Enable notifications**.

1. Specify the notification name — you will only need it to search for the notification in the list.

1. Select whether you are setting up notifications for your merchant profile or store:

    <br>

    #|
    || | **Notifications are coming** | **The role required to set up the notification**

    [What are the roles?](https://yandex.ru/support2/marketplace/ru/account/permissions/roles)||
    || office | for all cabinet stores| cabinet owner or cabinet manager ||
    || shop | for a specific store | any role other than a content manager ||
    |#

1. Select the types of notifications you want to receive:

    | **Notification**                         | **Comes for the cabinet** | **It comes for the store** |
    | -------------------------------------   | ------------------------- | ------------------------- |
    | creating an order                         | ✔️ | ✔️ |
    | changing the order                        | ✔️ | ✔️ |
    | changing the order status                | ✔️ | ✔️ |
    | order cancellation                           | ✔️ | ✔️ |
    | creating an order cancellation request        | ✔️ | ✔️ |
    | making a refund or non-purchase          | ✔️ | ✔️ |
    | changing the refund or non-purchase status | ✔️ | ✔️ |
    | new review                             | ✔️ | |
    | new review comment              | ✔️ | |
    | new chat with the buyer                 | ✔️ | |
    | new message in the chat                  | ✔️ | |
    | the beginning of the dispute                            | ✔️ | |
    | ending the dispute                        | ✔️ | |

    ⚠️ If order-related notifications are configured for the merchant profile, they are also sent by FBY- orders.

   {% note warning "If notifications are configured for both the cabinet and the store" %}

    If you have enabled notifications for both the cabinet and the store — Yandex.Market will send **only one notification** on URL the store.

    Notification on URL The merchant's account will be sent only if the store does not have this type of notification enabled.

    {% endnote %}

1. Enter the link where Yandex.Market will send notifications. Specify it in its entirety, including the HTTPS protocol.

1. Click the button **Plug**. The created notifications will appear in the dashboard immediately, but they will start arriving. **within 2 minutes**.

### Checking the integration {#check}

To check the functionality of the integration, yandex.Market will send a request [POST notification](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md) where there will be a verification notification in the body with the type `PING`.

{% cut "Request body example" %}

```json translate=no
{
  "notificationType": "PING",
  "time": "2025-01-16T10:09:49.759084017Z"
}
```
{% endcut %}

Return the response with the code `200` and information about notification processing within 1 second. Integration will not be enabled if another code, incorrect or insufficient data is transmitted. [Possible errors](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/concepts/error-codes.md#shop-errors)

{% cut "Example of the response body" %}

```json translate=no
{
  "version": "1.0.0",
  "name": "name",
  "time": "2025-01-16T10:09:49.759084017Z"
}
```
{% endcut %}

## Response to the request {#how-to-response}

The response time for regular notifications is 10 seconds, for verification notifications such as `PING` — 1 second.

* If the request was correct, return the code `200` with information about notification processing. [Response body](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md#200-ok)

* If the Market has sent an incorrect notification, return the code. `400` with a description of the error. The market will analyze such responses and refine the API on its part. [Response body](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md#400-bad-request)

* If there is a technical error on your side, please return the code. `500`. [Response body](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md#500-internal-server-error)

Detailed information on requests and responses, including errors, can be viewed in the seller's account on the Market. — click on your account icon → **Settings** and in the menu on the left, select **APIs and modules** → tab **Notification Log**. Read more about this in the section [Request logs](https://yandex.com/dev/market/partner-api/doc/en/concepts/debug.md).

[Possible errors](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/concepts/error-codes.md#shop-errors)


### The store's API is not responding {#no-answer}

If the store does not meet the ten-second timeout or the request [POST notification](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md) returns an error except `400`, Market:

* It stops sending other notifications until it receives a suitable response to the problematic request.
* Repeats the problematic query:

  1. Every minute for the first hour.
  1. Every 15 minutes during the first day.
  1. Then once an hour.

If the store's API is unavailable within 14 days of sending the first notification, the store is disabled. **from integration**, but continues to post and sell products. Yandex.Market will cancel all notifications that it could not send before disconnecting, and will not send new ones.

To continue receiving notifications, connect them again. For more information on how to do this, see [Notification Management](#manage).


## Notification Management {#manage}

{% note warning "After changing the notification" %}

The information in the dashboard will be updated immediately, but notifications will start coming or turn off. **within 2 minutes**.

{% endnote %}

![Screenshot of connected integrations](../_images/all-notifications.png)

{% cut "To change" %}

You can edit the name and types of notifications, as well as the link to send them. To do this:

1. In the seller's account on the Market, click on the icon of your account → **Settings** and in the menu on the left, select **APIs and modules** → tab **API notifications**.

1. Find the notification you need, tap the three dots next to it and select **Edit**.

1. Change the required information.

1. Click **Plug**.

{% endcut %}

{% cut "Unplug" %}

You can disable sending notifications without deleting them. To do this:

1. In the seller's account on the Market, click on the icon of your account → **Settings** and in the menu on the left, select **APIs and modules** → tab **API notifications**.

1. Find the notification you need, tap the three dots next to it and select **Unplug**.

{% endcut %}


{% cut "Plug" %}

To make the disabled notification work again:

1. In the seller's account on the Market, click on the icon of your account → **Settings** and in the menu on the left, select **APIs and modules** → tab **API notifications**.

1. Find the notification you need, tap the three dots next to it and select **Plug**.

1. If notifications were disabled by Yandex.Market, you will receive a request. [POST notification](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md) where there will be a verification notification in the body with the type `PING`. Return the response with the code `200` and information about notification processing within 1 second.

{% endcut %}

{% cut "Duplicate settings" %}

To avoid creating notifications for the store from scratch, duplicate the settings you have already created for another store:

1. In the seller's account on the Market, click on the icon of your account → **Settings** and in the menu on the left, select **APIs and modules** → tab **API notifications**.

1. Find the notification you need, tap the three dots next to it and select **Duplicate settings**.

1. Specify the desired store.

1. Click **Duplicate**.

{% endcut %}

{% cut "Remove" %}

To delete a notification:

1. In the seller's account on the Market, click on the icon of your account → **Settings** and in the menu on the left, select **APIs and modules** → tab **API notifications**.

1. Find the notification you need, tap the three dots next to it and select **Remove**.

1. Confirm the deletion.

{% endcut %}

[*notification-type]: Events for which Yandex.Market sends notifications:<ul><li>creating a new order;</li><li>changing the order;</li><li>changing the order status;</li><li>creating a new chat with a customer;</li><li>adding a new chat message;</li><li>the beginning of the dispute;</li><li>ending the dispute;</li><li>creating a new product review;</li><li>creating a new review comment;</li><li>creating an order cancellation request;</li><li>order cancellation;</li><li>creating a new non-purchase or refund;</li><li>changing the non-purchase or refund status.</li></ul>Notifications will also be sent for test orders.

[*ip-range-5-45-207]: Addresses from 5.45.207.0 to 5.45.207.127

[*ip-range-141-8-142]: Addresses from 141.8.142.0 to 141.8.142.127

[*ip-range-5-255-253]: Addresses from 5.255.253.0 to 5.255.253.127