Создание платежа на пополнение баланса клиента

Метод Create payment используется для создания платежа на пополнение баланса клиента текущего реселлера или любого из его нижестоящих реселлеров.

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

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

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

POST {base_url}/api/v3/resellers/{reseller_id}/payments

{
    "data":
    {
        "attributes":
        {
            "account_id": {account_id},
            "total": {amount_of_payment},
            "comment": "{comment}",
            "purpose": "{payment_purpose}"
        } 
    }
     
}

Аргументы

Название	Тип параметра	Тип данных	Обязательный/ Опциональный	Описание
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 любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере)
account_id	form	number	Обязательный	ID клиента, для которого создается платеж
total	form	number	Обязательный	Сумма платежа в валюте реселлера
comment	form	string	Обязательный	Комментарий к платежу
purpose	form	string	Опциональный	Назначение платежа для пополнения баланса клиента. Отображается в форме счета на оплату (см. Ручное создание платежа)

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

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

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

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

{
    "data":
    {
        "attributes":
        {
            "account_id": 505,
            "total": 199.99,
            "comment": "top-up payment",
            "purpose": "prepay payment"
        } 
    }
     
}

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

{
    "data": {
        "id": "6477",
        "type": "payments",
        "attributes": {
            "created_at": "2019-11-01T06:49:55.347536+0300",
            "updated_at": "2019-11-01T06:49:55.347536+0300",
            "account_id": 505,
            "discount_amount": "0.0",
            "total": "199.99",
			"currency_code": "USD",
            "comment": "top-up payment",
            "status": "waiting_for_payment",
            "document_id": "2005260",
            "expiration_date": null,
            "payment_method_id": null,
            "requester_ip": null,
            "manager_id": null,
            "purpose": "prepay payment",
            "external_total": null,
            "external_currency": null,
            "due_date": null,
            "payment_method_name": null,
            "closed_at": null
        },
        "relationships": {
            "orders": {
                "data": []
            },
            "invoices": {
                "data": []
            },
            "charges": {
                "data": []
            },
            "corrections": {
                "data": []
            },
            "reseller": {
                "data": {
                    "id": "1",
                    "type": "resellers"
                }
            },
            "account": {
                "data": {
                    "id": "505",
                    "type": "accounts"
                }
            },
            "payment_method": {
                "data": null
            }
        }
    }
}