Paypal
Настройка приёма платежей в чате Paypal
Как настроить PayPal
Чтобы работать с PayPal, нужно получить два ключа: client_id и secret
Перейдите на страницу https://developer.paypal.com/developer/applications/
И выберите из списка или создайте новое приложение:
Вверху переключите тумблер в режим Live mode и выберите нужное вам приложение. Откроется страница с настройками, где вы сможете найти нужные данные:
Скопируйте данные и вставьте их в соответствующие поля в настройках 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 .
Последнее обновление