Вопросы
bss@qiwi.com
NAV Navbar
shell

API Карты терминалов QIWI

Редактировать на GitHub

API Карты терминалов QIWI позволяет установить местонахождение терминалов QIWI на территории РФ и отобразить их на карте Google Map или Яндекс.Карты.

Map

Поиск терминалов в окрестности заданных координат.

curl -X GET \
  --header 'Accept: application/json;charset=UTF-8' \
  'https://edge.qiwi.com/locator/v3/nearest/clusters?latNW=55.690881&latSE=55.580184&lngNW=37.386282&lngSE=37.826078&zoom=12&withRefillWallet=true&ttpGroups[0]=4&identificationTypes[1]=2&cardAllowed=true&cacheAllowed=true'

Ответ

HTTP/1.1 200 OK
Content-Type: text/json

[
    {
        "terminalId": 1000021154,
        "ttpId": 10004,
        "lastActive": "2018-11-22T14:10:04.608",
        "count": 2,
        "coordinate": {
            "latitude": 55.719384,
            "longitude": 37.781102,
            "precision": 0
        },
        "address": "Москва, Рязанский пр-т., д.2, ТЦ \"Город\", 1 этаж",
        "verified": true,
        "label": "АК БАРС БАНК",
        "description": "ежедневно с 8.30 - 22.00",
        "cashAllowed": false,
        "cardAllowed": true,
        "identificationType": 2
    }
]

Запрос → GET

Параметр Описание Тип
latNW Обязательный параметр. Широта северо-западной точки полигона Double
lngNW Обязательный параметр. Долгота северо-западной точки полигона Double
latSE Обязательный параметр. Широта юго-восточной точки полигона Double
lngSE Обязательный параметр. Долгота юго-восточной точки полигона Double
zoom Масштаб. Для максимального zoom существует ограничение размера (диагонали) полигона в 450 метров. При каждом уменьшении зума на единицу, разрешенная диагональ полигона, увеличивается в два раза.
Подробнее про уровень масштабирования карты		 Integer
activeWithinMinutes Не включать в выборку терминалы, не активные более X минут Long
withRefillWallet Включить в выборку точки партнеров для пополнения кошелька Boolean
ttpIds Фильтр по типу точки партнеров пополнения.
10001 - Евросеть,
10004 - Contact
10002 - Связной
10005 - Киви Банк
10006 - Офисы КИВИ
10007 - Кассы партнеров
10008 - Банки и Банкоматы
10009 - TELE2
Список типов не фиксирован и может меняться. Рекомендуется использовать фильтр по группам (параметр ttpGroups)		 List
cacheAllowed Фильтр по возможности приема наличных Boolean
cardAllowed Фильтр по возможности приема банковских карт Boolean
identificationTypes Фильтр по возможности прохождения идентификации.
0 - нет идентификации
1 - частичная идентификация
2 - полная идентификация		 List
ttpGroups Фильтр по группе терминалов (группа может включать от одного до нескольких типов терминала). Список групп можно получить отдельным запросом List

Ответ ←

[
    {
        "terminalId": 1000021154,
        "ttpId": 10004,
        "lastActive": "2018-11-22T14:10:04.608",
        "count": 2,
        "coordinate": {
            "latitude": 55.719384,
            "longitude": 37.781102,
            "precision": 0
        },
        "address": "Москва, Рязанский пр-т., д.2, ТЦ \"Город\", 1 этаж",
        "verified": true,
        "label": "АК БАРС БАНК",
        "description": "ежедневно с 8.30 - 22.00",
        "cashAllowed": false,
        "cardAllowed": true,
        "identificationType": 2
    }
]
Параметр Описание Тип
address Адрес терминала String
cardAllowed Прием карт Boolean
cashAllowed Прием наличных Boolean
coordinate Объект координат Object
coordinate.latitude Широта Double
coordinate.longitude Долгота Double
coordinate.precision Погрешность, в метрах Double
count Количество терминалов в кластере Integer
description Описание терминала. Может содержать время работы и прочие данные String
label Название терминала String
lastActive Время последней активности Number
terminalId Номер терминала Long
ttpId Тип терминала Long
verified Адрес терминала верифицирован и является актуальным Boolean
identificationType 0 - нет идентификации
1 - частичная идентификация
2 - полная идентификация		 Number

Назад

Выдача списка групп терминалов

Получение справочника типов (групп) терминалов.

curl -X GET \
  --header 'Accept: application/json;charset=UTF-8' \
  'https://edge.qiwi.com/locator/v3/ttp-groups'

Ответ

HTTP/1.1 200 OK
Content-Type: text/json

[
    {
        "title": "Терминалы QIWI",
        "id": 1,
        "maps": [
            "TERMINAL",
            "REPLENISH",
            "IDENTIFICATION"
        ]
    },
    {
        "title": "Терминалы партнеров",
        "id": 2,
        "maps": [
            "TERMINAL",
            "REPLENISH"
        ]
    },
    {
        "title": "Салоны связи",
        "id": 3,
        "maps": [
            "REPLENISH"
        ]
    },
    {
        "title": "Банки и банкоматы",
        "id": 4,
        "maps": [
            "REPLENISH"
        ]
    },
    {
        "title": "Пункты CONTACT",
        "id": 5,
        "maps": [
            "REPLENISH"
        ]
    },
    {
        "title": "Офисы QIWI",
        "id": 6,
        "maps": [
            "IDENTIFICATION"
        ]
    }
]

Запрос → GET

Ответ ←

[
    {
        "title": "Терминалы QIWI",
        "id": 1,
        "maps": [
            "TERMINAL",
            "REPLENISH",
            "IDENTIFICATION"
        ]
    },
    {
        "title": "Терминалы партнеров",
        "id": 2,
        "maps": [
            "TERMINAL",
            "REPLENISH"
        ]
    },
    {
        "title": "Салоны связи",
        "id": 3,
        "maps": [
            "REPLENISH"
        ]
    },
    {
        "title": "Банки и банкоматы",
        "id": 4,
        "maps": [
            "REPLENISH"
        ]
    },
    {
        "title": "Пункты CONTACT",
        "id": 5,
        "maps": [
            "REPLENISH"
        ]
    },
    {
        "title": "Офисы QIWI",
        "id": 6,
        "maps": [
            "IDENTIFICATION"
        ]
    }
]
Параметр Описание Тип
title Название группы терминалов String
id Идентификатор группы Long

Назад

shell