Paynow
Польська платіжна система
Як підключити Paynow
Увійдіть до свого облікового запису paynow. Перейдіть до налаштувань, натиснувши на шестерню.
Далі переходимо до Sklepy i punkty płatności
Нижче в налаштуваннях магазину в рядку Adres powiadomień - вказуємо URL-адресу для отримання callback платежу:
https://chatter.salebot.pro/paynow_callback/result
Нижче потрібно скопіювати api key (Klucz dostępu do API) та secret key (Klucz obliczania podpisu)
Перейдіть до свого проєкту на salebot.pro і в розділі Платіжні системи - Paynow запишіть знайдені ключі.
Як створити посилання для оплати
Обов’язкові налаштування
Перш ніж вказувати змінну із сумою платежу, у клієнта має бути змінна email з його адресою електронної пошти
Нижче наведено приклад того, як можна запросити та зберегти вашу адресу електронної пошти.
email - email покупця (якщо не вказано, підставляється фейковий)
payment_description - опис платежу відображається у веб-інтерфейсі (Увага! Кирилиця буде автоматично замінена латинським алфавітом, не більше 255 символів). Якщо не вказано, заповнюється автоматично: Оплата рахунку № "тут номер"
Щоб згенерувати посилання для оплати, потрібно встановити значення payment_sum змінної (наприклад, 150 або 100.55 (через крапку!)), одразу після цього paynow_pay_url з’явиться змінна. Цю змінну можна відображати як посилання або розмістити на кнопці з текстом "Pay".
Посилання має такий вигляд: 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, яка містить посилання. У прикладі це наступний блок.
Як обробити результат
Після успішної оплати в бот прийдуть колбеки, за якими можна зрозуміти, що платіж успішно здійснено.
Ці колбеки в системі ви бачите як повідомлення від користувача, тому їх не може надіслати сам користувач; вони складаються з перших 10 символів секретного ключа та account success, наприклад: omc79l97u4_success
Користувач ЦИХ callbacks НЕ БАЧИТЬ, вони відображаються лише оператору.
Тип порівняння має бути "Full match"
Також після успішної оплати змінна paynow_payment_completed буде встановлена в True.
Наприклад, ви можете зробити блок успішної обробки платежу з умовою та вивести відповідне повідомлення користувачу:
Після завершення оплати клієнту буде додано змінну paynow_callback_data, яка містить дані відповіді платіжної системи для завершеної транзакції. Ви можете витягнути потрібні дані зі словника за допомогою методу get.
Щоб здійснити повторну оплату, потрібно скинути payment_sum, раніше згенероване посилання, а після скидання змінної payment_sum отримати нове посилання. Ви можете вказати попереднє значення.
Сповіщення про платіж порівнює значення змінної paynow_payment_id з ідентифікатором платежу зі сповіщення; якщо вони не збігаються, це означає, що платіж було здійснено за старим посиланням. У вашому листуванні з користувачем ви побачите про це сповіщення.
Ми наполегливо рекомендуємо не перевипускати посилання для оплати, якщо попереднє не було завершено або скасовано!
Last updated