Paynow
Польская платёжная система
Как подключить Paynow
Введите свой аккаунт paynow. Перейдите в настройки, нажав на шестерёнку.
Далее переходим в Sklepy i punkty płatności
Ниже в настройках строки магазина Adres powiadomień — указываем URL-адрес для получения callback-уведомления об оплате:
https://chatter.salebot.pro/paynow_callback/result
Ниже нужно скопировать ключ API (Klucz dostępu do API) и секретный ключ (Klucz obliczania podpisu)
Перейдите в свой проект на salebot.pro и в разделе Платёжные системы — Paynow запишите найденные ключи.
Как сформировать ссылку для оплаты
Необходимые настройки
Перед указанием переменной с суммой оплаты у клиента должна быть переменная email с его адресом электронной почты
Ниже приведён пример того, как можно запросить и сохранить адрес электронной почты.
email - email покупателя (если не указан, подставляется fake)
payment_description - описание платежа отображается в веб-интерфейсе (Внимание! Кириллица будет автоматически заменена латинским алфавитом, не более 255 символов). Если не указано, заполнить автоматически: Оплата счёта № «здесь номер»
Чтобы сгенерировать ссылку на оплату, нужно установить значение payment_sum переменной (например, 150 или 100.55 (через точку!)), сразу после этого paynow_pay_url переменная появится. Эту переменную можно вывести ссылкой или разместить на кнопке с текстом «Оплатить».
Ссылка имеет вид: https://paywall.paynow.pl/NOH0-0LT-SEY-XOI?token=eyJraWQiOiJhMDAyNjJjYS02NTU3LTRjOTktOGU0NC1kMTFlMTAxYjhhNTIiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJOT0gwLTBMVC1TRVktWE9JIiwiYXVkIjoicGF5d2FsbC5zYW5kYm94LnBheW5vdy5wbCIsImlzcyI6InNhbmRib3gucGF5bm93LnBsIiwiZXhwIjoxNjE5NTkyOTc4LCJpYXQiOjE2MTk1MDY1Nzh9.dnCfjADHiTynvXk41TVxsQEVfDAnHFDC_9sdzWF4G2s
Дополнительные параметры
Также перед установкой payment_sum значения можно указать следующие необязательные переменные для настройки платежа.
имя - имя покупателя
фамилию - имя покупателя
language - язык страницы оплаты в формате BCP47/RFC5646 (например, pl-PL, en-US)currency - код валюты платежа ISO 4217. Если не указано, используется значение по умолчанию (PLN).
Обратите внимание:
Сначала укажите email
Далее необязательные параметры first_name, payment_description, и т. д.
И в последнюю очередь задайте значение payment_sum variable
Пример ссылки на оплату
Сначала мы запросим и сохраним email клиента. Мы создадим блок с запросом на ввод email и сохраним введённое значение в стрелку:
В следующем блоке сообщение отображаться не будет, мы укажем описание платежа и сразу после него установим переменную с суммой платежа 10 zl (злотый по умолчанию)
Далее в нужном месте выведите переменную paynow_pay_url, которая содержит ссылку. В примере это следующий блок.
Как обработать результат
После успешной оплаты в бот придут колбэки, по которым можно понять, что платёж прошёл успешно.
Эти callback-уведомления в системе вы видите как сообщения от пользователя, поэтому он не может отправить их вручную; они состоят из первых 10 символов секретного ключа и слова success, например: omc79l97u4_success
Эти callbacks пользователь НЕ ВИДИТ, они отображаются только оператору.
Тип сравнения должен быть "Full match"
Также после успешной оплаты устанавливается переменная paynow_payment_completed со значением True.
Например, можно сделать блок обработки успешной оплаты с условием и вывести пользователю соответствующее сообщение:
После завершения оплаты клиенту будет добавлена переменная paynow_callback_data, содержащая данные ответа платёжной системы по завершённой транзакции. Вы можете извлечь необходимые данные из словаря с помощью метода get.
Чтобы выполнить повторную оплату, нужно сбросить payment_sum, ранее сгенерированную ссылку, а после сброса переменной payment_sum получить новую ссылку. Можно указать предыдущее значение.
Уведомление об оплате сравнивает значение переменной paynow_payment_id с идентификатором платежа из уведомления; если они не совпадают, это означает, что платёж был совершён по старой ссылке. В вашей переписке с пользователем вы увидите об этом уведомление.
Мы настоятельно рекомендуем не создавать повторную ссылку на оплату, если предыдущая не была завершена или отменена!
Последнее обновление