Download the PHP package omnipay/ym without Composer
On this page you can find all versions of the php package omnipay/ym. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package ym
Short Description Yandex.Money gateway for Omnipay payment processing library
License MIT
Informations about the package ym
Omnipay: Yandex.Money
Библиотека для приема платежей с помощью пластиковых карт на сайте.
Как это работает?
Для того, чтобы совершать запросы к API, необходимо зарегистрировать приложение. Средства будут зачисляться прямиком на указанный кошелек.
- Пользователь нажимает кнопку "оплатить", с помощью API формируется запрос на оплату;
- Пользователь перенаправляется на сайт Яндекс.Деньги для ввода данных карты;
- Если необходимо, данные дополнительно проверяются банком;
- Если платеж прошел успешно, пользователь возвращается на
returnUrl
, где проверяется статус платежа; - Можно сохранить токен карты для платежей без ввода данных;
- Если платеж не прошел, пользователь перенаправляется на
cancelUrl
, где также необходимо проверять статус платежа.
Больше информации можно найти на официальном сайте Яндекс.Деньги.
Установка
Использование
Для начала необходимо создать гейт, через который уже будут выполняться запросы API:
Для любого запроса необходим параметр instanceId
. Данный параметр генерируется для каждого приложения отдельно
на основе client_id
, который был получен при регистрации приложения. Чтобы сгенерировать новый instanceId
:
Формирование счета
Теперь необходимо перенаправить пользователя на страницу ввода данных, для этого нужно запросить статус платежа:
Проверка статуса платежа
После того, как пользователь успешно совершил платеж, либо отменил операцию (банк отклонил платеж), он будет
перенаправлен либо на returnUrl
при успешности, либо на cancelUrl
при ошибке. Если нет какой-то особой
дополнительной логики, то можно просто выводить сообщение об успешности/ошибочности платежа. Иначе необходимо
обязательно проверять статус платежа.
Обратите внимание, что для получение статуса платежа, необходим номер транзакции, который был получен при
формировании платежа. Он передается при перенаправлении пользователя под именем cps_context_id
. Но лучше его сохранять
на сервере и восстанавливать когда пользователь возвращается на сайт.
Сохранение карты
Если пользователь успешно совершил платеж, то есть возможность сохранить введенные им данные и использовать уже их при других платежах.
Проведение платежа с помощью сохраненной карты
Сам платеж проходит по той же схеме, что и раньше, то есть сначала формируется платеж, но при первом запросе статуса
передается токен карты, а также защитный код cvv
с обратной стороны карты (который должен вводить пользователь):