Метод operation-details

Позволяет получить детальную информацию об операции из истории.

Требуемые права токена: operation-details.

Запрос

Параметры

Параметр	Тип	Описание
operation_id	string	Идентификатор операции. Значение параметра следует указывать как значение параметра `operation_id` ответа метода operation-history или значение поля `payment_id` ответа метода process-payment, если запрашивается история счета плательщика.

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

POST /api/operation-details HTTP/1.1
Host: yoomoney.ru
Authorization: Bearer 410012345678901.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123
Content-Type: application/x-www-form-urlencoded
Content-Length: 20

operation_id=1234567

Ответ

Метод возвращает следующие параметры:

Параметр	Тип	Описание
error	string	Код ошибки, присутствует при ошибке выполнения запроса.
operation_id	string	Идентификатор операции. Значение параметра соответствует либо значению параметра `operation_id` ответа метода operation-history либо, в случае если запрашивается история счета плательщика, значению поля `payment_id` ответа метода process-payment.
status	string	Статус платежа (перевода). Значение параметра соответствует значению поля `status` ответа метода operation-history.
pattern_id	string	Идентификатор шаблона платежа, по которому совершен платеж. Присутствует только для платежей.
direction	string	Направление движения средств. Может принимать значения: `in` (приход); `out` (расход).
amount	amount	Сумма операции (сумма списания со счета).
amount_due	amount	Сумма к получению. Присутствует для исходящих переводов другим пользователям.
fee	amount	Сумма комиссии. Присутствует для исходящих переводов другим пользователям.
datetime	datetime	Дата и время совершения операции.
title	string	Краткое описание операции (название магазина или источник пополнения).
sender	string	Номер счета отправителя перевода. Присутствует для входящих переводов от других пользователей.
recipient	string	Идентификатор получателя перевода. Присутствует для исходящих переводов другим пользователям.
recipient_type	string	Тип идентификатора получателя перевода. Возможные значения: `account` — номер счета получателя в сервисе ЮMoney; `phone` — номер привязанного мобильного телефона получателя; `email` — электронная почта получателя перевода. Присутствует для исходящих переводов другим пользователям.
message	string	Сообщение получателю перевода. Присутствует для переводов другим пользователям.
comment	string	Комментарий к переводу или пополнению. Присутствует в истории отправителя перевода или получателя пополнения.
label	string	Метка платежа. Присутствует для входящих и исходящих переводов другим пользователям ЮMoney, у которых был указан параметр `label` вызова request-payment.
details	string	Детальное описание платежа. Строка произвольного формата, может содержать любые символы и переводы строк. Необязательный параметр.
type	string	Тип операции. Описание возможных типов операций см. в описании метода operation-history
digital_goods	object	Данные о цифровом товаре (пин-коды и бонусы игр, iTunes, Xbox, etc.) Поле присутствует при успешном платеже в магазины цифровых товаров. Описание формата

Пример ответа при платеже в магазин

JSON
{
  "operation_id": "1234567",
  "status": "success",
  "pattern_id": "2904",
  "amount": 500.00,
  "direction": "out",
  "datetime": "2011-07-11T20:43:00.000+04:00",
  "title": "Оплата ADSL-доступа компании Мой-Провайдер",
  "details": "Предоплата услуг ADSL-доступа в интернет компании ООО \"XXX\"\nНомер лицевого счета абонента: \n1234567/89\nЗачисленная сумма: 500.00\nНомер транзакции: 2000002967767",
  "type": "payment-shop"
}

Пример ответа для исходящего перевода другому пользователю

JSON
{
  "operation_id": "1234567",
  "status": "success",
  "pattern_id": "p2p",
  "direction": "out",
  "amount": 50.25,
  "datetime": "2011-07-11T20:43:00.000+04:00",
  "title": "Перевод на счет 4100123456789",
  "recipient": "4100123456789",
  "recipient_type": "account",
  "message": "Купите бублики",
  "comment": "Перевод от пользователя ЮMoney",
  "codepro": false,
  "details": "Счет получателя:\n4100123456789\nСумма к получению: 50,00 руб.",
  "type": "payment-shop"
}

Коды ошибок

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

Код	Описание
illegal_param_operation_id	Неверное значение параметра `operation_id`
Все прочие значения	Техническая ошибка, повторите вызов метода позднее.

Пример ответа при запросе несуществующей операции

JSON
{
 "error": "illegal_param_operation_id"
}