Метод operation-details

Описание

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

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

Входные параметры

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

Возвращает

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

Параметр Тип Описание
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

Тип идентификатора получателя перевода. Присутствует для исходяших переводов другим пользователям.

message string Сообщение получателю перевода. Присутствует для переводов другим пользователям.
comment string Комментарий к переводу или пополнению. Присутствует в истории отправителя перевода или получателя пополнения.
codepro boolean Перевод защищен кодом протекции. Присутствует для переводов другим пользователям.
protection_code string Код протекции. Присутствует для исходящих переводов, защищённых кодом протекции.
expires datetime Дата и время истечения срока действия кода протекции. Присутствует для входящих и исходящих переводов (от/другим) пользователям, защищённых кодом протекции.
answer_datetime datetime Дата и время приёма или отмены перевода, защищённого кодом протекции. Присутствует для входящих и исходящих переводов, защищённых кодом протекции. Если перевод еще не принят/не отвергнут получателем - поле отсутствует.
label string Метка платежа. Присутствует для входящих и исходящих переводов другим пользователям Яндекс.Денег, у которых был указан параметр label вызова request-payment.
details string Детальное описание платежа. Строка произвольного формата, может содержать любые символы и переводы строк. Необязательный параметр.
type string Тип операции. Описание возможных типов операций см. в описании метода operation-history
digital_goods object Данные о цифровом товаре (пин-коды и бонусы игр, iTunes, Xbox, etc.) Поле присутствует при успешном платеже в магазины цифровых товаров. Описание формата можно найти здесь.

Для исходящих переводов другим пользователям присутствует тип идентификатора получателя перевода:

Код Описание
account Номер счета получателя в сервисе Яндекс.Деньги
phone Номер привязанного мобильного телефона получателя
email Email получателя перевода

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

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

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

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

operation_id=1234567

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

{
  "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"
}

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

{
  "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": "Перевод от пользователя Яндекс.Денег",
  "codepro": false,
  "details": "Счет получателя:\n4100123456789\nСумма к получению: 50,00 руб.",
  "type": "payment-shop"
}

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

{
 "error": "illegal_param_operation_id"
}