Тіркелу
Сервисте тіркелгеннен кейін https://auth.inxy.io/ Payment gateway API мәзіріне өтіп, келесі ақпаратты толтырыңыз:
- Әмиян атауы мен сипаттамасы, белгішесі.
- Сілтеме веб-сайтқа сіздің өтінішіңіз бойынша орналастырылады.
Қабылданған криптовалюталардың барлық түрлерін белгілеп, Save Changes түймесін басыңыз
Сақтағаннан кейін байланыс деректері өрісі ашылады.
Әрі қарай, Generate(1) түймесін басу арқылы API кілтін жасаңыз және электрондық поштаңызға жіберілген кодты енгізіңіз.
Алынған айнымалыны қауіпсіз жерде сақтау керек. Сондай-ақ, Secret Key-ді сол жерге көшіріңіз.
Кілттер жоғалған жағдайда қайта жасалуы мүмкін (егер бұл орын алса, жобадағы деректерді өзгертуді ұмытпаңыз).
Postback Url (2) өрісінде вебхуктар үшін url мекенжайын көрсетіңіз https://chatter.salebot.pro/inxy\_callback/result
Қосылым параметрлері
Содан кейін Mavibot → «Acquiring» бөлімі → INXY өтіп, connect түймесін басыңыз. Алынған API және Secret кілттерін өрістерге енгізіңіз.
Төлем сілтемесін жасау
Төлем сілтемесін жасау үшін payment_sum айнымалысының мәнін орнату қажет (мысалы, 1). Осыдан кейін inxy_pay_url айнымалысы пайда болады. Бұл айнымалыны сілтеме арқылы көрсетуге немесе «Төлеу» түймесіне орналастыруға болады.
НАЗАР АУДАРЫҢЫЗ!!! Жүйе доллармен жұмыс істейді! payment_sum ішінде көрсетілген сома INXY төлем жүйесімен доллар ретінде қабылданады.
Сілтеме келесідей көрінеді: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1
Сондай-ақ, payment_sum айнымалысының мәнін орнатпас бұрын, төлемді орнату үшін келесі міндетті емес айнымалыларды орнатуға болады:
inxy_currency - төлем жасалатын криптовалюта.
API кілтін жасау кезінде белгілеген мүмкін криптовалюталардың бірін көрсетуге болады. Егер оны бос қалдырсаңыз, төлеуші белгіленгендердің ішінен криптовалютаны таңдайды..
Қолжетімді мәндер: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'
inxy_description – төлем сипаттамасы
Назар аударыңыз! Алдымен параметрлер үшін қосымша айнымалылар, содан кейін payment_sum орнатылады.
Айнымалыларды бір блокта емес, тізбекте ертерек орнатуға болады. Ал сілтемені қамтитын inxy_pay_url айнымалысы дұрыс жерде көрсетілуі керек. Оны басқан кезде төлем формасы ашылады.
Назар аударыңыз! Жалпы сома жолында payment_sum-ға тең доллар мәні бар. Төменде жалпы крипто сомасында - таңдалған криптовалютадағы мән. Ол ағымдағы бағамға байланысты жиі өзгереді. Бұл клиент өз әмиянынан сізге төлеуі керек мән.
Назар аударыңыз!!! Бір сессия ішінде төлемге арналған әмиян мекенжайы клиентке тек 2 сағатқа бекітіледі. Клиентке уақыттың өтпегеніне және әмиян мекенжайының төлем кезінде өзекті екеніне көз жеткізуін ұсыныңыз. Егер сессия уақыты аяқталса, төлем процесін қайта бастау қажет.
Төлем нәтижесін өңдеу (төлем кері шақыруы)
Сәтті төлемнен кейін ботқа кері шақыру жіберіледі, ол төлемнің сәтті өткенін хабарлайды. Сіз бұл кері шақыруды жүйеде пайдаланушының хабары ретінде көресіз, сондықтан пайдаланушы оларды жібере алмайды. Бұл кері шақыруды пайдаланушының ӨЗІ КӨРМЕЙДІ, ол тек операторға көрсетіледі. INXY-де кері шақырулардың бірнеше түрі бар:
- Сәтті кері шақырулар токеннің алғашқы 10 таңбасынан және success жазбасынан тұрады, мысалы: uc8zsjNN1x_success
Бұл кері шақыру клиент соманы толық төлеген және төлемде ешқандай проблема болмаған жағдайда алынады. Осы кері шақырумен бірге жоба айнымалыларына inxy_payment_completed айнымалысы қосылады, ол True мәніне орнатылады. Сондай-ақ inxy_payment_status айнымалысы paid мәнін қабылдайды.
inxy_payment_status айнымалысы төлемді өңдеудің бүкіл кезеңінде өз мәнін өзгерте алады. Пайдаланушы форманы ашқаннан кейін ол waiting_payment күйін, содан кейін оның төлемін өңдеу кезінде waiting_confirmation мәнін, ал сәтті өңдеуден кейін paid немесе partially_paid мәнін қабылдайды.
Кері шақыруды өңдеу кезінде салыстыру түрі «Exact Match» болуы керек.
Мысалы, сіз шартты блокта сәтті төлемді өңдеп, пайдаланушыға сәйкес хабарламаны көрсете аласыз:
2. Крипто бағамы өзгерген немесе әмиян операциядан комиссияны шегерген жағдайлар бар, нәтижесінде сіздің шотыңызға толық емес сома түседі. Бұл жағдайда inxy_payment_status айнымалысы partially_paid мәнін қабылдайды және жүйеге кері шақыру жіберіледі.
Бұл жағдайда сізге қосымша төлемді сұрайтын хабарламаны клиентке жіберу қажет болады.
Мысалы, сіз кері шақырудың басталуына шарт қоя аласыз және оны алғаннан кейін клиентке төлем сілтемесі бар жасалған url мекенжайын қайта жібере аласыз немесе inxy_payment_status айнымалысы partially_paid мәніне тең болғанда блок іске қосылатын шартты орната аласыз.
Төлем сілтемесі тек 2 сағатқа жарамды екенін ескеріңіз! Егер клиент қалған бөлігін төлеуге үлгермесе, ол енді оны аша алмайды. INXY осы кезеңде бірінші толық емес төлемді өңдейтіндіктен, ақша клиентке қайтарылмайды. Оларды қайтару үшін INXY жеке кабинетіңізге өтіп, қайтару операциясын орындау қажет.
Жазылымды жасау
INXY жүйесінде жазылымдар жасауға болады. Ол үшін inxy_subscription_payment айнымалысына кез келген мәнді тағайындаңыз, содан кейін ай сайынғы жазылым жасалады.
Егер сіз басқа кезеңді көрсеткіңіз келсе, келесі айнымалыларды пайдаланыңыз: inxy_subscription_interval 'day' мәніне тең - интервалды күндерге тең етіп орнатады (әдепкі бойынша, бұл ай)
inxy_subscription_period - жиілікті орнату үшін 1-ден 30-ға дейінгі айнымалыны көрсетіңіз.
Мысалы, 15 күнде бір рет жазылым алымын жасау үшін inxy_subscription_interval =’day’ және inxy_subscription_period=15 орнату керек, ал төлемді алты айда бір рет алу үшін inxy_subscription_period=6 көрсету жеткілікті (inxy_subscription_interval әдепкі бойынша ай болғандықтан)
Сілтеме бойынша өткенде, пайдаланушы бірдей төлем бетін көреді, бірақ бірнеше айырмашылықтармен: біріншіден, жағында төлемнің көрсетілген жиілікпен жазылымның бөлігі екенін көрсететін ескерту болады; екіншіден, төлем беті клиентке екі немесе үш соманы алдын ала төлеу мүмкіндігін ұсынады.
INXY төлем жүйесінің ерекшеліктері: Егер клиент соманың x2 немесе x3 бөлігін төлесе, Mavibot олардың тек біреуі үшін төлем туралы хабарлама алады. Қалған сома клиенттің балансына жіберіледі, одан кейінгі алымдарда сома алынады. Криптовалюта бағамы үнемі өзгеріп отыратындықтан, нәтижесінде бұл сома келесі алым үшін жеткіліксіз болуы мүмкін, бұл толық төленбеген жазылым жағдайына әкеледі. Бұл жағдайда сіз «fail» кері шақыруын аласыз және клиентке еске салғышты орнатуға болады.
Кесте бойынша ішінара төлем болуы мүмкін емес. Баланс төлемге дейін тексеріледі, егер баланс жеткіліксіз болса, ақша клиенттің шотынан алынбайды.
Сәтті жазылымнан кейін клиент айнымалыларында inxy_subscription_id айнымалысы пайда болады, ол жазылым нөмірін және inxy_subscription_status оның күйімен көрсетеді.
Жазылымды болдырмау
Жазылымды болдырмау үшін inxy_remove_subscription(inxy_subscription_id) функциясын пайдаланыңыз. Функцияға inxy_subscription_id жазылым идентификаторын енгізіңіз, сонда жазылым болдырылады.
Сәтті болған жағдайда, сіз ‘Subscription status inxy_subscription_id - deleted’ кері шақыруын аласыз және inxy_subscription_status айнымалысы сәйкес мәнге өзгереді.
