Як підключити

Для підключення платіжної системи Coinpayments вам знадобляться чотири значення: ідентифікатор продавця, секрет IPN (для вебхуків), приватний ключ API та публічний ключ API. Також потрібно встановити URL вебхука.

Перейдіть до особистого кабінету Coinpayments -> Налаштування облікового запису https://www.coinpayments.net/index.php?cmd=acct_settings

На першій вкладці скопіюйте ідентифікатор продавця. (seller ID)

Далі перейдіть на вкладку "Seller Settings" та створіть і введіть секретний ключ IPN - IPN secret (він використовується для перевірки того, що вебхук надходить від нас). Використовуйте надійний, складний рядок, який важко вгадати.

IPN link - це URL для вебхуків, додайте наступне: https://chatter.salebot.pro/coinpayments\\_callback/result

Далі перейдіть до розділу API Keys та згенеруйте пару ключів для доступу до API.

Збережіть усі налаштування, скопіюйте дані та перейдіть до налаштувань у Mavibot. Відкрийте розділ "Acquiring", виберіть Coinpayments.

Вам потрібно ввести отримані дані.

Щоб сформувати посилання на оплату, потрібно встановити значення необхідних змінних:

Після цього потрібно встановити значення змінної payment_sum (наприклад, 10 або 0.0055 (через крапку!)), і одразу після цього з'явиться змінна coinpayments_pay_url. Цю змінну можна відобразити з посиланням або розмістити на кнопці з текстом "Pay". Посилання виглядає так: https://www.coinpayments.net/index.php?cmd=checkout\\&id=CPFK5QZ3FKSNWHI75CO8M4BRVD\\&key=e7782d2ce24f7d03815606a5c4a882eb

Також перед встановленням значення змінної payment_sum можна встановити наступні додаткові змінні для налаштування платежу.

payment_description - назва товару буде на сторінці інформації про платіж та в IPN для транзакції.

buyer_name - ім'я клієнта

Ось як виглядає сторінка оплати.

Як сформувати посилання на оплату

Створіть посилання на оплату на суму 0.0256

Зверніть увагу:
- Спочатку вкажіть адресу електронної пошти
-Далі додаткові параметри first_name, payment_description тощо.
- Нарешті, призначте значення змінній payment_sum.

Зверніть увагу, що ми спочатку встановлюємо змінні для налаштувань, потім payment_sum. Змінні можна встановлювати раніше в ланцюжку, а не в одному блоці, це лише приклад.

Далі виводимо змінну coinpayments_pay_url у потрібному місці, яка містить посилання

Щоб здійснити повторний платіж, потрібно скинути payment_sum, раніше згенероване посилання, а потім знову призначити змінну payment_sum, щоб отримати нове посилання.

Як обробити результат

Після успішної оплати до бота будуть надіслані зворотні виклики, які повідомлять, що платіж пройшов успішно. Ви бачите ці зворотні виклики в системі як повідомлення від користувача. Щоб користувач не міг їх надсилати, вони складаються з перших 10 символів секретного ключа та постскриптуму _success, наприклад: 16831CF4b5_success

Ці зворотні виклики НЕ ВИДНІ користувачеві, вони відображаються лише оператору.

Тип порівняння має бути "Повний збіг"

Також після успішної оплати змінна coinpayments_payment_completed встановлюється в True.

Наприклад, ви можете обробити успішний платіж в умовному блоці та відобразити відповідне повідомлення користувачеві:

Після завершення платежу до клієнта буде додано змінну coinpayments_payment_callback, яка містить дані відповіді платіжної системи на завершену транзакцію. Ви можете витягти необхідні дані з отриманого словника за допомогою методу get.

Як перевірити статус платежу

Щоб перевірити статус платежу, використовуйте метод coinpayments_get_payment_status() у полі Calculator.

Приклад:

Приклад статусу:

Очікування коштів покупця...

Кошти отримано та підтверджено, незабаром буде надіслано вам...

Завершено