Метод incoming-transfer-accept
Прием входящих переводов, защищенных кодом протекции, и переводов до востребования.
Количество попыток приема входящего перевода с кодом протекции ограничено. При исчерпании количества попыток, перевод автоматически отвергается (перевод возвращается отправителю).
 
Запрос
ПараметрТипОписание
operation_idstringИдентификатор операции, значение параметра
operation_id
ответа метода operation-history.
protection_codestringКод протекции. Строка из 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
 
Ответ
Метод возвращает следующие параметры:
ПараметрТипОписание
statusstring
Код результата выполнения операции. Возможные значения:
  • success
     — входящий перевод принят успешно.
  • refused
     — отказ в выполнении операции.
errorstringКод ошибки при проведении платежа (пояснение к полю
status
). Присутствует только при ошибках.
protection_code_attempts_availableintКоличество оставшихся попыток принять входящий перевод защищенный кодом протекции. Присутствует только при неверно введенном коде протекции.
ext_action_uristringАдрес, на который необходимо отправить пользователя для совершения необходимых действий в случае ошибки
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
}