Изменение статуса заказа
Присылается в момент изменения статуса заказа.
Важно! В случае получения повторного уведомления типа Изменения статуса заказа (с тем же
order_id
) ответ должен в точности повторять ответ для исходного уведомления.
Например, если было отправлено это уведомление, и был получен положительный ответ, но он не дошел до сервера ВКонтакте, или по каким-то временным причинам не удалось перевести заблокированные средства на счет приложения сразу после получения ответа, такое же уведомление будет отправлено повторно. При этом не нужно выполнять новый заказ, достаточно просто прислать тот же ответ, что и в предыдущий раз (сохранив у себя order_id
и проверив по нему, что такое уведомление уже приходило).
Параметры уведомления
Название параметра | Примечение |
---|---|
notification_type string | Тип уведомления. Равен order_status_change или order_status_change_test . |
app_id integer | Идентификатор приложения. |
user_id integer | Идентификатор пользователя, сделавшего заказ |
receiver_id integer | Идентификатор получателя заказа (в данный момент совпадает с user_id , но в будущем может отличаться). |
order_id integer | Идентификатор заказа в системе платежей ВКонтакте |
date integer | Дата создания заказа (в формате Unixtime ). |
status string | Новый статус заказа. Возможные значения: chargeable — заказ готов к оплате. Необходимо оформить заказ пользователю внутри приложения. В случае ответа об успехе платёжная система зачислит голоса на счёт приложения. Если в ответ будет получено сообщение об ошибке, заказ отменяется. refunded — заказ отменён. Необходимо забрать игровые ценности, выданные пользователю за платежи. Доступен начиная с версии API 5.132. |
sig string | Подпись уведомления (см. Проверка подписи уведомления) |
item string | Наименование товара, переданное диалоговому окну покупки (см. Параметры диалогового окна платежей). |
item_id integer | Идентификатор товара в приложении. |
item_title string | Название товара. |
item_photo_url string | Изображение товара. |
item_price string | Стоимость товара. |
item_discount string | Размер скидки на товара, если она есть. |
Параметры ответа
Название параметра | Примечение |
---|---|
order_id integer , обязательный | Идентификатор заказа в системе платежей ВКонтакте. |
app_order_id integer | Идентификатор заказа в приложении. Должен быть уникальным для каждого заказа. |
Пример ответа
JSON
{
"response": {
"order_id": 1111,
"app_order_id": 6492
}
}
Пример ответа в случае ошибки
JSON
{
"error": {
"error_code":21,
"error_msg":"Нет в наличии",
"critical":1
}
}