Жылдам бастау

1. Өнімді зерттеңіз#

Тест тапсырысын жасау, төлем сілтемелерін зерттеу және комиссияны есептеуді тексеру үшін демо жұмыс кеңістігін ашыңыз. Демо бөлек тест деректерін пайдаланады. Ол банк төлемін жасамайды немесе әмиянға ақша аудармайды.

2. Telegram арқылы аккаунт жасаңыз#

Telegram-ға кіргеннен кейін сатушы аккаунты ашылады. Веб-сайтта тіркелу /account#applications мекенжайында; форма да, жеке бақылау да /account#applications/{id} қолданба ішінде қалады.

Жаңа төлем және карта ниеті сатушының соңғы веб-сайт шолу өтінімінің мақұлдануын талап етеді. Мақұлдау ғана төлем шлюзін қоспайды. Егер шолу жөнелтілгеннен кейін өзгерсе, бар операция мәртебе оқуы, есеп айырысу және сұралған банк коды үшін қолжетімді болып қалады.

3. Дүкеніңізді орнатыңыз#

1. 1

   Клиентіңіз танитын дүкен атауын таңдаңыз.

2. 2

   Әдепкі ҚҚС ережесін таңдаңыз. Әр жаңа шот клиент комиссиясы мен ҚҚС үлестерін 0-ден 100%-ға дейін бөлек қабылдайды.

3. 3

   Telegram-да алғыңыз келетін хабарландыруларды таңдаңыз.

4. 4

   Типтік тапсырыс сомасын тексеру үшін калькуляторды пайдаланыңыз.

4. Төлем сілтемесін дайындаңыз#

Нақты тапсырыс тақырыбын, соманы және валютаны енгізіңіз. Клиент сатып алу мәліметтері мен төленетін жалпы сомасы бар арнайы бетті алады. Бар шот дүкен параметрлері өзгерген кезде бастапқы шарттарын сақтайды.

5. Төлемнің қолжетімділігін тексеріңіз#

Шоттарды, API кілттерін, виджеттерді және вебхуктарды аккаунтыңыздан басқарыңыз. Төлем алдында Kevmi шлюз конфигурациясын, сатушының мақұлдануын, соманы және шот шарттарын тексереді. Таңдалған әдіс қолжетімсіз болса, төлем беті себебін түсіндіреді.

Жаңа жұмыс кеңістігі шоттары АҚШ доллары базалық бағасын пайдаланады, ал Any төрт әдістің барлығын ұсынады. SBP Ресей Банкінің мұздатылған анықтамалық бағамы бойынша рубльге айырбастайды; крипто айқын 1:1 АҚШ доллары/USDT шот ережесін пайдаланады. Мұрагерлік қолма-қол баға белгілеу ескі шоттар мен pricingMode=universal жоқ API сұраулары үшін қолжетімді болып қалады. Төмендегі бірнеше дүкен және АҚШ доллары бағасы бөлімін қараңыз.

Жаңа тірі карта немесе Alipay төлемі үшін ағымдағы шлюз тек feeCustomerPercent=0 және vatCustomerPercent=100 мәндерін қолдайды: сатушы барлық өңдеу комиссиясын жабады, ал ҚҚС клиент үшін толық қосылады. Басқа үлестер шотта сақталып, есептелуі мүмкін, бірақ орындау unsupported_allocation кодымен бұғатталған. Сервер үнсіз сақталған шарттарды өзгертпейді. SBP және USDT крипто төлемдері кез келген өңдеу комиссиясы үлесін қолдайды және ҚҚС жоқ.

Бірнеше дүкен және бір АҚШ доллары базалық бағасы#

Жиынтық аналитика мен операциялар үшін Барлық дүкендерді таңдаңыз немесе жеке жазбалары үшін дүкенді таңдаңыз. Әр дүкеннің жеке storeId, атауы, ҚҚС әдепкі мәні, шоттары, API кілттері, вебхук нүктелері, оқиғалар тарихы және веб-сайт қосымшасы бар. Хабарландырулар мен қолдау билеттері тіркелгіге тиесілі. Тіркелгі 100 дүкенге дейін құра алады. Бар жазбалар оның бірінші дүкенінде қалады.

Жаңа жұмыс кеңістігі шоттары pricingMode="universal" және АҚШ доллары базалық бағасын пайдаланады. Any карта, alipay, sbp және криптоны қамтиды; сатушы ішкі жиынтықты таңдай алады. Карталар мен Alipay АҚШ долларымен есептейді. SBP Ресей Банкінің АҚШ доллары/рубль анықтамалық бағамын пайдаланып рубльмен есептейді. Крипто айқын шот ережесі бойынша USDT-мен есептейді: 1 АҚШ доллары = 1 USDT. Бұл шот айырбастау ережесі, нарықтық USDT котировкасы емес. Шлюз таңдалған монетаның бағамын, нақты аударым сомасын және нұсқауларды аударымға дейін береді.

Анықтамалық бағам және екі сома да құру кезінде мұздатылады. Рубльге айырбастауды қамтитын шоттар 24 сағат ішінде мерзімі аяқталады. Егер анықтамалық бағамды алу мүмкін болмаса, құру FX_UNAVAILABLE қатесімен сәтсіз аяқталады; ойдан шығарылған немесе ескірген қосалқы бағам пайдаланылмайды. Меншік иесінің жауабындағы amountMinor және quotes АҚШ доллары бухгалтерлік валютасын пайдаланады. quotes[method].settlement туынды валютадағы төлем котировкасын қамтиды. Қоғамдық төлем беті таңдалған төлем валютасын currency өрісінде, бастапқы бағаны baseAmountMinor/baseCurrency өрістерінде және анықтамалық бағамды fx өрісінде көрсетеді. Төлем жіберілгеннен кейін оның әдісін өзгерту мүмкін емес; шотта бір шлюз операциясы болады.

Мақсатты дүкен ішінде API кілтін жасаңыз және серверіңізден Authorization: Bearer <key> жіберіңіз. Оның дүкенге байланыстыруы өзгермейді; X-Kevmi-Store оған басқа дүкенге қолжетімділік бере алмайды. Браузер сеанстары X-Kevmi-Store: <storeId> таңдайды; оны алып тастағанда бірінші дүкен таңдалады. all мәні тек GET /api/account/dashboard және GET /api/payment-links сұраулары арқылы қабылданады. Өзгертулер таңдалған дүкенді, Origin және X-CSRF-Token талап етеді. Тіркелгі идентификаторлары мен дүкен идентификаторлары әртүрлі идентификаторлар болып табылады.

Үйлесімділік үшін pricingMode="universal" жоқ API сұраулары қолма-қол баға белгілеуді және бастапқы валюта шектеулерін сақтайды. Бар шоттар ешқашан қайта есептелмейді. Аналитикадағы расталған түбіртектер тексерілген төлемдерден сақталған шот шығындарын шегергендегі соманы көрсетеді; олар шығарылатын баланс емес. Мұрагерлік шот валюталары бөлек қалады, ал төлемдер қолдау қызметімен келісіледі. Тапсырысты тек payment.fulfillmentReady=true және payment.status="succeeded" сервер API, оқиғалар тарихы немесе қол қойылған вебхук арқылы тексергеннен кейін орындаңыз.