Download the PHP package qiwi/bill-payments-php-sdk without Composer
On this page you can find all versions of the php package qiwi/bill-payments-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download qiwi/bill-payments-php-sdk
More information about qiwi/bill-payments-php-sdk
Files in qiwi/bill-payments-php-sdk
Package bill-payments-php-sdk
Short Description Universal payments API SDK
License MIT
Homepage https://github.com/QIWI-API/bill-payments-php-sdk
Rated 4.64 based on 14 reviews
Informations about the package bill-payments-php-sdk
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
All versions of bill-payments-php-sdk with dependencies
ext-curl Version *
ext-json Version *