Апелляции

Процесс разрешения споров

В рамках процесса разрешения споров мерчант выполняет следующие действия:

• Спор инициируется мерчантом или сотрудником службы поддержки.
• Платформа проводит расследование обстоятельств сделки с привлечением подрядчиков.
• В случае недостаточности доказательств апелляция может быть отклонена, при этом существует возможность повторного создания апелляции.
• Выносится окончательное решение по сделке.

Создание апелляции

Info

Подробная схема данных для запросов и ответов

POST /paysystem/v1/appeals/

Поле	Описание	Тип	Обязательное
order_id	Идентификатор заказа.	integer	Да
appeal_kind	Тип апелляции. Возможные значения:	string	Да
	pay_in_research – Розыск платежа
	pay_in_recalculate – Пересчёт платежа
description	Описание апелляции.	string	Нет
final_amount	Конечная сумма.	number/string	Нет
files_base64	Массив файлов в формате Data URI. Каждый файл в виде data:[<mediatype>][;base64],<data>	array	Нет

Пример

Пример запроса

curl -X POST "https://api.epicsplat.com/paysystem/v1/appeals/" \
-H "Content-Type: application/json" \
-d '{
    "order_id": 12345,
    "appeal_kind": "pay_in_research",
    "description": "Запрос на розыск платежа."
}'

Пример ответа:

{
    "id": 1,
    "order_id": 12345,
    "appeal_kind": "pay_in_research",
    "description": "Запрос на розыск платежа.",
    "final_amount": 100.00,
    "created_at": "2023-10-01T12:00:00Z",
    "updated_at": "2023-10-01T12:00:00Z",
    "fulfilled_at": null,
    "status": "pending",
    "reject_reason": null,
    "approve_reason": null,
    "attachments": []
}

---

Примечания

• Поле order_id является обязательным для заполнения.
• Поле appeal_kind определяет тип апелляции и должно содержать одно из указанных значений.
• Поле description является необязательным и может быть пустым. Виден всем причастным к апелляции.
• Поле files_base64 позволяет прикреплять файлы в формате base64 и также может быть пустым.

Обзор апелляции

GET /paysystem/v1/appeals/{appeal_id}

Поле	Описание	Тип	Обязательное
id	Идентификатор апелляции.	integer	Да
order_id	Идентификатор заказа, к которому относится апелляция.	integer	Да
appeal_kind	Тип апелляции. Возможные значения: pay_in_research Розыск платежа pay_in_recalculate Пересчёт платежа	string	Да
description	Описание апелляции.	string	Да
final_amount	Конечная сумма. Может быть числом, строкой или null.	number/string/null	Да
created_at	Дата и время создания апелляции.	string (date-time)	Да
updated_at	Дата и время последнего обновления апелляции.	string (date-time)	Да
fulfilled_at	Дата и время выполнения апелляции. Может быть null.	string	Нет
status	Статус апелляции. Возможные значения: pending Ожидание approved Подтверждено rejected Отклонено	string	Да
reject_reason	Причина отклонения апелляции. Возможные значения: fake_receipt Поддельный чек payment_not_found Платеж не найден merchant_force_reject Мерчант отклонил	string/null	Нет
approve_reason	Причина подтверждения апелляции. Возможные значения: customer_fault Ошибка покупателя	string/null	Нет
attachments	Массив вложений, связанных с апелляцией.	array	Нет

---

Примечания

• Поля id, order_id, description, final_amount, created_at, updated_at и fulfilled_at являются обязательными для заполнения.
• Поля reject_reason и approve_reason могут быть null, если соответствующая причина не применима.

HTTP Callback апелляции

Адрес для отправки вебхука указывается в настройках "Площадки" в личном кабинете мерчанта.

Внимание!

После получения колбека об изменении статуса апелляции, необходимо выполнить следующие действия:

1. Сделать запрос на обновление ордера, к которому привязана данная апелляция.
2. Обновить данные в системе согласно информации из обновленного ордера.

Пожалуйста, убедитесь, что все изменения были корректно применены.

Поле	Описание	Тип	Обязательное
operation	Операция, всегда равная appeal_update.	string	Да
id	Идентификатор апелляции.	integer	Да
order_id	Идентификатор заказа, к которому относится апелляция.	integer	Да
appeal_kind	Тип апелляции. Возможные значения: pay_in_research Розыск платежа pay_in_recalculate Пересчёт платежа	string	Да
description	Описание апелляции.	string	Да
final_amount	Конечная сумма. Может быть числом, строкой или null.	number/string/null	Да
created_at	Дата и время создания апелляции.	string (date-time)	Да
updated_at	Дата и время последнего обновления апелляции.	string (date-time)	Да
fulfilled_at	Дата и время выполнения апелляции. Может быть null.	string	Нет
status	Статус апелляции. Возможные значения: pending Ожидание approved Подтверждено rejected Отклонено	string	Да
reject_reason	Причина отклонения апелляции. Возможные значения: fake_receipt Поддельный чек payment_not_found Платеж не найден merchant_force_reject Мерчант отклонил	string/null	Нет	Нет
approve_reason	Причина подтверждения апелляции. Возможные значения: customer_fault Ошибка покупателя	string/null	Нет

Примечания

• Не содержит вложения (attachments)

Пример JSON-объекта, отправляемого в вебхуке:

{
    "operation": "appeal_update",
    "id": 1,
    "order_id": 12345,
    "appeal_kind": "pay_in_research",
    "description": "Запрос на розыск платежа.",
    "final_amount": null,
    "created_at": "2023-10-01T12:00:00Z",
    "updated_at": "2023-10-01T12:01:00Z",
    "fulfilled_at": "2023-10-01T12:01:00Z",
    "status": "approved",
    "reject_reason": null,
    "approve_reason": "customer_fault"
}