Завершение платежа по номеру
Метод Complete payment by document ID используется для завершения платежа по его номеру document_id
для текущего реселлера или любого из его нижестоящих реселлеров, например, при получении оплаты во внешних системах. Завершить можно только платежи со статусами Ожидает оплаты и Просрочен.
Платеж также можно завершить по его ID (см. Завершение платежа по ID).
Для авторизации требуется API-токен менеджера (сотрудника). API-токен можно получить через Панель управления Оператора (см. Просмотр и обновление информации о сотруднике).
По указанному в запросе API-токену определяются:
- Роль и уровень доступа менеджера, от которых зависит доступность метода.
- Текущий реселлер и его нижестоящие реселлеры, доступные в рамках метода.
POST {base_url}/api/v3/resellers/{reseller_id}/payments/{document_id}
{
"data": {
"attributes": {
"payment_method_id": "{payment_method_id}",
"total": {total},
"currency_code": "{currency_code}"
}
}
}
Аргументы
Название | Тип параметра | Тип данных | Обязательный/ | Описание |
---|---|---|---|---|
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 | integer | Обязательный | ID реселлера. Возможно указать ID текущего реселлера или ID любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере) |
document_id | path | integer | Обязательный | Номер платежа (см. Получение информации о платеже) |
payment_method_id | form | integer | Обязательный | ID способа оплаты для завершения платежа (см. Просмотр списка способов оплаты) |
total | form | number | Опциональный | Сумма платежа |
currency_code | form | string | Опциональный | Код валюты. Должен совпадать с кодом валюты платежа (см. Получение информации о платеже) |
Модель ответа
При успешном завершении платежа метод возвращает информацию о платеже (см. Получение информации о платеже без включения в ответ дополнительной информации included
о связанных объектах).
Пример запроса
POST /api/v3/resellers/1/payments/2005258
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
{
"data": {
"attributes": {
"payment_method_id": "2",
"total": 123.45,
"currency_code": "USD"
}
}
}
Пример ответа
{
"data": {
"id": "3212",
"type": "payments",
"attributes": {
"created_at": "2023-10-26T16:37:31.534421+0300",
"updated_at": "2023-10-26T16:37:43.325470+0300",
"account_id": 478,
"discount_amount": "0.0",
"total": "123.45",
"currency_code": "USD",
"comment": "1",
"status": "completed",
"document_id": "2005258",
"expiration_date": null,
"payment_method_id": 2,
"requester_ip": "10.11.12.13",
"manager_id": 6,
"purpose": "",
"external_total": null,
"external_currency": null,
"payment_method_name": "Check",
"closed_at": "2023-10-26T16:37:43.325470+0300"
},
"relationships": {
"orders": {
"data": []
},
"invoices": {
"data": []
},
"charges": {
"data": []
},
"reseller": {
"data": {
"id": "1",
"type": "resellers"
}
},
"account": {
"data": {
"id": "478",
"type": "accounts"
}
},
"payment_method": {
"data": {
"id": "2",
"type": "payment_methods"
}
}
}
}
}
Ошибки
Статус | Код ошибки | Текст ошибки | Комментарий |
---|---|---|---|
404 | PAYMENT-001 | Не найден обязательный параметр document_id | Проверьте правильность номера платежа (см. Получение информации о платеже) |
PAYMENT-002 | Не найден обязательный параметр payment_method_id | Проверьте правильность ID способа оплаты (см. Просмотр списка способов оплаты) | |
PAYMENT-003 | Переданный currency_code не совпадает с currency_code платежа | Проверьте правильность кода валюты платежа (см. Получение информации о платеже) | |
422 | - | Only payments with \"waiting for payment/expired\" status can be completed | Платеж нельзя завершить, потому что есть статус не Ожидает оплаты или Просрочен (см. Получение информации о платеже) |