Payments — модуль платежей на CMF Cotonti

Payments — модуль для «Сборка «Фриланс-биржа» — реализация платёжного функционала для сайта биржи услуг и фриланса на CMF Cotonti.

Платежный модуль и валюта сайта — наличие установленного и настроенного модуля Payments необходимо для приема платежей через плагины оплаты на сайте, в числе которых, — Яндекс.Деньги — Яндекс.Касса — PayPal — Free-kassa — Payeer — LiqPay (ПриватБанк) — Интеркасса — WebMoney — Robokassa и другие

Для того чтобы на сайте организовать платные услуги и внутренние счета пользователей вам понадобится платежный модуль Payments. В состав этого модуля входит система внутренних счетов пользователей и собственное API для организации операций со счетами, пополнение, переводы между пользователями или оплата каких-либо определенных услуг, например для приема оплаты за какие-либо платные услуги.

Валюта сайта и другие опции настроек модуля заполняются по своему усмотрению в Панели Управления (в Админке)

Для пополнения счета необходимо также установить так называемые платежные плагины — это плагины для подключения платежных систем, с помощью которых осуществляется прием оплаты от пользователей. В составе Payments уже имеется три платежных плагина для интеграции Webmoney, Robokassa и Интеркасса. Кроме того в каталоге приложений можно также приобрести дополнительные плагины для подключения таких платежных систем как: PayPal, LiqPay, QIWI, Yandex.

Особенностью платежного модуля является то, что при определенных навыках в веб-программировании можно создавать всевозможные платные сервисы. Платные услуги при этом создаются в виде отдельных плагинов, которые в своем коде используют API основного модуля Payments.

Что касается валюты сайта, то здесь все просто. По-умолчанию единица валюты называется «руб.». Но если вам необходимо использовать другое название валюты, то в настройках модуля можно изменить это название на свое.

Последние обновления в платежных плагинах позволяют настроить каждый платежный плагин под свою валюту и соотнести ее с внутренней валютой сайта. Для этого в настройках плагина появился еще один параметр «Соотношение суммы к валюте сайта», который позволяет установить соотношение суммы оплаты в платежном плагине к общей валюте сайта.

Например, на вашем сайте валюта называется «монета», и допустим 1 монета = 1 рублю. Тогда если ваши платежные плагины настроены на рубли, то соотношение должно быть равно 1. То есть в данном случает валюта сайта эквивалентна валюте платежных плагинов.

Другой случай: Ваш платежный плагин настроен на прием в USD, тогда в настройках этого плагина нужно указать соотношение 0.0333, чтобы при оплаче через этот плагин сумма к оплате конвертировалась с учетом этого коэффициента. Допустим сумма к оплате 100 монет, тогда плагин сообщит платежной системе сумму к оплате в USD = 100*0.0333 = 3.33 USD.

Платежный модуль Payments позволяет развернуть на сайте фриланс биржи под управлением COTONTI полноценную систему онлайн оплаты за товары или услуги, с внутренними балансными счетами пользователей и системой пополнения счетов через платежные системы, например:
— QIWI
— Яндекс.Деньги
— Яндекс.Касса
— PayPal
— Free-kassa
— Payeer
— LiqPay (ПриватБанк)
— Интеркасса
— WebMoney
— Robokassa
Платежные системы подключаются к модулю через специальные платежные плагины, что позволяет расширять список платежных систем путем установки соответствующих плагинов.

Функционал платёжного модуля Payments позволяет выводить со счета средства по заявке от пользователя, а также переводы между пользователями.
Можно также установить размер комиссии за вывод со счета и за перевод другому пользователю. Причем также можно указать каким образом взимается комиссия при переводе другому пользователю (с отправителя или с получателя).

В состав модуля уже входят плагины для подключения платежных систем: Webmoney, Robokassa, Interkassa.

Чтобы в шапке сайта разместить ссылку на счет пользователя нужно добавить следующий код в header.tpl:

<!— IF {PHP.cfg.payments.balance_enabled} —>
<a href=»{HEADER_USER_BALANCE_URL}»>{PHP.L.payments_mybalance}: {HEADER_USER_BALANCE|number_format($this, ‘2’, ‘.’, ‘ ‘)} {PHP.cfg.payments.valuta}</a>
<!— ENDIF —>

1.1. Создание услуги и переход к ее оплате осуществляется с помощью функции

cot_payments_create_order($area = ‘balance’, $summ, $options)

где:

area — идентификатор услуги (уникальный код вашей услуги, например: ‘balance’ — встроенная услуга пополнения счета);
summ — стоимость услуги к оплате;
options — массив дополнительных опций услуги, которые фиксируются в базе данный (в информации о счете на оплату).
Это может быть дополнительный идентификатор услуги ($options[‘code’] = 21232;),
название услуги ($options[‘desc’] = ‘Оплата услуги Х’;)
или срок действия услуги ($options[‘time’] = 8600;).

Кастомные опции необходимо создавать дополнительно в виде дополнительных полей в таблице cot_payments.

Также в последнем обновлении была добавлена возможность указывать ссылку для редиректа при успешной оплате:

$options[‘redirect’] = $cfg[‘mainurl’].’/’.cot_url(‘payments’, ‘m=balance’, », true);

cot_payments_create_order($area = ‘balance’, $summ, $options);

1.2. Чтобы узнать баланс счета пользователя можно воспользоваться функцией

cot_payments_getuserbalance($userid)

где:

userid — id-пользователя.

Другие возможности API вы можете посмотреть в файле modules/payments/inc/payments.functions.php.

Функциональная схема работы модуля:

Функциональная схема

Можете использовать данный модуль для разработки собственных приложений. Документация по внутреннему API данного модуля и принципы разработки плагинов (для подключения платежных систем и создания платных услуг) на данный момент находятся в разработке.

---

Задать вопрос и получить консультацию

Получить помощь по модулю «Payments» для сборки сайта фриланс-биржи и услуг можно задав свой вопрос в форме комментариев ниже.
Ваш вопрос будет изучен и ответ на него будет подготовлен по мере наличия свободного времени.
Если помощь нужна в максимально сжатые сроки, — на этот случай есть услуга: Персональная консультация и поддержка.

Благодарность и поддержка сайта по сборке «Фриланс-Биржа»

Если Вам, материалы проекта Freelance PHP Script принесли хоть какую-то помощь или пользу, и при повторном посещении нашего сайта, Вы желаете, чтобы сайт был доступен, просим понимать, что сейчас сайт держится на голом энтузиазме, а вечным он не бывает. Без Вашей посильной финансовой поддержки, небольшого доната, — техническое содержание, обслуживание, развитие и размещение новых бесплатных материалов просто станет не целесообразным.
На позитив, чашку кофе и на желание развивать проект, можно удобным способом в любой валюте закинуть на странице Сказать спасибо. Поддержать сайт.