Download the PHP package yourpayments/php-api-client without Composer
On this page you can find all versions of the php package yourpayments/php-api-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download yourpayments/php-api-client
More information about yourpayments/php-api-client
Files in yourpayments/php-api-client
Package php-api-client
Short Description Your Payments - powerful payment gateway PHP integration
License mit
Informations about the package php-api-client
«Твои Платежи»: Интеграция на PHP
Готовая библиотека PHP API Client для YourPayments + подробные примеры с комментариями
Оглавление
- Описание
- Требования
- Установка
- Запуск встроенного сервера
- Запуск в контейнере docker
- Примеры использования
- Начало работы: настройка интеграции
- Приём платежей
- Подписки (рекуррентные платежи)
- Токенизация (запомнить данные плательщика, чтобы не запрашивать и не вводить их повторно)
- Отчёты и статусы платежей
- Возврат средств плательщику (refunds, рефанды)
- Выплаты (отправка денег по номеру карты или телефона)
- Подключение продавцов
- Обработка вебхуков
- Страница после оплаты
- Безопасные поля (отдельный вид интеграции карточной формы)
- Обработка ошибок
- Обновление библиотеки
- Поддержка и контакты
Описание
yourpayments/php-api-client
— это PHP библиотека для быстрой и удобной интеграции с платежным шлюзом YourPayments.
С её помощью можно принимать оплаты и создавать выплаты, получать отчёты, делать возвраты и работать с подпискам.
Библиотека ориентирована на простое и надёжное использование, подходит как для опытных, так и для начинающих разработчиков.
Особенностями этой системы являются:
- мульти-эквайринг (работа сразу со многими банками)
- поддержка сплитования (много получателей платежа в одном чеке)
- безопасность и точность расчётов
Библиотека содержит:
- Сам клиент API
- Простой встроенный сервер с примерами
- Описание контейнера для запуска в Docker
Требования
- PHP 7.4 и выше (рекомендуется PHP 8.1+)
- Расширения PHP:
curl
,json
,mbstring
- Рекомендуется: Composer для управления зависимостями
Установка
Установка с пакета composer -- самый простой и рекомендуемый способ:
Если на вашем проекте нет Composer, склонируйте или скачайте, а затем подключите файлы этого репозитория, (пример)
Запуск встроенного сервера
После запуска по адресу http://localhost:8081 будут доступны интерактивные примеры в следующем виде:
Запуск в контейнере docker
Создайте и запустите docker контейнер следующей командой:
Либо в фоновом режиме командой:
После выполнения сервис с документацией и примерами будет доступен по адресу http://localhost:8080/
Примеры использования:
1. Начало работы: настройка интеграции
2. Приём платежей
- Cамый простой платёж
- Подробный платёж
- Платёж со сплитом (разделением платежа для нескольких получателей)
- Платёж через СБП (Систему Быстрых Платежей)
- Списание средств (только для двустадийной оплаты)
- Встраивание QR-кода без страницы оплаты
3. Подписки
Рекуррентные платежи
- Создание подписки СБП
- Оплата по подписке СБП
- Создание подписки SberPay, T-Pay, Картой не РФ
- Оплата по подписке SberPay, T-Pay, Картой не РФ
4. Токенизация
Запомнить данные клиента, чтобы не запрашивать и не вводить их повторно
- Создание платёжного токена
- Оплата токеном
5. Отчёты
- Проверка статуса платежа
- Запрос детального отчета по заказу
- Запрос быстрого отчёта по заказам для сверки
- Запрос отчёта по заказам
- Запрос отчёта в виде графика
6. Возврат средств плательщику (Refund)
- Возврат средств
- Возврат средств со сплитом (разделением платежа)
7. Выплаты
- Выплаты на банковские карты
- Запрос баланса для выплаты
8. Подключение продавцов
Добавление сабмерчантов маркетплейсов по API
- Подключение продавца-юридического лица (отправка анкеты)
- Подключение продавца-ИП (отправка анкеты)
- Получение статуса анкеты
- Печать анкеты
- Список анкет
9. Обработка вебхуков
Вебхуки -- HTTP запросы, оповещающие ваш сервер о событиях (успешные и неуспешные оплаты, списания)
10. Страница после оплаты
11. Безопасные поля (Secure fields)
- Создание сессии
- Оплата одноразовым токеном
12. Обработка ошибок
Библиотека выбрасывает один вид исключений: Ypmn\PaymentException.
Пример перехвата исключения можно посмотреть в примере: Cамый простой платёж
Обновление
Обновления библиотеки позволяют быстро исправлять ошибки и получать доступ к новым функциям
Ссылки, поддержка и контакты
- НКО «Твои Платежи»
- Докуметация API
- Тестовые банковские карты
- FAQ, ответы на частые вопросы
- Задать вопрос или сообщить о проблеме
🟢 «Твои Платежи» -- финтех для сайтов, платформ и приложений
All versions of php-api-client with dependencies
ext-json Version *
ext-curl Version *
ext-mbstring Version *