Coinpayments
Как подключить
Чтобы подключить платежную систему Coinpayments, понадобятся 4 значения: seller ID, IPN secret (для вебхуков), private api key и public api key, а также нужно указать webhook url.
Перейдите в аккаунт Coinpayments -> Settings
https://ww.coinpayments.net/index.php?cmd=acct_settings
На первой вкладке скопируйте seller ID (seller ID)
Затем перейдите на вкладку Settings продавца и придумайте и введите секретный ключ IPN — IPN secret (он используется для подтверждения того, что вебхук приходит от нас; используйте надежную сложную строку, которую будет трудно угадать.)
Link IPN — адрес url для вебхуков, добавьте следующее: https://chatter.salebot.pro/coinpayments_callback/result
Затем перейдите в API Keys раздел и сгенерируйте пару ключей для доступа к api.
Сохранить все настройки, скопируйте данные и перейдите в настройки в Salebot. Откройте раздел платежных систем, выберите Coinpayments.
Нам нужно ввести данные.
Чтобы сгенерировать ссылку на оплату, нужно задать значение необходимых переменных: original_currency — Исходная валюта транзакции. sending_currency — Валюта, отправляемая покупателем. Например, если ваши товары указаны в USD, но вы получаете BTC, следует использовать original_currency = USD и sending_currency = BTC. original_currency и sending_currency могут иметь одинаковое значение, если конвертация валюты не требуется.
buyer_email — это email-адрес покупателя. Для отправки уведомлений, если платежа недостаточно и нужно доплатить, или для возвратов. Если эта переменная не указана, почта будет взята автоматически из переменной email, если у пользователя она есть в salebot.
После этого нужно задать значение payment_sum переменной (например, 10 или 0.0055 (через точку!)), сразу после этого появится paycoinments_pay_url переменная. Ее можно вывести ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка такая: https://www.coinpayments.net/index.php?cmd=checkout&id=CPFK5QZ3FKSNWHI75CO8M4BRVkey&e7782d2ce24f7d03815606a5c4a882eb
Также перед установкой значения payment_sum можно указать следующие необязательные переменные для настройки платежа.
payment_description — название товара, будет на странице с информацией об оплате и в IPN для транзакции.
buyer_name - имя покупателя
Как создать ссылку на оплату
Создать ссылку на оплату 0.44444
Обратите внимание:
Сначала укажите email
Далее необязательные параметры first_name, payment_description, и т. д.
И в последнюю очередь задайте значение payment_sum variable
Обратите внимание, сначала мы задаём переменные для настроек, затем payment_sum. Вы можете определять переменные раньше в цепочке, а не в одном блоке, это пример.
Далее в нужном месте выведите переменную coinpayments_pay_url которая содержит ссылку
Чтобы совершить повторный платеж, нужно сбросить payment_sum, ранее сгенерированную ссылку, а после сброса переменной payment_sum получить новую ссылку
Как обработать результат
После успешной оплаты в бота придут колбеки, по которым можно понять, что оплата прошла успешно. Эти колбеки в системе вы видите как сообщения от пользователя, поэтому, чтобы они не могли быть отправлены пользователем, они состоят из первых 10 символов секретного ключа и пометки _success, например: 16831CF4b5_success
Эти колбеки пользователь НЕ ВИДИТ, они отображаются только оператору.
Тип сравнения должен быть "Full match"
Также после успешной оплаты переменная coinpayments_payment_completed устанавливается в true
Например, можно сделать блок обработки успешной оплаты с условием и вывести пользователю соответствующее сообщение:
По завершении оплаты, coinpayments_payment_callback переменная будет добавлена клиенту и будет содержать данные ответа платёжной системы по завершённой транзакции. Необходимые данные можно извлечь из словаря с помощью get .
Как проверить статус платежа
Чтобы проверить статус оплаты, нужно вызвать coinpayments_get_payment_status() в поле Calculator
Пример:
Примеры статусов:
Ожидание средств от покупателя...
Средства получены и подтверждены, вскоре отправим вам…
Завершено
Последнее обновление