Төлем сілтемелері

Шот-фактураға не кіреді#

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

Жария сипаттамаларға құпия сөздерді, API кілттерін, карта деректерін немесе банк кодтарын ешқашан қоспаңыз. Клиент танитын тапсырыс тақырыбын және сілтемені пайдаланыңыз.

• Дүкен атауы, 120 таңбаға дейінгі тапсырыс тақырыбы және 500 таңбаға дейінгі сипаттама.
• Негізгі сома және нақты USD, RUB немесе USDT валютасы.
• Үйлесімді әдістер, бөлек комиссия және ҚҚС үлестері, тапсырыс сілтемесі және сілтеменің мерзімі.
• Иелердің жауаптары link.payment-ті қамтиды, ол бар операцияның сақталған күйін көрсетеді; бұл сілтеменің қолжетімділік күйінен бөлек.

Кез келгені — тұтынушы таңдайды#

Кез келгені есепшот валютасына сәйкес келетін барлық әдістерді таңдайды: USD үшін карталар мен Alipay, RUB үшін SBP, ал USDT үшін крипто. API 'any' жолының орнына нақты әдістер массивін қабылдайды. Әр әдістің өз бағасы бар.

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

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

Сілтеме жасау#

1. 1

   Төлем сілтемелерін тіркелгіңізде ашыңыз.

2. 2

   Тақырып, сома, валюта және сипаттама енгізіңіз. Екі басқару элементі арқылы комиссия мен ҚҚС үлестерін орнатыңыз.

3. 3

   Тұтынушы таңдауы үшін «Кез келгені» опциясын қалдырыңыз немесе нақты әдістерді таңдаңыз. Мерзімін орнатыңыз.

4. 4

   Әр әдіс үшін жалпы соманы салыстырып, төлем бетін алдын ала қараңыз.

5. 5

   Дайын төлем сілтемесін жасағаннан кейін бірден алыңыз, сосын оны тұтынушыға немесе виджетке көшіріңіз.

Шарттар есепшотпен бірге қалады#

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

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

Арнайы төлем беті#

Сервер сілтемелері дерекқорда сақталады және /pay/… мекенжайы арқылы әртүрлі құрылғыларда сатушы тіркелгісіне қолжетімділіксіз ашылады. Тұтынушыға есепшотты көру үшін тіркелу қажет емес. Дүкен баланстары, параметрлер және басқа тұтынушы жазбалары жеке болып қалады.

/pay/demo мысалы ақша алмай-ақ тәжірибені көрсетеді. Браузер демо сілтемелері тест деректері болып табылады және нақты есепшоттар ретінде ұсынылмауы керек.

Қолжетімділікті басқару#

Сілтемені тоқтата тұру, болдырмау немесе мерзімін өткізу жаңа операцияны бұғаттайды. Бұл жіберілген төлемді жасырмайды: мәртебе, есептестіру және сұралған банк коды қолжетімді болып қалады. Сілтеменің қолжетімділігі мен қаржылық күйі бөлек тексеріледі.

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

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

Жиынтық аналитика мен операциялар үшін Барлық дүкендерді таңдаңыз немесе жеке жазбалары үшін дүкенді таңдаңыз. Әр дүкеннің жеке 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, оқиғалар тарихы немесе қол қойылған вебхук арқылы тексергеннен кейін орындаңыз.