Отмена платежа

Метод Cancel payment используется для отмены платежа текущего реселлера или любого из его нижестоящих реселлеров. Отменить можно только платежи в статусе Ожидает оплаты, у которых нет связи с актом для модели Постоплата (см. Управление актами).

Для авторизации требуется API-токен менеджера (сотрудника). API-токен можно получить через Панель управления Оператора (см. Просмотр и обновление информации о сотруднике).

По указанному в запросе API-токену определяются:

Роль и уровень доступа менеджера, от которых зависит доступность метода.
Текущий реселлер и его нижестоящие реселлеры, доступные в рамках метода.

DELETE {base_url}/api/v3/resellers/{reseller_id}/payments/{payment_id}

Аргументы

Название	Тип параметра	Тип данных	Обязательный/ Опциональный	Описание
X-Api-Token	header	string	Обязательный	API-токен сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-Type	header	string	Обязательный	Тип данных, передаваемых в запросе. Необходимо указать: application/vnd.api+json
Accept	header	string	Обязательный	Поддерживаемые типы данных в ответе. Необходимо указать: application/vnd.api+json
base_url	path	string	Обязательный	URL ActivePlatform
reseller_id	path	number	Обязательный	ID реселлера. Возможно указать ID текущего реселлера или ID любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере)
payment_id	path	number	Обязательный	ID платежа

Модель ответа

При успешной отмене платежа метод возвращает информацию о платеже (см. Получение информации о платеже без включения в ответ дополнительной информации included о связанных объектах).

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

DELETE/api/v3/resellers/1/payments/6476
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

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

{
    "data": {
        "id": "6476",
        "type": "payments",
        "attributes": {
            "created_at": "2019-11-01T06:37:31.737051+0300",
            "updated_at": "2019-11-01T07:56:50.551216+0300",
            "account_id": 505,
            "discount_amount": "0.0",
            "total": "199.99",
			"currency_code": "USD",
            "comment": "top-up payment",
            "status": "cancelled",
            "document_id": "2005259",
            "expiration_date": null,
            "payment_method_id": null,
            "requester_ip": null,
            "manager_id": null,
			"purpose": "",
            "external_total": null,
            "external_currency": null,
            "due_date": null,
            "payment_method_name": null,
            "closed_at": "2019-11-01T07:56:50.520553+0300"
        },
        "relationships": {
            "orders": {
                "data": []
            },
            "invoices": {
                "data": []
            },
            "corrections": {
                "data": []
            },
            "reseller": {
                "data": {
                    "id": "1",
                    "type": "resellers"
                }
            },
            "account": {
                "data": {
                    "id": "505",
                    "type": "accounts"
                }
            },
            "payment_method": {
                "data": null
            }
        }
    }
}

Ошибки

При попытке отменить платеж в статусе, отличном от Ожидает оплаты, метод возвращает следующее описание ошибки 422:

{
    "errors": {
        "title": "Only payments with \"waiting for payment\" status can be cancelled.", "status": "422"",
        "status": "422"
    }
}

При попытке отменить платеж, который связан с актом по модели Постоплата, метод возвращает следующее описание ошибки 422:

{
    "errors": {
        "title": "Only payments for prepaid payment model can be cancelled.",
        "status": "422"
    }
}