Позволяет получить детальную информацию об операции из истории.
Требуемые права токена:
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 | Направление движения средств. Может принимать значения:
|
amount | amount | Сумма операции (сумма списания со счета). |
amount_due | amount | Сумма к получению. Присутствует для исходящих переводов другим пользователям. |
fee | amount | Сумма комиссии. Присутствует для исходящих переводов другим пользователям. |
datetime | datetime | Дата и время совершения операции. |
title | string | Краткое описание операции (название магазина или источник пополнения). |
sender | string | Номер счета отправителя перевода. Присутствует для входящих переводов от других пользователей. |
recipient | string | Идентификатор получателя перевода. Присутствует для исходящих переводов другим пользователям. |
recipient_type | string | Тип идентификатора получателя перевода. Возможные значения:
Присутствует для исходящих переводов другим пользователям. |
message | string | Сообщение получателю перевода. Присутствует для переводов другим пользователям. |
comment | string | Комментарий к переводу или пополнению. Присутствует в истории отправителя перевода или получателя пополнения. |
label | string | Метка платежа. Присутствует для входящих и исходящих переводов другим пользователям ЮMoney, у которых был указан параметр label вызова request-payment. |
details | string | Детальное описание платежа. Строка произвольного формата, может содержать любые символы и переводы строк. Необязательный параметр. |
type | string | Тип операции. Описание возможных типов операций см. в описании метода operation-history |
digital_goods | object | Данные о цифровом товаре (пин-коды и бонусы игр, iTunes, Xbox, etc.) Поле присутствует при успешном платеже в магазины цифровых товаров. Описание формата |
Пример ответа при платеже в магазин
{ "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": "Перевод от пользователя ЮMoney", "codepro": false, "details": "Счет получателя:\n4100123456789\nСумма к получению: 50,00 руб.", "type": "payment-shop" }
В случае ошибки выполнения операции возвращается ее код:
Код | Описание |
---|---|
illegal_param_operation_id | Неверное значение параметра operation_id |
Все прочие значения | Техническая ошибка, повторите вызов метода позднее. |
Пример ответа при запросе несуществующей операции
{ "error": "illegal_param_operation_id" }