Download the PHP package javadle/qiwi without Composer
On this page you can find all versions of the php package javadle/qiwi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package qiwi
Short Description For this package there is no description available.
License
Informations about the package qiwi
Universal payments API PHP SDK
PHP SDK модуль для внедрения единого платежного протокола эквайринга и QIWI Кошелька.
Установка и подключение
Установка с помощью composer:
Документация
Пошаговое руководство по работе с SDK (для физических лиц): https://developer.qiwi.com/ru/p2p-sdk-guide/#integration-sdk
API P2P-счетов (для физических лиц): https://developer.qiwi.com/ru/p2p-payments
API QIWI Кассы (для юридических лиц): https://developer.qiwi.com/ru/bill-payments
Генерация авто-документации composer run docs
.
Авторизация
Для использования SDK требуется SECRET_KEY
, подробности в документации — для физ.лиц, для юр.лиц.
Смена SECRET_KEY
на новый:
Примеры
По умолчанию пользователю доступно несколько способов оплаты. В платежной форме параметры счета передаются в открытом виде в ссылке. Далее клиенту отображается форма с выбором способа оплаты. При использовании этого способа нельзя гарантировать, что все счета выставлены мерчантом, в отличие от выставления по API. Через API все параметры передаются в закрытом виде , так же в API поддерживаются операции выставления и отмены счетов, возврата средств по оплаченным счетам (только для юр. лиц), а также проверки статуса выполнения операций.
Платежная форма
Простой способ для интеграции. При открытии формы клиенту автоматически выставляется счет. Параметры счета передаются в открытом виде в ссылке. Далее клиенту отображается платежная форма с выбором способа оплаты. При использовании этого способа нельзя гарантировать, что все счета выставлены мерчантом, в отличие от выставления по API.
Метод createPaymentForm
создает платежную форму. В параметрах нужно указать: ключ идентификации провайдера publicKey
, полученный в личном кабинете QIWI, идентификатор счета billId
внутри вашей системы и сумму amount
. В результате будет получена ссылка на форму оплаты, которую можно передать клиенту. Подробнее о доступных параметрах в документации — для физ. лиц, для юр. лиц.
Вывод:
Выставление счета
Надежный способ для интеграции. Параметры передаются server2server с использованием авторизации. Метод позволяет выставить счет, при успешном выполнении запроса в ответе вернется параметр payUrl
- ссылка для редиректа пользователя на платежную форму.
Метод createBill
выставляет новый счет. В параметрах нужно указать: идентификатор счета billId
внутри вашей системы и дополнительными параметрами fields
. В результате будет получен ответ с данными о выставленном счете.
Подробное описание параметров для выставления счёта представлено в руководстве по использованию SDK, а так же в документации для физ.лиц и для юр. лиц
Вывод:
Информация о счете
Метод getBillInfo
возвращает информацию о счете. В параметрах нужно указать идентификатор счета billId
внутри вашей системы, в результате будет получен ответ со статусом счета. Подробнее в документации — для физ.лиц, для юр.лиц.
Вывод:
Отмена неоплаченного счета
Метод cancelBill
отменяет неоплаченный счет. В параметрах нужно указать идентификатор счета billId
внутри вашей системы, в результате будет получен ответ с информацией о счете. Подробнее в документации — для физ.лиц, для юр.лиц.
Вывод:
Возврат средств
! Метод недоступен для физических лиц
Методом refund
производит возврат средств. В параметрах нужно указать идентификатор счета billId
, идентификатор возврата refundId
внутри вашей системы, сумму возврата amount
и валюту возврата currency
. Подробнее в документации.
В результате будет выведена информация о возврате и о счете:
Информация о возврате
! Метод недоступен для физических лиц
Метод getRefundInfo
запрашивает статус возврата, в параметрах нужно указать идентификатор счета billId
, идентификатор возврата refundId
внутри вашей системы. Подробнее в документации.
В результате будет выведена информация о возврате:
Вспомогательные методы
-
Метод
generateId
возвращает строку в формате UUID v4, удобно для генерированияbillId
,refundId
: -
Метод
getLifetimeByDay
генерирует дату до которой счет будет доступен для оплаты -lifetime
. Входной параметр - сколько дней счет будет доступен, если не указанно, то по умолчанию 45 дней. Метод возвращает строку в формате ISO 8601 UTC±0:00: -
Метод
checkNotificationSignature
осуществляет проверку подписи при нотификации о новом счете от сервера уведомлений QIWI. Принимает на вход подпись из входящего запроса, объект - тело запроса и secret ключ, с помощью которого должна осуществляться подпись: - Метод
getPayUrl
возвращает URL оплаты по счету:
Тестирование
Текстирования с реальным API требует наличие файла tests/config.php
заполненного по примеру из файла tests/config.sample.php
.
Для этого вам понадобится секретный ключ магазина.
Тестирования без истользования реального API:
Требования
- PHP v5.6.0 или выше
- расширение PHP json
- расширение PHP curl
Лицензия
MIT