Coinpayments
Як підключити посилання How to connect
Як сформувати посилання на оплату посилання How to generate a payment link
Як обробити результат посилання How to process the result
Як перевірити статус платежу посилання How to check the payment status
Як підключити
Щоб підключити платіжну систему Coinpayments, вам знадобляться чотири значення: ID продавця, секрет IPN (для вебхуків), приватний ключ API та публічний ключ API. Також потрібно буде вказати URL вебхука.
Перейдіть до особистого кабінету Coinpayments -> Налаштування облікового запису https://www.coinpayments.net/index.php?cmd=acct_settings
На першій вкладці скопіюйте ID продавця. (ID продавця)
Далі перейдіть на вкладку "Налаштування продавця" та створіть і введіть секретний ключ IPN - секрет IPN ( Це використовується для перевірки, що вебхук надходить від нас). Використовуйте надійний, складний рядок, який важко вгадати
IPN-посилання - це URL для вебхуків, додайте наступне: https://chatter.salebot.pro/coinpayments_callback/result
Далі перейдіть до розділу API Keys і згенеруйте пару ключів для доступу до API.
Збережіть усі налаштування, скопіюйте дані та перейдіть до налаштувань у Mavibot. Відкрийте розділ "Acquiring", виберіть Coinpayments.
Вам потрібно ввести отримані дані.
Щоб згенерувати посилання на оплату, потрібно встановити значення потрібних змінних:
original_currency
Початкова валюта транзакції.
sending_currency
Валюта, яку надішле клієнт.
Наприклад, якщо ваші товари мають ціну в USD, але ви отримуєте BTC, слід використовувати original_currency = USD і sending_currency = BTC. original_currency та sending_currency можуть мати одне значення, якщо конвертація валюти не потрібна.
buyer_email
Електронна адреса клієнта.
Для надсилання сповіщень, якщо платіж на меншу суму і потрібно доплатити, або для повернень коштів. Якщо ця змінна не встановлена, пошта буде взята автоматично зі змінної email, якщо вона є у користувача в Mavibot.
Після цього потрібно встановити значення 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
Ці колбеки НЕ ВИДИМІ для користувача, вони відображаються лише оператору.
Тип порівняння має бути "Complete Match"
Також після успішної оплати змінна coinpayments_payment_completed встановлюється в True.
Наприклад, ви можете обробити успішний платіж у умовному блоці та відобразити відповідне повідомлення користувачеві:
Після завершення платежу coinpayments_payment_callback змінна буде додана до клієнта, міститиме дані відповіді платіжної системи щодо завершеної транзакції. Ви можете витягти потрібні дані з отриманого словника за допомогою get методу.
Як перевірити статус платежу
Щоб перевірити статус платежу, використовуйте coinpayments_get_payment_status() метод у полі Calculator.
Приклад:
Приклад статусу:
Очікування надходження коштів від покупця...
Кошти отримано, підтвердження надходження вам буде надіслано незабаром…
Завершено
Останнє оновлення