Paypal
Налаштування приймання чат-оплат Paypal
Як налаштувати PayPal
Щоб працювати з PayPal, потрібно отримати два ключі: client_id і secret
Перейдіть на сторінку https://developer.paypal.com/developer/applications/
І виберіть зі списку або створіть новий застосунок:
Угорі переведіть перемикач у режим Live і виберіть потрібний застосунок. Відкриється сторінка з налаштуваннями, де ви знайдете потрібні дані:
Скопіюйте дані та вставте їх у відповідні поля в налаштуваннях Salebot - Платіжні системи - Paypal:
На цьому підключення завершено.
Як створити платіжне посилання
Щоб згенерувати платіжне посилання, потрібно встановити значення змінної payment_sum, і змінна paypal_pay_url з’явиться одразу.
payment_title — не обов’язкова змінна, це назва товару. Якщо ви її не вкажете, буде заповнено текстом: "Payment account order_id" (order_id — ідентифікатор замовлення на сервері)
payment_description - опис товару, необов’язково
Крім того, перед тим як вказати payment_sum, можна задати, якою мовою буде сторінка оплати. Для цього потрібно встановити змінну locale, за замовчуванням — російська (ru-RU). Усі можливі варіанти: da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, zh-TW.
І третій додатковий параметр — company_name, назва вашої компанії, що відображається у самому верху сторінки (приклад нижче, company).
Також можна вказати валюту, у якій приймається платіж, для цього задаємо змінну currency, за замовчуванням встановлено рубль (RUB), для долара задаємо його значення USD (currency = USD). Можливі варіанти валют можна знайти за посиланням https://developer.paypal.com/docs/api/reference/currency-codes/
І третій додатковий параметр — company_name, назва вашої компанії, що відображається у самому верху сторінки (приклад нижче, company )
Змінну paypal_pay_url можна вивести як посилання або розмістити на кнопці "Pay".
Посилання має такий вигляд: https://ww.paypal.com/checkoutnow?token=07N53571YM296381N
Приклад реалізації.
Встановіть суму платежу 444 та назву компанії
Примітка: змінна payment_sum встановлюється останньою, після необов’язкової payment_title, company_name, тощо.
Як обробити результат
Після успішної оплати в бот надійдуть колбеки, за якими можна зрозуміти, що оплата пройшла успішно. Ці колбеки в системі ви бачите як повідомлення від користувача, тому щоб їх не міг надіслати користувач, вони складаються з перших 10 секретних символів і домашньої сторінки зі статусом, наприклад: EHsWHYOoWV_success.
Також після успішної оплати змінна paypal_payment_completed встановлюється в True.
Ці колбеки НЕ ВИДНО користувачу, вони відображаються лише оператору.
Тип порівняння має бути "Full match"
Щоб здійснити повторну оплату, потрібно скинути payment_sum, раніше згенероване посилання, а після скидання змінної payment_sum отримати нове посилання. Ви можете вказати попереднє значення.
Колбеки надходять із затримкою, тому після посилання на оплату користувачеві ми рекомендуємо надсилати повідомлення на кшталт: "Після оплати зачекайте повідомлення про успішне завершення оплати"
Наприклад, ви можете зробити блок успішної обробки платежу з умовою та вивести відповідне повідомлення користувачу:
Тип порівняння має бути "Full match"
Після завершення оплати, paypal_callback_data змінна буде додана до клієнта, що містить дані відповіді платіжної системи для завершеної транзакції. Ви можете витягнути необхідні дані зі словника за допомогою get методу.
Last updated