Әзірлеушілерге
Ендірілген виджет
Клиент домениіңізден шықпай-ақ төлейді. Сіз инвойсты API арқылы жасайсыз да, CryBit төлем формасын өз бетіңізде көрсетесіз.
1. Инвойс жасау
Сол POST /api/v1/payments қолданылады. Жауапта әрдайым инвойс uuid-іне тең confirmation.confirmation_token болады. Сұраныстағы 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 арқылы немесе статусты оқу арқылы растаңыз. Виджет оқиғасы тек пайдаланушы интерфейсі үшін.
Вопросы и ответы
Виджетті тестілей аламын ба?
Иә. Тест мерчантта виджет инвойсты төленген деп белгілейтін түйме көрсетеді, ал баланс есептелмейді.