Чек-аутты веб-сайтыңызға ендіріңіз
Төлемді модальды терезеде ашу, оны бетке енгізу немесе тұтынушыны арнайы төлем бетіне жіберу. Виджет жалпыға қолжетімді төлем URL мекенжайын пайдаланады және браузерде сатушының API кілті қажет емес.
Осы бетте
Шот-фактурадан төлемге дейін#
/account#links мекенжайында шот-фактура жасаңыз және дереу checkoutUrl алыңыз. /account#widget ашып, сілтемені қойыңыз және модальды, инлайн блокты немесе қайта бағыттауды таңдаңыз. Кілттер мен вебхуктар көршілес аккаунт бөлімдерінде қолжетімді.
Құрастырушы алдын ала қарау әрқашан ақша алусыз демо тапсырысты пайдаланады. Жасалған виджет коды сіздің тірі сілтемеңізді сақтайды, оның шарттары сақталған серверлік шот-фактурадан келеді.
Интерфейстегі жаңа шот үшін USD карталар мен Alipay ұсынады; RUB SBP ұсынады; USDT криптоны ұсынады. API сондай-ақ үйлесімділік үшін USD + криптоны сақтай алады, бірақ оның тірі крипто төлемі crypto_requires_usdt кодымен бұғатталған. USD және USDT бөлек, автоматты айырбастау немесе болжалған 1:1 бағам жоқ. Крипто төлемі бөлек USDT шотын талап етеді.
Қалыпты сілтеме резерві бар түйме#
Бұл мысал ақша алусыз демо ашады. Екі URL мәнін шот-фактура жауабыңыздағы checkoutUrl-мен ауыстырыңыз. Скриптті төлем URL-мен бірдей Kevmi доменінен жүктеңіз.
href JavaScript қолжетімсіз болғанда төлемді ашады. data-kevmi-label iframe-ге қолжетімді атау береді. Скриптті әр бетке бір рет қосыңыз.
<script src="https://kevmi.maxeevmax1.chatgpt.site/widgets/kevmi.js" defer></script>
<a href="https://kevmi.maxeevmax1.chatgpt.site/en/pay/demo"
data-kevmi-checkout="https://kevmi.maxeevmax1.chatgpt.site/en/pay/demo"
data-kevmi-mode="modal"
data-kevmi-label="Order checkout">Pay securely</a>Төлемді ашудың үш жолы#
Инлайн режим үшін div сияқты контейнерді пайдаланыңыз және CHECKOUT_URL_FROM_API мәнін нақты URL-мен ауыстырыңыз. Кадр өз контейнерінің еніне бейімделеді; төлем хабарламалары оның биіктігін шектелген ауқымда өзгерте алады.
Модаль оның түймесімен, Escape пернесімен немесе фонды басу арқылы жабылады. Фокус жабылғаннан кейін бастапқы триггерге оралады. Қозғалысты азайту параметрлері ауысуды қысқартады.
| data-kevmi-mode | Мінез-құлық | Не үшін қолайлы |
|---|---|---|
| модаль | Қабаттасатын диалог; әдепкі режим | Тапсырыс деңгейіндегі төлем түймесі |
| инлайн | Таңдалған контейнер ішіндегі iframe | Сайтыңыздағы төлем қадамы |
| қайта бағыттау | Ағымдағы қойындыда Kevmi-ге навигация | Толық төлем беті |
<div data-kevmi-checkout="CHECKOUT_URL_FROM_API"
data-kevmi-mode="inline"
data-kevmi-label="Order checkout"></div>Интерфейсіңізден төлемді ашу#
kevmi:opened және kevmi:closed құжат оқиғалары интерфейсіңізге ашылу мен жабылуға реакция жасауға мүмкіндік береді. Триггердегі kevmi:error оқиғасы жарамсыз төлем URL-ін хабарлайды. Ешқайсысы төлемді дәлелдемейді. JavaScript API-ді виджет скрипті жүктелгеннен кейін шақырыңыз.
window.Kevmi.open(checkoutUrl, {
mode: 'modal',
label: 'Order checkout',
closeLabel: 'Close checkout'
});
// Inline blocks added after page load are detected automatically.
// You may also request mounting explicitly:
window.Kevmi.mount(document);Сәтті төлемді не дәлелдейді#
API кілттерін немесе қол қою құпияларын HTML-ге салмаңыз. Виджет тек бір шот-фактураға жалпыға қолжетімді сілтеме алады. Checkout карта деректерін және банк кодтарын шлюз кілтімен шифрлайды; Kevmi сервері оларды ашық мәтінде қабылдамайды.
postMessage интерфейс күйін жаңартады, тапсырысты орындауды емес. Өңдеу алдында хабарлама доменін және бастапқы терезені тексеріңіз. Соңғы нәтиже үшін тексерілген payment.succeeded оқиғасын немесе сервердің GET link.payment қорытындысындағы succeeded күйін пайдаланыңыз.
Виджетті өндіріске қосу алдында#
- Kevmi доменін Content Security Policy script-src және frame-src нұсқауларында басқа саясаттарды кеңейтпей рұқсат етіңіз.
- Тар экрандарды, пернетақта қолжетімділігін және жарық пен қараңғы тақырыптарды тексеріңіз.
- Шот-фактураның белсенді, мерзімі өтпеген және дұрыс бағасы мен шығын үлестері бар екенін растаңыз.
- Резерв ретінде қарапайым төлем сілтемесін сақтаңыз.
- Сәтсіз жеткізілімдер мен қайталанатын вебхук оқиғаларын тапсырысты екі рет шығармай сынаңыз.