Прием входящих переводов, защищенных кодом протекции.
Количество попыток приема входящего перевода ограничено. При исчерпании количества попыток, перевод автоматически отвергается (перевод возвращается отправителю).
Требуемые права токена:
incoming-transfers
| Параметр | Тип | Описание |
|---|---|---|
| operation_id | string | Идентификатор операции, значение параметра operation_id ответа метода operation-history. |
| protection_code | string | Код протекции. Строка из 4-х десятичных цифр. |
Прием входящего перевода, защищенного кодом протекции
POST /api/incoming-transfer-accept HTTP/1.1 Host: yoomoney.ru Authorization: Bearer 410012345678901.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123 Content-Type: application/x-www-form-urlencoded Content-Length: 41 operation_id=1234567&protection_code=0123
Метод возвращает следующие параметры:
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Код результата выполнения операции. Возможные значения:
|
| error | string | Код ошибки при проведении платежа (пояснение к полю status ). Присутствует только при ошибках. |
| protection_code_attempts_available | int | Количество оставшихся попыток принять входящий перевод защищенный кодом протекции. Присутствует только при неверно введенном коде протекции. |
| ext_action_uri | string | Адрес, на который необходимо отправить пользователя для совершения необходимых действий в случае ошибки ext_action_required . |
Пример ответа при успехе
JSON
{ "status":"success" }
В случае ошибки выполнения операции возвращается ее код:
| Код | Описание |
|---|---|
| illegal_param_protection_code | Отсутствует или имеет недопустимое значение параметр protection_code . |
| illegal_param_operation_id | Отсутствует или имеет недопустимое значение параметр operation_id . Перевод с таким operation_id не существует или уже отвергнут. |
| ext_action_required | В настоящее время прием переводов невозможен. Для получения возможности приема переводов пользователю необходимо перейти на страницу по адресу ext_action_uri и следовать инструкции на данной странице. Это могут быть следующие действия:
|
| already_rejected | Перевод уже отвергнут. |
Пример ответа при неверно введенном коде протекции
JSON
{ "status":"refused", "error":"illegal_param_protection_code", "protection_code_attempts_available":2 }