Coinpayments
Як підключити
Щоб підключити платіжну систему Coinpayments, знадобляться 4 значення: seller ID, IPN secret (для вебхуків), приватний API-ключ і публічний API-ключ, а також потрібно вказати 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, якщо вона є у користувача в salebot.
Після цього слід встановити значення payment_sum змінної (наприклад, 10 або 0.0055 (через крапку!)), одразу після цього з'явиться paycoinments_pay_url змінна. Цю змінну можна відобразити як посилання або розмістити на кнопці з текстом "Pay". Посилання таке: 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
Приклад:
Приклади статусів:
Очікування надходження коштів від покупця...
Кошти отримано, підтвердження надходження вам буде надіслано незабаром…
Завершено
Last updated