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

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

Последнее обновление: 2018-12-07 | Редактировать на GitHub

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

Map

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

user@server:~$ 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.longtitude Долгота Double
coordinate.precision Погрешность, в метрах Double
count Количество терминалов в кластере Integer
description Описание терминала. Может содержать время работы и прочие данные String
label Название терминала String
lastActive Время последней активности Number
terminalId Номер терминала Long
ttpId Тип терминала Long
verified Адрес терминала верифицирован и является актуальным Boolean
identificationType 0 - нет идентификации
1 - частичная идентификация
2 - полная идентификация
Number

Назад

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

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

user@server:~$ 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

Назад