Download the PHP package payselection/payselection-php-client without Composer
On this page you can find all versions of the php package payselection/payselection-php-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download payselection/payselection-php-client
More information about payselection/payselection-php-client
Files in payselection/payselection-php-client
Package payselection-php-client
Short Description Payselection api client
License MIT
Informations about the package payselection-php-client
Payselection api Library
Оглавление
- Установка
- Начало работы
- Методы API
- Create Webpay
- Get Order Status
- Get Order Status (extended)
- Get transaction Status
- Get transaction Status (extended)
- Get transaction Status (by-dates)
- Paylink Create
- Paylink Void
- Create Payment
- Create Block
- Rebill Payment
- Confirm Payment
- Create Refund
- Cancel Payment
- Charge Payment
- Cancel Subscription
- Create Payout
- Get Balance
- Register Recurring
- Search Recurring
- Change Recurring
- Cancel Recurring
- Работа с webhooks
- Webhook для проверки платежа
Установка
Установить библиотеку можно с помощью composer:
Начало работы
- Создайте экземпляр объекта клиента.
Значение webhook_url
должно совпадать со значением WebhookUrl
из запросов.
Опциональное значение public_key
может использоваться в методах Paylink и Webpay.
При заполнении public_key
необходимо обязательное заполнение site_url
(его значение уточните у своего менеджера).
- Вызовите нужный метод API.
Методы API
Create Webpay
Создайте платёж, чтобы Покупатель смог оплатить его
Paylink Create
Метод позволяет создать ссылку для перехода на платежный виджет.
Paylink Void
Метод позволяет отменить ссылку на платежный виджет.
Get Order Status
Получить статус ордера по OrderId.
Get Order Status (extended)
Расширенный запрос используется для получения информации о текущем статусе по идентификатору заказа orderId.
Get transaction Status
Статус транзакции в документации
Получить статус по TransactionId.
Get transaction Status (extended)
Статус транзакции в документации
Расширенный запрос используется для получения информации о текущем статусе по идентификатору транзакции TransactionId.
Get transaction Status (by-dates)
Статус транзакции в документации
Расширенный запрос используется для получения статуса транзакций по выбранному диапазону дат.
Create Payment
Одностадийная операция оплаты – денежные средства списываются сразу после ее проведения.
Create Block
Operation Block в документации
Двухстадийная операция оплаты – денежные средства блокируются на карте. Если авторизация прошла успешно, необходимо завершить транзакцию в течение 5 дней, если же вы не подтвердите транзакцию запросом на списание в течение 5 дней, снятие денежных средств будет автоматически отменено. Кроме того, есть возможность задать rebillFlag для включения рекуррентных платежей.
Rebill Payment
Operation Rebill в документации
Операция автоматического списания средств по привязанной ранее карте.
Confirm Payment
Operation Confirm в документации
Используется для операций Pay или Block с 3DS после получения результатов аутентификации от банка для завершения одностадийной/двухстадийной операции оплаты.
Create Refund
Operation Refund в документации
Только успешная транзакция может быть возвращена
Cancel Payment
Operation Cancel в документации
Отмена блокировки средств на карте в рамках ранее проведенной двухстадийной операции оплаты.
Charge Payment
Operation Charge в документации
Списание средств с карты в рамках проведенной ранее двухстадийной операции оплаты.
Cancel Subscription
Operation Unsubscribe в документации
Отмена рекуррентных платежей.При использовании данного метода произойдет отписка по всем зарегистрированным регулярным оплатам в рамках переданного RebillId
Create Payout
Operation Payout в документации
Одностадийная операция оплаты – денежные средства списываются сразу после ее проведения.
Get Balance
Operation Balance в документации
Операция проверки доступного баланса для Payout.
Register Recurring
Operation Recurring в документации
Регистрация регулярной оплаты по привязанной ранее карте.
Cancel Recurring
Operation Recurring Unsubscribe в документации
Отмена регулярной оплаты.
Search Recurring
Operation Recurring Search в документации
Поиск регулярной оплаты (подписки) по выбранному параметру.
Change Recurring
Operation Recurring Change в документации
Изменение параметров регулярной оплаты (подписки).
Работа с webhooks
Webhook в документации Webhook для подписок в документации
Работа с webhooks проверки платежа
Webhook для проверки платежа в документации
После ввода клиентом карточных данных вы можете получить webhook с данными из запроса для сопоставления их с данными заказа. Вебхук проверки платежа отличается от обычного вебхука, в котором ТСП получает результаты платежа, после его проведения. Вебхук проверки платежа активируется только технической поддержкой. Чтобы включить, настроить и выключить вебхук проверки платежа необходимо написать на почту [email protected].
В письме сообщите:
- URL-адрес возврата, куда будет передаваться вебхук. Также вы можете заранее самостоятельно настроить статичный URL возврата в личном кабинете, в разделе "Сайты". Укажите его для тех.поддержки.
- Параметры из запроса, которые вам необходимо проверить (это всё, что входит в payment request в методе create)
Возможные варианты параметров для проверки:
- сумма
- номер заказа
- валюта платежа
Проверочный вебхук отправляется с webpay после ввода карточных данных или выбора клиентом иного способа оплаты. Вебхук проверки платежа приходит в формате json и содержит только те параметры для проверки, которые вы указали в письме
Пример содержимого полученного вебхука: {"OrderId": "1299670125", "Amount": "4.50", "Description": "Description", "RebillFlag": false}
После подключения вебхука проверки платежа, когда вы направите запрос с необходимыми параметрами и URL возврата, Ваш сервис приема должен отдавать:
- 200 статус, если оплату можно продолжать
- 4хх и 5хх статусы в различных вариациях для прерывания оплаты.
License
MIT
All versions of payselection-php-client with dependencies
guzzlehttp/guzzle Version >=7.5.1
myclabs/php-enum Version >=1.6
ext-json Version *