Поиск реквизитов организаций
Метод предназначен для поиска форм оплаты в ЮMoney по реквизитам организации.
Запрос
Формат запроса
GET /api/showcase-search?query=<запрос>&records=<количество> HTTP/1.1
Host: yoomoney.ru
Accept-Language: <lang>
Параметры URL запроса:
ПараметрТипОписание
querystringПоисковый запрос, слово или фраза.
recordsintМаксимальное количество записей в выдаче метода.
Запрос может содержать следующие HTTP-заголовки:
ЗаголовокОписание
Accept-Language
Код языка, на котором клиент хочет получить описание формы в соответствии с RFC-5646: Tags for Identifying Languages, IANA Language Subtag Registry.
Возможные значения:
  • ru — русский;
  • en — английский.
По умолчанию: ru
Пример запроса реквизитов по строке «Петроэлектросбыт»
GET /api/showcase-search?query=Петроэлектросбыт&records=3 HTTP/1.1
Host: yoomoney.ru
Accept: */*
Ответ
ПараметрТипОписание
errorstringКод ошибки. Передается при ошибке выполнения запроса.
resultarrayСписок результатов запроса.
nextPagebooleanПредикат, определяющий существование записей свыше запрашиваемого лимита.
Элемент result содержит:
ПараметрТипОписание
idintИдентификатор формы оплаты (pattern_id).
titlestringНаименование получателя.
urlstringАдрес отправки данных формы оплаты.
paramsobjectНабор предзаполненных полей первого шага форма оплаты.
formatstring
Формат формы оплаты. Возможные значения: json
Может отсутствовать. Запросить описание формы можно только тогда, когда format равен json.
Пример ответа
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 454

{
    "result":
    [
        {
            "id":5670,"title":"Петроэлектросбыт"
        },
        {
            "id":5551,
            "title":"ЗАО ПЕТРОЭЛЕКТРОСБЫТ",
            "url":"https://yoomoney.ru/api/showcase/validate/5551/step_INN_3038",
            "params": {
                    "supplierInn":""
            },
            "format":"json"
        },
        {
            "id":5551,
            "title":"ЗАО Петроэлектросбыт",
            "url":"https://yoomoney.ru/api/showcase/validate/5551/step_INN_3038",
            "params":{
                "supplierInn":"7812013775"
                },
                "format":"json"
        }
    ],
    "nextPage":"false"
}
Коды ошибок
В случае ошибки выполнения операции возвращается ее код:
КодОписание
illegal_param_query
Недопустимое значение параметра query:
  • параметр отсутствует;
  • содержит пустую строку;
  • содержит недопустимое значение.
illegal_param_records
Недопустимое значение параметра records:
  • параметр отсутствует;
  • содержит не число;
  • содержит недопустимое значение (например -1).