Как подключить qiwi к сайту

Блог Алeксандра Сергиенко

Как подключить киви к сайту и принимать оплату автоматически?

И снова приветствую читателей моего блога int-net-partner.ru! Каждый владелец сайта, рано или поздно приходит к идее продвижения своих товаров или услуг, а в большинстве случаев, веб-ресурсы для этого и создаются. Когда инфопродукт предлагается клиентам на платном основании, возникает необходимость его онлайн-продажи и соответственно, оплаты в режиме онлайн. Давайте попробуем разобраться, как активировать прием платежей на вашем сайте и как подключить киви кошелек к сайту, ведь он заслуженно занимает ТОПовое место среди способов оплаты, для россиян. Вам это интересно? Тогда вперед!

Размышления о способе установки скрипта

Перед детальным изложением пошаговой инструкции того, как подключить киви, стоит сразу напомнить о двух возможных вариантах активации онлайн-оплаты. Первый способ – платный и упрощенный, второй – бесплатный, но более сложный.

В случае самостоятельного подключения функции, от мастера понадобятся:

Плюсов в платном способе приема платежей – неограниченное множество. Вам даже не нужно являться индивидуальным предпринимателем, чтобы подключить скрипт. Поверьте, я прочитал много статей на тему подобных скриптов, некоторые платные дополнения пробовал устанавливать сам, но сейчас пришло время от них отказаться, так как ни один из них не соответствует моим требованиям, чего не скажешь об ОрдерБро.

Если вы располагаете свободным временем, также можете провести собственный анализ на тему платных скриптов, изучить нюансы каждого. Что немаловажно, хороший скрипт в наши дни должен предлагать максимум способов оплаты. Почему? Чтобы клиент смог выбрать подходящий ему вариант оплаты и сразу же перевести деньги на ваш счет. Ведь далеко не все интернет-пользователи имеют виртуальные кошельки киви, кому-то возможно больше нравится Яндекс-кошелек или оплата через WebMoney.

Само собой разумеющееся

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

Бесплатная возможность приема оплаты

Теперь поговорим о том, как бесплатно подключить qiwi к сайту. Этот вариант сложный, но посильный. Если вы зададитесь целью осуществлять прием онлайн платежей qiwi, то обязательно сможете закрепить на своем ресурсе такую полезную функцию. Итак, что же вам понадобится?

Система повествует о готовности принятия денежных средств следующими способами перевода:

Получается, желающий приобрести что-то на вашем ресурсе, сможет выбрать подходящий ему вариант перевода, даже через социальные сети и qiwi прием платежей на сайте окажется удобным не только для вас, но и для покупателя!

Регистрация на партнерском портале

Чтобы сервис qiwi одобрил прием платежей на вашем сайте, нужно пройти регистрацию на партнерском портале, она не долгая. Обязательно стоит указывать свои реальные данные, ведь вам предстоит иметь дело с деньгами, да и если укажите вымышленные данные, менеджер системы просто откажет вам в сотрудничестве. Если регистрация прошла успешно, то нужно набраться терпения и подождать пока система проверит ваш ресурс. Чтобы его одобрили, обычно достаточно иметь действующий адрес магазина или блога, а также предлагать к покупке товары, которые не запрещены законодательством страны.

Перед настройкой приема оплаты, вам предстоит проделать пару действий:

Настройка подключения

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

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

Что получит ваш магазин?

Тарифы на услуги для плательщиков система предлагает такие:

Тарифы для интернет-магазина следующие:

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

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

Подписывайтесь на новости блога и делитесь в комментариях о своем опыте подключения оплаты.

Также советую прочесть следующие статьи по данной теме:

Источник

Подключение метода оплаты QIWI Касса

Прежде чем начать, обратите внимание на сервис платежных агрегаторов, к примеру, Робокасса или Единая касса.

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

Тем не менее если по каким-то причинам агрегаторы не подошли, дорогой процент или нужен всего один способ оплаты, то не беда, можно подключить метод «напрямую».

Для подключения платежного метода «QIWI Касса» напрямую необходимо

Рисунок 1.

Для входа авторизуйтесь логином и паролем, которые получили при регистрации (рис. 2).

Рисунок 2.

Открывается личный кабинет (рис. 3).

Рисунок 3.

3. Далее необходимо перейти в административную панель магазина и заняться добавлением самого метода оплаты.

В панели администрирования магазина перейдите на страницу “Настройки”-«Оплата” (рис. 4).

Рисунок 4.

Добавьте новый метод оплаты «QIWI Касса» (рис. 5): 1) нажимаете “Добавить способ оплаты”; 2) указываете название, например, QIWI; 3) выбираете модуль «QIWI касса»; 4) при необходимости указываете описание; 5) нажимаете “Добавить”.

Рисунок 5.

В настройках метода оплаты, помимо базовых настроек (название, активности и т.д.), необходимо указать настройки метода (рис. 6).

Рисунок 6.

1) Секретный ключ из пары ключей авторизации (Блок «Аутентификационные данные»)

Далее идут 3 ссылки, нам нужно запомнить «URL обработки оповещений об оплате (Notification URL)», он понадобиться на следующем шаге.

Далее, нажимайте «Сохранить». Метод добавлен.

5) Нам нужно попросить у QIWI Касса секретный ключ и сообщить в QIWI Касса наш Notification URL.

Далее, на странице выбираем пункт «Услуги», открывается страница с платежами (рис.7)

Рисунок 7.

Переходим в пункт меню «Настройки». В графе «Аутентификационные данные». Для этого нажмите на кнопку «Создать новый Public key» (рис.8). Откроется окно, вписываете название для ключа авторизации (рис.9), сфомируется пара публичный/секретный ключ, скопируйте секретный ключ и пропишите в настройках магазина (рис.10)

Рисунок 8.

Рисунок 9.

Рисунок 10.

В графе «Серверные уведомления» в поле «URL для оповещения» нужно указать наш Notification URL из настроек метода оплаты QIWI Касса в интернет-магазине. (рис. 11).

Рисунок 11.

Далее возвращаемся к настройке метода оплаты.

Полученные настройки нужно вбить в метод оплаты в магазине и не забудьте активировать сам метод оплаты (напротив «Активен» поставить галочку).

После этого подключение метода оплаты завершено.

Совершите тестовый заказ в своем магазине, выбрав метод оплаты QIWI Касса.

Если возникнут трудности, обратитесь в техническую поддержку AdvantShop.

Источник

Процесс интеграции через SDK

Ознакомьтесь с нашей документацией.

Шаг 1. Подготовка среды разработки

Выберите SDK для вашего языка программирования и перейдите в репозиторий на GitHub:

Обратите внимание, что в зависимости от выбранного вами SDK потребуется установка Composer, Apache Maven или NuGet.

Шаг 2. Создание секретного ключа

Перейдите на вкладку API.

Нажмите на кнопку Настроить и придумайте название, по которому потом сможете найти нужный API-ключ.

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

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

Нажмите Создать и получите ключи авторизации.

Скопируйте себе секретный ключ (в оранжевом блоке), нажав на ссылку Скопировать в буфер. Рекомендуем не закрывать данное окно и не нажимать на кнопку Дальше, пока не настроите авторизацию.

Шаг 3. Авторизация

В разрабатываемом коде заведите константу SECRET_KEY и присвойте ей значение секретного ключа, вставив его из буфера обмена комбинацией клавиш Ctrl+V.

Раздел документации с примерами авторизации находится здесь.

Шаг 4. Выставление счета

Рекомендуем использовать дополнительные параметры:

Необязательные параметры для выставления счета:

В ответе на запрос выставления счета возвращаются следующие поля:

Для тестирования и отладки сервиса рекомендуем выставлять и оплачивать счета суммой 1 рубль.

Раздел документации с примерами выставления счетов находится здесь.

Шаг 5. Установка дополнительных параметров к ссылке на счёт

При выставлении счета через API в ответе присутствует поле payUrl, содержащее ссылку на форму. К данной ссылке можно добавить следующие параметры:

Шаг 6. Редирект пользователя на платежную форму

Пример получения URL оплаты по счету

Реализуйте на вашем сайте перенаправление пользователя на платежную форму по ссылке, полученной в поле payUrl ответа на запрос выставления счёта или по ссылке с дополнительными параметрами, сформированной на шаге 5.

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

Пример передачи реферальной ссылки

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

Формат уведомлений описан в документации.

Данные приходят в теле запроса (body). Данные запроса хранятся в формате JSON.

Так как для отладки уведомлений тестовый контур не предусмотрен, рекомендуем выставлять счета на 1 рубль и оплачивать их самостоятельно.

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

Условия интеграции с API уведомлений

Если же вы пока не можете определиться, тогда ознакомьтесь с условиями обслуживания интеграции с API уведомлений:

Мы устанавливаем на своей стороне таймаут на установление соединения – 2 секунды, и таймаут на получение ответа – также 2 секунды. Поэтому не рекомендуем внедрять долго выполняющуюся логику или логику, связанную с ожиданием (waiter, sleep), в процесс обработки уведомления.

Рекомендуем на стороне вашего сервера организовывать очередь и складывать в нее входящие запросы от QIWI с изменением статусов счетов, после чего отвечать QIWI на уведомление успешным статусом.

Обработку уведомлений в очереди и свою бизнес-логику стоит проводить в потоках, отдельных от приема уведомлений, чтобы успевать отвечать нам вовремя.

Мы не можем гарантировать exactly once доставку уведомления, т.е. вам может прийти более одного уведомления об одной и той же успешной оплате счёта.

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

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

Шаг 8*. Настройка серверных уведомлений

Уведомление представляет собой входящий POST-запрос.

Тело запроса содержит JSON-сериализованные данные счета (кодировка UTF-8).

Проверьте, что IP-адреса, с которых QIWI отправляет уведомления, находятся в списке разрешенных:

Если не приходят уведомления по счету:

Попробуйте отправить себе уведомление, заменив в примере https://test.com/notif.php на URL, который вы указали при создании ключей для получения уведомлений.

Если вы не используете облачные сервисы для приема уведомлений вроде amazon или heroku, а настраивали свой вебсервер и ssl в нем самостоятельно, проверьте ssl сертификат.

Если ssl сертификат для установления соединения по https выпущен не общеизвестным доверенным центром сертификации (например, Comodo, Verisign, Thawte и т.п.), проверьте, что ваш сервер при установке соединения отправляет полную цепочку сертификатов, включая доверенный корневой центр сертификации в начале цепочки.

Полную цепочку сертификатов вы можете загрузить на сайте центра сертификации, выпустившего ваш сертификат.

Шаг 9*. Проверка подписи уведомлений

Настоятельно рекомендуем проверять уведомления на подлинность, т.к. мы не несем ответственность, если будут приходить поддельные уведомления от мошенников.

Формат уведомлений описан в документации.

Данные приходят в теле запроса (body). Данные запроса хранятся в формате JSON.

Алгоритм проверки подписи:

Объединить значения следующих параметров уведомления в одну строку с разделителем | :

где <*>– значение параметра. Все значения при проверке подписи должны трактоваться как строки.

Вычислить HMAC-хэш c алгоритмом хэширования SHA256:

hash = HMAС(SHA256, invoice_parameters, secret_key)

где: secret_key – секретный ключ, при помощи которого был выставлен счёт; invoice_parameters – строка из п.1.

Сравнить значение заголовка X-Api-Signature-SHA256 с результатом из п.2.

В разрабатываемом коде заведите константу merchantSecret и присвойте ей значение секретного ключа, который выпустили в личном кабинете. Значение должно быть то же самое, что в константе SECRET_KEY на шаге авторизации.

После проверки уведомлений на подлинность отправьте QIWI ответ на уведомление успешным статусом.

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

Шаг 11*. Проверка статуса перевода по счету

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

Также данный метод можно использовать как самостоятельный, т.е. после выставления счета раз в какой-то промежуток времени опрашивать статус этого счета. Этот метод проще интеграции с сервисом уведомлений.

Раздел документации с примерами проверки статуса оплаты счета находится здесь.

Шаг 12. Бизнес-логика

Счет в своем жизненном цикле проходит следующие статусы оплаты:

Опираясь на статус счета, полученный в уведомлении или при помощи поллинга статуса, доработайте бизнес-логику вашего сайта.

Поздравляем, интеграция с QIWI для получения платежей закончена!

Дополнительно. Шаг 13. Отмена неоплаченных счетов

Вы можете отменять неоплаченные счета самостоятельно, используя метод cancelBill.

Раздел документации с примерами запросов для отмены неоплаченных счетов находится здесь.

Источник

Условия использования

Последнее обновление: 09-09-2021

Для подключения на свой сайт сервиса приема переводов для физических лиц p2p необходимо иметь QIWI Кошелек со статусом идентификации «Основной» или «Профессиональный». Если Ваш кошелек имеет статус «Анонимный» – пройдите идентификацию удобным для вас способом. Для получения «Основного» статуса достаточно указать паспортные данные, для получения «Профессионального» статуса необходимо пройти очную идентификацию.

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

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

Активация p2p

Поздравляем! Вы можете приступить к интеграции.

Для работы API потребуются публичный и секретный ключи. Ключи создаются в разделе «API».

Схема работы с API

Пользователь формирует счет на вашей стороне.

Вы перенаправляете пользователя на платежную форму для выставления счета. Или выставляете счет по API и перенаправляете пользователя на созданную платежную форму.

Пользователь выбирает способ перевода и подтверждает перевод. По умолчанию подбирается оптимальный для пользователя способ перевода.

После перевода по счету вы получаете уведомление (предварительно настройте отправку уведомлений в Личном кабинете при создании ключей). Уведомления о переводе по счету содержат параметры авторизации, которые необходимо проверять на Вашем сервере.

Готовые решения

SDK и библиотеки

С руководством по работе с SDK можно ознакомиться здесь.

Решения для CMS

Авторизация

Ваши запросы авторизуются посредством секретного ключа API ( SECRET_KEY ). Параметр авторизации указывается в заголовке Authorization, значение которого формируется как «Bearer SECRET_KEY».

Публичный ключ ( PUBLIC_KEY ) используется для выставления счетов через форму.

Ключи создаются в личном кабинете на вкладке API после авторизации на p2p.qiwi.com.

Для выпуска пары ключей выполните следующие шаги:

Внизу страницы нажмите на кнопку Настроить.

Придумайте название паре ключей, чтобы упростить поиск в списке.

Подключите уведомления об оплате счетов, отметив Использовать эту пару ключей для серверных уведомлений об изменении статусов счетов.

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

Скопируйте в буфер секретный ключ и сохраните его в безопасном месте — в дальнейшем он не будет отображаться в интерфейсе. Используйте секретный ключ для запросов к API.

Выставление счета через форму

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

REDIRECT →

URL https://oplata.qiwi.com/create

Параметры

Взаимодействие через API

1. Выставление счета

Доступно выставление счетов в рублях и тенге.

Надежный способ для интеграции. Параметры передаются server2server с использованием авторизации.

Также существует более простой способ выставления счета — непосредственно через вызов платежной формы

Запрос → PUT

URL https://api.qiwi.com/partner/bill/v1/bills/

HEADERS

Ответ ←

Пример тела ответа при ошибке

HEADERS

2. Проверка статуса перевода по счету

Метод позволяет проверить статус перевода по счету. Рекомендуется его использовать после получения уведомления о переводе.

Запрос → GET

URL https://api.qiwi.com/partner/bill/v1/bills/

HEADERS

Ответ ←

Пример тела ответа при ошибке

HEADERS

3. Отмена неоплаченного счета

Метод позволяет отменить счет, по которому не был выполнен перевод.

Запрос → POST

URL https://api.qiwi.com/partner/bill/v1/bills//reject

HEADERS

Ответ ←

Пример тела ответа при ошибке

HEADERS

Статусы оплаты счетов

Уведомления о переводе по счету

Адрес сервера для уведомлений указывается в личном кабинете p2p.qiwi.com при генерации ключей.

Перед началом работы с сервисом уведомлений прочитайте условия по интеграции API уведомлений.

Пулы IP-адресов, с которых сервисы QIWI отправляют уведомления:

Если ваш сервер обработки уведомлений работает за брандмауэром, необходимо добавить эти IP-адреса в список разрешенных адресов входящих TCP-пакетов.

Запрос ← POST

Уведомление представляет собой входящий POST-запрос.

Тело запроса содержит JSON-сериализованные данные счета (кодировка UTF-8).

HEADERS

Авторизация уведомлений

Алгоритм проверки подписи:

Объединить значения следующих параметров уведомления в одну строку с разделителем | :

где <*>– значение параметра. Все значения при проверке подписи должны трактоваться как строки.

Вычислить HMAC-хэш c алгоритмом хэширования SHA256:

hash = HMAС(SHA256, invoice_parameters, secret_key) Где:

Сравнить значение заголовка X-Api-Signature-SHA256 с результатом из п.2.

Строка и ключ подписи кодируются в UTF-8.

Данные

В уведомлении содержится информация о счете.

Ответ →

HEADERS

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

Настройки формы и счета

При выставлении счета через API в ответе присутствует поле payUrl со ссылкой на форму. К ссылке можно добавить следующие параметры:

Добавьте реферальные ссылки для платежей с сайта. Полная ссылка подтвердит реальность сайта и позволит избежать проблем с блокировкой кошелька. Платежи, проходящие со страницы без заголовка запроса Refer будут приводить к блокировке кошелька. Подробнее читайте в статье Как передавать реферальные ссылки.

Пример передачи реферальной ссылки

Персонализация

Вы можете настроить персонализированную форму оплаты – изменить свое имя на название магазина и настроить цвет фона и кнопок.

Перейдите в личном кабинете в раздел Форма приема переводов, нажмите на кнопку Настроить, произведите настройку и нажмите на кнопку Сохранить.

Пример передачи параметра при вызове платежной формы

Пример передачи параметра в запросе к API

Обратите внимание, что значение themeCode индивидуально для разных кошельков.

Для применения стиля к платежной форме:

Checkout Popup

Пример работы popup

Всплывающее окно (popup) позволяет открыть форму перевода поверх вашего сайта.

В библиотеке доступно два метода: открытие существующего счета и открытие вашей формы приема переводов.

Установка и подключение:

Открытие существующего счета

Пример открытия уже созданного счета в popup

Открытие персонализированной формы

Пример открытия персонализированной формы

Источник