Розробникам
Вбудований віджет
Клієнт платить, не залишаючи ваш домен. Ви створюєте рахунок через API і відображаєте платіжну форму CryBit на власній сторінці.
1. Створіть рахунок
Використовуйте той самий POST /api/v1/payments. У відповіді завжди є confirmation.confirmation_token, який дорівнює uuid рахунку. Поле confirmation у запиті необов’язкове.
2. Підключіть скрипт і додайте контейнер
HTML
<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>3. Відобразіть форму
JavaScript
const checkout = new CryBitCheckout({
confirmation_token: 'INVOICE-UUID',
return_url: 'https://merchant.example/thanks',
lang: 'en',
error_callback: (err) => console.log(err),
})
checkout.render('payment-form').then(() => { /* the form is shown */ })
checkout.on('success', () => { /* status paid: confirm the order by webhook or GET */ })
checkout.on('fail', () => { /* expired, cancelled or refunded */ })
checkout.on('complete', () => checkout.destroy())Модальне вікно
Якщо на сторінці немає контейнера, відкрийте віджет поверх сайту з customization: { modal: true } (або modal: true) і викличте checkout.render() без аргументів.
Опції та події
| Опція | Значення |
|---|---|
confirmation_token | Обов’язково. uuid рахунку (псевдоніми: uuid, invoice_uuid). |
return_url | Куди потрапляє клієнт після оплати. |
lang | Мова інтерфейсу; інакше мова браузера. |
modal / customization.modal | true для спливаючого вікна замість контейнера. |
error_callback, success_callback | Викликається при помилці (немає токена, немає контейнера) і коли статус стає paid. |
Події: ready, status, success, fail, complete, close, error. Методи: render(id), on(event, fn), destroy().
Підтверджуйте замовлення через webhook або читанням статусу. Подія віджета призначена лише для інтерфейсу користувача.
Вопросы и ответы
Чи можна протестувати віджет?
Так. У тестовому мерчанті віджет показує кнопку, щоб позначити рахунок сплаченим, а баланс не зараховується.