Банк терминалын Torgsoft қосу хаттамасын қалай таңдауға болады: BPOS, PosApi, SSI, JSON және OschadPAY

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

Кәсіпкерлер әдетте банктен қандай хаттаманы тапсырыс беру керек, нақты терминал моделі жарай ма, жергілікті касса немесе қашықтағы сервер үшін қай нұсқа қолайлы, статикалық IP мекенжайы қажет пе және бір терминал арқылы бірнеше ИП-мен (Индивидуальный предприниматель) қалай жұмыс істеуге болады деген сұрақтар қояды. Техникалық қолдауға түскен өтініштер негізгі мәселе «ең жақсы» хаттаманы табу емес, банк, терминал және Torgsoft арасында бірдей қосылу тәсілін дұрыс сәйкестендіру екенін көрсетеді.

Банк терминалының хаттамасы дегеніміз не

Хаттама — Torgsoft пен банк терминалының деректер алмасу тәсілі.

Мысалы, Torgsoft терминалға мыналарды жібереді:

• төлем сомасын;

• төлем немесе ақшаны қайтару пәрменін;

• қажет болса, мерчант деректерін.

Терминал операция нәтижесін және қолжетімді төлем деректерін қайтарады.

Torgsoft BPOS, PosApi, SSIAxECR, SSI_JSON, WebSocket/JSON, JSON (COM/TCP), OschadPAY, BankCore, QRPayMono және басқа да өзекті нұсқаларды қоса алғанда, әртүрлі интеграция тәсілдерін қолдайды. Кейбір хаттамалар үшін банк драйверлерді немесе кітапханаларды ұсынуы керек.

 Үш ұғымды шатастырмау маңызды:

• хаттама — Torgsoft пен терминалдың пәрмендер алмасу тәсілі;

• қосылу — олардың физикалық немесе желі арқылы қосылу тәсілі: USB/COM, Ethernet, Wi-Fi;

• мерчант — нақты ИП-ға (Индивидуальный предприниматель) және шотқа байланыстырылған банктегі саудагер идентификаторы.

Яғни терминал Wi-Fi арқылы жұмыс істеп, сонымен бірге BPOS немесе JSON қолдана алады. Wi-Fi — эквайринг хаттамасы емес.

Хаттаманы таңдаудың негізгі ережесі

BPOS, PosApi немесе JSON хаттамасын тек банк атауына немесе терминал моделіне қарап өз бетіңізше таңдаудың қажеті жоқ.

Алдымен банктен мыналарды нақтылау керек:

1. Бұл терминал кассалық интеграция режимінде жұмыс істей ала ма.

2. Банк осы терминалда нақты қандай хаттаманы баптай алады.

3. Терминал қалай қосылады: USB/COM, Ethernet немесе Wi-Fi.

4. Интеграция үшін банк қандай драйверлер мен кітапханаларды ұсынады.

5. Төлемдер мен қайтарымдар үшін қажетті мерчанттар бапталған ба.

Осыдан кейін Torgsoft тиісті хаттама таңдалады.

Бұл жай ғана формалдылық емес. Torgsoft техникалық қолдауында PrivatBank-тің Newland N950 терминалына қатысты жағдай болды: терминалдың өзі дұрыс жұмыс істеген, бірақ банк құрылғыны кассалық интеграция режимінде жұмыс істеуге баптамағандықтан, оны Torgsoft қосу мүмкін болмаған. Клиентке банкке хабарласып, Wi-Fi арқылы JSON баптау ұсынылды.

Сондықтан үйлесімді терминал моделінің болуы жеткіліксіз. Терминалда қажетті жұмыс режимі де дұрыс бапталуы керек.

Қысқаша: негізгі нұсқалардың айырмашылығы

Оларды «біреуі жақсы, екіншісі нашар» қағидасы бойынша салыстырудың мәні жоқ. Банк, нақты жабдық және Torgsoft бір уақытта қолдайтын нұсқа қажет.

BPOS және BPOS1

BPOS үшін банк қажетті драйверлерді және ECRCommX.dll кітапханасын ұсынады. Torgsoft банк терминалдарымен интеграциялау үшін осы хаттаманы қолдайды.

BPOS-тың маңызды ерекшелігі бар: іс жүзінде екі режим кездеседі.

Бұл төлем терминалда аяқталған, бірақ байланыс қатесіне байланысты бағдарлама нәтижені алмаған немесе растамаған жағдайда маңызды. PrivatBank POS терминалдарын қосу нұсқаулығында BPOS пен BPOS1 арасындағы дәл осы айырмашылық сипатталған.

Кәсіпкерге «BPOS-ты BPOS1-ге ауыстырудың» қажеті жоқ. Егер терминалдағы нәтиже мен кассадағы нәтиже сәйкес келмесе, банктен қандай режим бапталғанын нақтылау керек.

Torgsoft техникалық қолдауына түскен өтініштерде BPOS Ingenico терминалдарын Ethernet арқылы желілік қосу кезінде де қолданылады: порт бапталып, терминалдың IP мекенжайы резервтеліп, қосылу тексерілген.

BPOS қашан таңдалады

Егер банк нақты терминалдың кассалық интеграция үшін BPOS арқылы жұмыс істейтінін растап, қосылуға қажетті компоненттерді ұсынса, бұл хаттаманы Torgsoft қолдануға болады.

Егер касса RDP арқылы қашықтан жұмыс істесе, бұл туралы банкке және Torgsoft техникалық қолдауына бірден хабарлаған дұрыс: мұндай сценарийде хаттамамен қатар желілік қосылу және операциялардың дұрыс расталуы да маңызды.

PosApi

Torgsoft PosApi жеке хаттама ретінде қолдау табады. Ол үшін тиісті банк жабдығына берілетін терминал драйвері және Posapi.dll кітапханасы қажет. Torgsoft өзекті құжаттамасында, соның ішінде Raiffeisen Bank-тің Verifone VX520 терминалына арналған жеке нұсқаулық бар.

Кәсіпкер үшін логика қарапайым: банк терминал кассамен PosApi арқылы жұмыс істейтінін айтады → банк қажетті бағдарламалық жасақтаманы береді → Torgsoft PosApi бапталады.

Терминал белгілі бір өндірушіге тиесілі болғаны үшін ғана PosApi таңдаудың қажеті жоқ. Torgsoft-тың өзекті құжаттамасында банк терминалының түрі көрсетілетін өріс көмекші екені, ал жұмыс алгоритмін таңдалған хаттама анықтайтыны бөлек көрсетілген.

SSI: SSIAxECR және SSI_JSON

Torgsoft екі бөлек нұсқа бар:

• SSIAxECR;

• SSI_JSON.

Оларды бір-бірін алмастыратын бір баптау ретінде қарастыруға болмайды.

Мысалы, Torgsoft құжаттамасында Verifone X990 үшін SSIAxECR бойынша жеке нұсқаулық бар, ал SSI_JSON басқа хаттама ретінде бапталады.

Сондықтан терминалды алған кезде банктен: «Бізде SSI бар ма?» деп сұрау жеткіліксіз. Құрылғыда нақты қай хаттама бапталғанын анықтау қажет.

Банктен не сұрау керек

Мынадай сұрау жеткілікті: "Терминалды Torgsoft кассалық бағдарламасымен интеграциялау қажет. Қай SSI хаттамасы бапталғанын нақтылаңыз: SSIAxECR немесе SSI_JSON және қосылу параметрлерін беріңіз".

Бұл бағдарламадағы баптауларды өз бетіңізше таңдауға тырысқаннан әлдеқайда тиімді.

JSON: бір атау, бірнеше нұсқа

JSON жиі түсінбеушілік тудырады, өйткені JSON — терминалдың бір ғана баптауы емес.

Torgsoft, атап айтқанда, мыналар бар:

• WebSocket/JSON;

• JSON (COM/TCP).

WebSocket/JSON үшін құжаттамада желілік және USB/COM қосылуларына арналған бөлек компоненттер қарастырылған. JSON (COM/TCP) деректер алмасудың басқа тәсілін пайдаланады.

Сондықтан банктің «терминал JSON арқылы жұмыс істейді» деген жауабы жеткіліксіз. Мыналарды нақтылау қажет:

• JSON-ның нақты қай нұсқасы қолданылатынын;

• USB/COM немесе желілік қосылу екенін;

• желілік қосылу кезінде — IP мекенжайы мен портты;

• банк терминалды кассалық интеграция режиміне ауыстырғанын.

Мұны техникалық қолдау тәжірибесі де растайды. PrivatBank-тің Newland N950 терминалымен жергілікті желі ішіндегі Wi-Fi қосылымдары да, басқа интеграция нұсқалары да кездескен. Техникалық қолдау IP мекенжайын, роутер баптауларын және терминалмен байланысты тексерген.

Сондықтан «Newland = JSON = кез келген баптау жарайды» формуласы дұрыс емес. Банктің нақты құрылғыны қалай баптағанын дәл білу қажет.

OschadPAY: смартфонмен жұмыс істеудің жеке сценарийі

OschadPAY кәдімгі POS терминалдарына арналған BPOS, PosApi және басқа нұсқалардан ерекшеленеді.

Torgsoft OschadPAY-мен интеграциясы смартфон арқылы контактісіз төлемдерді қабылдау үшін қосылған. Тиісті функциясы бар телефон жеке стационарлық POS терминалсыз картамен төлем қабылдау үшін пайдаланылады.

Сондықтан дәл осындай сценарий қажет болса, мысалы, мобильді касса немесе жеке банк терминалын орнату ыңғайсыз сауда нүктесі үшін OschadPAY нұсқасын қарастыруға болады.

Егер дүкен Oschadbank-тен кәдімгі POS терминал алған болса, OschadPAY-ді автоматты түрде таңдаудың қажеті жоқ. Алдымен банк ұсынған жабдық үшін нақты қандай кассалық интеграция тәсілі қолданылатынын анықтау керек.

USB, Ethernet немесе Wi-Fi

Хаттама мен қосылу тәсілін бірге таңдау керек.

Егер Torgsoft касса жанындағы компьютерде жұмыс істесе

Егер банк осы терминал үшін осындай қосылу тәсілін қарастырған болса, USB/COM ыңғайлы болуы мүмкін.

Бұл сценарийде бағдарлама мен терминал арасында бөлек желілік маршрут жоқ.

Егер терминал Ethernet немесе Wi-Fi арқылы жұмыс істесе

Терминалдың желіде өз IP мекенжайы болады. Оның күтпеген жерден өзгермеуі маңызды.

Нақты өтініштерде техникалық қолдау:

• терминалдың IP мекенжайын тексереді;

• мекенжайды роутерде резервтейді;

• қажетті портты тексереді;

• құрылғының қолжетімділігін тексереді;

• содан кейін тестілік төлем жүргізеді.

Егер роутер терминалға басқа IP мекенжайын берсе, POS терминал жеке банк терминалы ретінде жұмысын жалғастырып тұрса да, Torgsoft оны таппай қалуы мүмкін.

Қашықтағы сервер немесе RDP арқылы жұмыс істегенде не өзгереді

Бұл жерде екі құрылғының қайда орналасқанын түсіну маңызды:

• POS терминал физикалық түрде дүкенде орналасқан;

• Torgsoft басқа жерде орналасқан серверде жұмыс істеуі мүмкін.

Сондықтан сервер дүкендегі терминалға пәрмен жіберіп, одан жауап ала алуы керек.

Осы себепті қашықтан жұмыс істеген кезде мыналарды тексеру қажет:

• қандай хаттама қолданылатынын;

• оның таңдалған желілік сценарийді қолдайтынын;

• терминалдың IP мекенжайын;

• қажетті портты;

• роутер мен firewall баптауларын;

• Torgsoft жұмыс істейтін ортадан терминалға қол жеткізу мүмкіндігін.

Техникалық қолдау жазбаларында POS терминалмен байланыс желілік параметрлерге немесе IP мекенжайының өзгеруіне байланысты болмаған жағдайлар кездеседі. Сондай-ақ дүкеннің жұмыс істеуі үшін статикалық IP мекенжайы қажет болған жағдай да бар.

Алайда «кез келген RDP үшін міндетті түрде сыртқы статикалық IP мекенжайын сатып алып, Port Forwarding баптау керек» деген ереже дұрыс емес. Барлығы нақты желінің қалай құрылғанына байланысты. Алдымен қосылу схемасын анықтау керек.

Егер бірнеше ИП бір терминалмен жұмыс істесе

Хаттаманың өзі бұл мәселені шешпейді.

Әр кәсіпкер үшін мына байланыс дұрыс бапталуы керек: ИП (Индивидуальный предприниматель) → ағымдағы шот → мерчант → банк терминалы.

Torgsoft техникалық қолдауында мынадай өтініштер тұрақты кездеседі:

• жаңа ИП қосу;

• оның терминалда бар-жоғын тексеру;

• Torgsoft тиісті мерчантты қосу;

• шоттармен байланысын баптау;

• төлем мен қайтарымды тексеру.

Егер банк қажетті мерчантты терминалға қоспаса, оны тек Torgsoft баптау жеткіліксіз.

Мұны касса жұмысын бастамай тұрып тексеру керек, алғашқы төлем басқа ИП-ның шотына түскеннен кейін емес.

Неліктен терминал қосылғанымен, төлем дұрыс жұмыс істемеуі мүмкін

Torgsoft терминалды көріп тұрғаны тек байланыстың орнатылғанын білдіреді.

Қосылғаннан кейін басқа мәселелер қалуы мүмкін:

• қате мерчант таңдалған;

• банк терминалды басқа режимге баптаған;

• бағдарлама мен POS терминал операция нәтижесін әртүрлі түсінген;

• төлем жұмыс істейді, бірақ қайтарым бапталмаған;

• роутер ауыстырылғаннан кейін терминал басқа IP мекенжайын алған.

Сондықтан баптаудан кейін тек қосылымды ғана емес, бүкіл жұмыс циклін тексеру керек.

Қосылғаннан кейін терминалды қалай дұрыс тексеруге болады

Баптаудан кейін қысқа тест жүргізген дұрыс.

1. Терминалмен байланысты тексеріңіз.

2. Шағын сомамен тестілік төлем жасаңыз.

3. Соманың Torgsoft автоматты түрде жіберілгенін тексеріңіз.

4. Merchant ID мен қажетті ИП-ны тексеріңіз.

5. Сатылымның Torgsoft дұрыс аяқталғанына көз жеткізіңіз.

6. Егер ККМ/ПККМ қолданылса, фискалдық чекті тексеріңіз.

7. Тестілік қайтарым жасаңыз.

8. Ақша мен құжаттардың дұрыс көрсетілгеніне көз жеткізіңіз.

Torgsoft білім базасы банк терминалын баптағаннан кейін тестілік төлем жүргізуді, мерчантты тексеруді және тестілік қайтарым жасауды ұсынады.

Бұл сатылым жұмыс істеп, ал қайтарым жұмыс істемейтін жағдайды бірден анықтауға мүмкіндік береді.

Терминалды алмас бұрын банкке не айту керек

Кәсіпкерге BPOS, SSI және JSON арасындағы барлық техникалық айырмашылықтарды білу міндетті емес.

Банкке нақты міндетті айту жеткілікті: "Маған Torgsoft бағдарламасымен кассалық интеграция режимінде жұмыс істейтін банк терминалы қажет. Осы модель мен банк үшін қандай интеграция хаттамасы қолжетімді екенін, терминалдың кассаға қалай қосылатынын және қосылу үшін қандай драйверлер, кітапханалар мен параметрлер қажет екенін хабарлаңыз".

Егер Torgsoft қашықтағы сервер арқылы жұмыс істесе, бұл туралы бірден айту керек.

Егер бір терминалмен бірнеше ИП жұмыс істейтін болса, мұны да баптауға дейін банкпен келісу қажет.

Хаттаманы қалай таңдау керек: практикалық схема

◆ Егер терминал бар болса, алдымен банктен онда қандай кассалық интеграция хаттамасы бапталғанын біліңіз. Содан кейін оны Torgsoft қолдайтын хаттамалармен салыстырыңыз.

◆ Егер терминалға енді ғана тапсырыс беріп жатсаңыз, банкке Torgsoft интеграция қажет екенін айтып, қандай хаттама мен қосылу тәсілі қолжетімді екенін нақтылаңыз.

◆ Егер Torgsoft қашықтағы серверде жұмыс істесе, хаттаманы таңдағанда POS терминалға желілік қолжетімділікті де тексеріңіз.

◆ Егер бірнеше ИП қолданылса, әр кәсіпкер үшін мерчанттарды банкпен бөлек келісіңіз.

◆ Егер жеке POS терминалсыз смартфон арқылы төлем қабылдау қажет болса, OschadPAY-ді жеке сценарий ретінде қарастыруға болады.

Ең бастысы

BPOS, PosApi, SSI немесе JSON хаттамасын қайсысы «заманауирақ» деген қағида бойынша таңдаудың қажеті жоқ. Дүкен үшін дұрыс хаттама — банк нақты терминалда баптаған, Torgsoft қолдайтын және таңдалған қосылу схемасы төлемдерді сенімді жіберіп, операция нәтижелерін алуға мүмкіндік беретін хаттама.

Кассаны іске қоспас бұрын бес нәрсені тексеру жеткілікті: хаттама → қосылу тәсілі → қажет болса IP/порт → мерчант → тестілік төлем және қайтарым.

Күнделікті сауда жұмысында интеграцияның дұрыс жұмыс істеуіне көбінесе дәл осы тармақтар әсер етеді.