Что такое айпи кошелек

Инструкция по работе с API QIWI Мастер

Чтобы автоматически управлять картами в составе пакета QIWI Мастер вы можете воспользоваться специальным API. С помощью API вы сможете:

• Подключать пакет QIWI Мастер
• Мгновенно выпускать и блокировать виртуальные карты
• Получать выписки по картам и реквизиты
• Переименовывать карты

Для настройки API и работы с ним вам потребуются базовые знания знание программирования на языках PHP или Python. Далее мы пошагово расскажем как отправлять запросы и обрабатывать ответы от сервиса QIWI.

Попробуйте интерфейс для управления вирутальными картами QIWI Мастер по API.

Установка и настройка сервера

Пропустите этот шаг если вы знаете, как запустить сервер на локальном компьютере или на хостинге. Перейти к работе с API.

Для отправки запросов через API и обработки ответов вам нужно настроить сервер. Разберем, как установить сервер Apache на домашнем компьютере или арендовать сервер в интернете. В примерах мы будем использовать язык программирования PHP.

Сервер на домашнем компьютере

1. Установите специальную программу XAMPP для Windows или Mac.
2. После установки откройте контрольную панель XAMPP (появится ярлык на рабочем столе) и запустите сервер Apache.
3. 
4. Далее в папке C:\xampp\htdocs создайте папку своего проекта, например master-api.
5. 
6. В корне папки cоздайте файл index.php со следующим содержимым: и сохраните его.
7. 
8. В любом браузере откройте адрес http://localhost/master-api . Если вы все сделали правильно в браузере появится текст: заработало
9. 

В этой папке будут лежать исполняемые файлы вашей программы.

Аренда сервера у хостинг-компании

Этот способ быстрее, но нужен свободный домен, с которого будут отправляться запросы. Некоторые хостинг-провайдеры предоставляют домен в подарок при покупке хостинга. Желательно использовать ssl сертификат и отправлять запросы по https-протоколу. SSL сертификат нужен, чтобы ваш трафик не смогли расшифровать и подменить данные при отправке.

Для работы с API достаточно оплатить любой виртуальный хостинг с поддержкой скриптов на PHP и интерфейсом на cPanel (например тариф Host-A от Reg.ru). Виртуальные сервера VDS\VPS тоже подойдут, но больше времени уйдет на настройку.

После покупки хостинга заходите в административную панель cPanel (доступы ваш пришлют на почту после покупки).
Если вы купили хостинг с доменом — ничего настраивать не нужно. Переходите в менеджер файлов.

• В корневой папке домена создайте файл index.php со следующим содержимым:
• В браузере откройте адрес https://вашдомен.ru/. Если все прошло успешно, вы увидите текст: заработало

Подготовка к работе с API

Сервер настроен, но перед отправкой запросов в API нужно получить специальный токен — это ваш ключ доступа к кошельку удаленно. Получить этот ключ можно в разделе https://qiwi.com/api .

При создании токена отметьте следующие разрешения:

• Управление виртуальными картами
• Запрос информации о профиле кошелька
• Просмотр истории платежей
• Проведение платежей без SMS.

Отправка запросов и обработка ответа

Любой запрос содержит заголовки и тело запроса. В заголовках передаётся тип запроса и авторизационный токен, а в теле — данные для отправки на сервер. Подробнее о структуре запросов вы можете почитать в официальной справке по API: https://developer.qiwi.com/ru/qiwi-wallet-personal/#qiwi-master

Покупка пакет QIWI мастер

В теле запроса нужно передать объект Payment и дополнительные обязательные поля:
fields.account — номер вашего кошелька
fields.vas_alias — “qvc-master”

Пример запроса на PHP, который выведет статус покупки пакета. Скопируйте этот код в файл masterbuy.php и перейдите в браузере на cтраницу http://localhost/master-api/masterbuy.php , если вы работаете на локальном сервере или http://вашсайт.ru/masterbuy.php, если у вас виртуальный хостинг.

Код запроса для покупки пакета QIWI Мастер. Напишите свой номер кошелька в переменную $qiwiNumber и скопируйте токен в переменную $qiwiToken:

После исполнения скрипта в браузере появится статус транзакции.

Покупка карты

Шаг 1. Создание заказа

Доступные для заказа типы карт:

• Для оплаты рекламы в Яндекс.Директ и myTarget: «qvc-cpa»
• Для оплаты рекламы в Facebook, Google и Tiktok: «qvc-cpa-debit»

Скопируйте этот код в файл cardsbuy.php и перейдите в браузере на cтраницу http://localhost/master-api/cardsbuy.php.

Шаг 2. Подтверждение заказ карты

Далее запрос на подтверждение заказа карты.

Добавьте следующий код в файл cardbuy.php для подтверждения заказа карты:

Шаг 3. Покупка карты

Отправим запрос для покупки карты.

Добавьте следующий код в файл cardbuy.php для подтверждения заказа карты:

Сообщение «Accepted!» означает, что карта выпущена успешно. Любое другое сообщение значит ошибку.

Список карт с реквизитами

Чтобы получить список карт нужно отправить GET запрос без параметров.
Для получения реквизитов карт нужен отдельный PUT запрос с параметрами id карты из списка и operationId — любой уникальный идентификатор транзакции, например время.

Скопируйте этот код в файл cardsreq.php и перейдите в браузере на cтраницу http://localhost/master-api/cardsreq.php:

В результате выполнения кода вы получите список выпущенных вирутальных карт в составе пакета QIWI Мастер.

Источник

Открываем API для приема p2p-переводов

Мы тут в QIWI открыли API приема переводов. Новый сервис должен решить сразу несколько проблем для тех, кто часто посылает (а особенно — получает) деньги именно посредством p2p-перевода. Во-первых, мы открыли возможности, ранее доступные только для бизнеса, и постарались сделать процесс безопасным, быстрым и удобным, а во-вторых, хотим снять риски вида «Мне тут за работу заплатили и банк счет поблочил».

Почему p2p-переводы важны

Люди часто кидают друг другу деньги с помощью переводов с карты на карту или по номеру телефона — суть одна, это прямой платеж от одного физлица другому. Это может быть возврат денег, если вы купили другу кофе, когда у него с собой не было денег (или желания платить за кофе), это может быть открытый сбор средств на что-нибудь, это может быть какой-то киоск с мороженым или тем же кофе в парке, где продавец принимает только наличку, но есть возможность и «кинуть на сбер».

Отдельной строкой тут проходят и самозанятые граждане. Допустим, человек получает постоянный доход за какой-то фриланс (или сдает квартиру, например) и хочет легализовать свои доходы. Делать ИП не каждому хочется, поэтому государство позаботилось о самозанятых. Судя по всему, в формате открытой беты, потому что инициатива сама по себе, как и налоговые ставки, разумная, но практика показывает, что некоторые из первых ласточек столкнулись с произвольными блокировками основных банковских счетов. Банку иногда сложно провести водораздел между приемом средств таким самозанятым гражданином в рамках его профессиональной деятельности и обычными денежными переводами. Поэтому банк на всякий случай сначала все блочит, а потом уже разбирается, чего там и как.

Обсуждать это дело мы не будем, мы решили просто придумать альтернативу.

Получается, что де-факто у людей есть сам запрос на прием платежей подобными способами. А у государства есть запрос на легализацию всего этого дела, чтобы такие люди могли работать в белую и платить налоги. Вот именно в этих двух историях мы и захотели поучаствовать.

В том году мы создали универсальный протокол для приема средств, который успешно объединил в себе все доступные способы оплаты — эквайринг-кошелек, банковские карты, мобильную коммерцию, рассрочку по Совести, я писал о нем вот тут. Конечно, для него сделали SDK и поддержку в разных CMS. Поэтому в решении для примера p2p переводов решили использовать именно его. Такой подход позволит клиенту без технологических изменений идти от редких переводов и самозанятости к своей фирме.

Начали с пользовательских тестов, чтобы понять, как люди воспринимают форму. Главное здесь — чтобы они понимали, что с помощью формы совершается перевод денежных средств, а не покупка какой-то услуги. Потому что человек может использовать для этого кредитную карту. И если покупка онлайн с кредитной карты рассматривается банком именно как покупка и не облагается комиссией, то при переводе с кредитки на другую карту комиссия обычно есть. И у некоторых банков достигает такого значения, что при возврате другу денег за кофе банку ты даришь две таких порции кофе. Что всегда грустно, а иногда еще и внезапно.

Поэтому мы сразу заменили кнопку «Оплатить» на однозначную «Перевести», чтобы отсеять сомнения и дать пользователю понять, что с нашей стороны тут все прозрачно и без комиссий, но возможна комиссия со стороны банка, который выпустил саму карту.

Посмотрели глубже, как пользователи взаимодействуют с формой. Поняли, что человеку все же важно при переводе видеть в форме, кому именно он переводит деньги (люди привыкли переводить по номеру телефону или ФИО из контактов в смартфоне). Но показывать фамилию целиком на публичной форме — так себе затея, поэтому мы показываем имя и первую букву фамилии.

Кстати, о безопасности. Почему лучше не показывать прямой телефон на формах и виджетах для сбора средств и почему мы его скрываем? Во-первых, через сам номер телефона могут попытаться взломать кошелек, попытаться в салоне восстановить симку и прочее, то есть тут есть фактор целевой атаки на абонента и на кошелек. Нет номера — нет фактора. А во-вторых, это помогает еще и от разного рода оленей, которые собирают по сети актуальные номера мобильных телефонов для обзвона и предложения разных услуг и прочей чуши.

А теперь получается, что перевод осуществляется либо по короткой ссылке, либо с виджета на сайта, либо с QR-кода.

Мы сразу заложили для p2p скрытие номера телефона. Люди могли ранее собирать средства разными способами — номер карты, номер QIWI Кошелька и прочее, и мы объединили их все.

На чем все крутится

Нам удалось успешно адаптировать платежный протокол, сделанный для бизнеса, к решению для переводов, сохранив все возможности и совместимость с библиотеками. Теперь любой человек с идентифицированным кошельком может залогиниться и получить доступ ко всему этому добру. Сейчас физ. лицам не доступны только возвраты, но они в планах и не так востребованы.

Все это можно посмотреть в работе на p2p.qiwi.com

При входе с помощью кошелька вам станет доступна персональная короткая ссылка. Например, my.qiwi.com/gkonnov. Её удобно как пересылать в сообщении, так и, например, сделать QR код. Форма хорошо адаптируется к мобильным устройствам, поэтому конверсия будет хорошей. Еще появятся персональные виджеты на выбор (widget.qiwi.com/gkonnov). Их сделали для сайтов и блогов. На виджетах и форме можно кастомизировать по желанию, чтобы они соответствовали оформлению вашего сайта или бренда. Это все было в возможностях для большого бизнеса и крупных магазинов — мы перенесли все и на пользователей.

А еще появилась возможность выставлять счет за оказанные услуги. Сделали вы кому-то сайт и хотите принять средства за работу — вбиваете нужную сумму, формируете ссылку на счет, пересылаете ее заказчику. Заказчик переходит по ней и понимает, кому переводит и за что.

Т.к. под капотом полноценное API — есть возможность создавать ключи, настраивать необходимые уведомления, подключать это к своему интернет-магазину на WordPress и других CMS, все работает.

Так, а что у вас про самозанятых?

Сейчас у самозанятых такая ситуация, что регистрироваться надо на одном сервисе, потом принимать деньги на карту, которую банк вполне может поблочить (потому что ты принимаешь туда деньги от множества разных людей, да, так редко бывает у обычных клиентов), а чеки выдаешь вообще в третьем приложении. И такой зоопарк при ведении бизнеса, пусть даже малого и очень малого, все же нервирует.

Да, в целом, ничего не мешает использовать p2p.qiwi.com уже сейчас и, если вы самозанятый, регистрировать доход в сервисе “Мой налог”, но прямо сейчас мы активно взаимодействуем с ФНС и интегрируем их API, что позволит и регистрировать самозанятых, и вести учет их деятельности. В общем, человек получит коробочное решение, которое должно будет закрыть все его потребности как самозанятого.

Заодно, зная сферу деятельности клиента, мы сможем расширить лимиты, снизить риск блокировок и предложить удобные сервисы, которые сделают легальную работу не столько обязанностью, сколько выгодной возможностью.

Здесь мы предлагаем командам, желающим написать какой-нибудь свой полезный сервис для самозанятых, поработать вместе с нами, запустить пилот и получить до 3 млн рублей, в зависимости от результата. Подробности, требования к командам и условия оценок тут. Уже работающих компаний это тоже касается. Мы открыты к сотрудничеству по адаптации сервисов для самозанятых, эти проекты тоже можно подавать на QIWI Universe.

Что это может быть — можно придумать сервис, который поможет собирать средства уличным фотографам, музыкантам, создателям полезных вебинаров, людям, сдающим квартиры, в общем, сценариев может быть множество.

Главный фокус — самозанятые. Именно им мы должны помогать, запуская продукт. Я искренне верю, что это крутая возможность помочь людям, компаниям и государству на новом, огромном рынке. Остались вопросы? Записывайся на вебинар 24 апреля или спрашивай в комментариях.

Если вам не очень близка тема самозанятых, посмотрите любой из 8 проектов на QIWI Universe 2019. Они разные.

Да, кстати, 18 апреля, мы проводим еще и митап для разработчиков, приходите, будем рады.

Источник