Банктік есепшоттар: Privat24, monobank және UKRSIBBANK қалай орнатуға болады және қосылымды тексеруге болады

Сатып алушылар шоттарды IBAN арқылы төлеген кезде кәсіпкер бұл түсімдерді тек банкте ғана емес, Торгсофт бағдарламасында да көруі керек. Осы мақсатқа ақылы «Банк үзінділері» опциясы арналған: бағдарлама ПриватБанк, monobank және UKRSIBBANK банктерінің қосылған шоттары бойынша операцияларды алады. Бұл функцияны пайдалану кезінде бірқатар сұрақ туындауы мүмкін: нақты банкті қалай қосуға болады, банктің бизнес-кабинетінен қандай деректер алу керек, үзінділер неге жүктелмей қалды және неге бір пайдаланушы оларды көрсе, екіншісі көрмейді. 

Торгсофт бағдарламасында банк үзінділері қалай жұмыс істейді?

Торгсофт бағдарламасында әрбір банк шоты үшін жеке қосылым баптауы жасалады. Интерфейсте ол Merchant деп аталады. Бұл жағдайда ол жай ғана мына мәліметтер көрсетілетін профиль:

• қай банк пайдаланылатыны;

• операциялар қай шоттан алынатыны;

• онымен Торгсофттағы қандай есеп айырысу шоты байланыстырылғаны;

• банктің API интерфейсіне қол жеткізу үшін қандай деректер қажет екені;

• Торгсофт пайдаланушыларының қайсысы осы үзінділерді көруге құқылы екені.

Баптаудан кейін үзінділер Төлем → Банк шоттарының үзінділері бөлімі арқылы ашылады. Кезеңді таңдап, «Үзінділерді алу» түймесін басу керек. Торгсофт банк осы кезең үшін қайтарған операцияларды көрсетеді. 

Банкті қоспас бұрын нені тексеру керек?

Баптауды бастамас бұрын төрт нәрсені тексерген дұрыс.

1. «Банк үзінділері» опциясы белсендірілген.

2. Торгсофт бағдарламасында дұрыс IBAN және валютасы көрсетілген қажетті есеп айырысу шоты жасалған.

3. Дәл осы шот ашылған банктің бизнес-кабинетіне қол жеткізу мүмкіндігі бар.

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

Осыдан кейін Баптаулар → Банк шоттары бойынша үзінділерді баптау бөлімін ашып, жаңа қосылым жасаңыз және қажетті Merchant түрін таңдаңыз.

ПриватБанк: бизнеске арналған Приват24 арқылы үзінділерді баптау

ПриватБанк үшін Торгсофт «Автоклиент» интеграциясы / бизнеске арналған Приват24 API арқылы жұмыс істейді.

ПриватБанктің қазіргі интерфейсінде интеграция «Есеп және есептер» → «Интеграция (Автоклиент)» бөлімінде орналасқан. Онда API қосып, есеп жүргізу бағдарламасымен байланысу үшін қажетті деректерді алуға болады.

Приват24 жүйесінде не істеу керек?

1. Бизнеске арналған Приват24 жүйесіне қажетті кәсіпорын атынан кіріңіз.

2. «Автоклиент» интеграциясын ашыңыз.

3. API қосыңыз.

4. Торгсофт үшін интеграция жасаңыз.

5. Авторизация деректерін алыңыз. Автоклиент жүйесінде токендер мен идентификаторларды қарау бөліміне әр кірген сайын жаңа токендер жасалуы мүмкін. Сондықтан осы баптауларға әр кіргеннен кейін Торгсофт токендерді жаңарту қажет.

Егер Приват24 жүйесіне бірнеше ИП (Индивидуальный предприниматель) немесе заңды тұлға қосылған болса, интеграция жасамас бұрын қазіргі уақытта қай кәсіпорын таңдалғанын тексеріңіз. Әйтпесе қажетті емес шоттарға қол жеткізіп қоюыңыз мүмкін.

Торгсофт бағдарламасында нені көрсету керек?

Қосылым жасағанда Merchant түрі → ПриватБанк тармағын таңдап, мына өрістерді толтырыңыз:

• Карта нөмірі (шот) — толық IBAN;

• Клиент идентификаторы — интеграция ID-і;

• Шот атауы — өзіңізге түсінікті атау;

• Есеп айырысу шоты — Торгсофт жасалған тиісті шот;

• «Автоклиент» токені — Приват24 жүйесінде алынған токен.

IBAN интеграция жасалған Приват24 кәсіпорнына қолжетімді шоттардың біріне тиесілі болуы керек. 

ПриватБанк үзінділері кенеттен жүктелмей қалса

Алдымен мыналарды тексеріңіз:

1. IBAN дұрыс көрсетілген бе;

2. Приват24 жүйесіндегі интеграция жұмыс істеп тұр ма;

3. ID немесе токен өзгерген жоқ па;

4. Торгсофт өзекті нұсқасы орнатылған ба.

Жеке жағдайлардың бірі — мына хабарлама: No mapping for the Unicode character exists in the target multi-byte code page

2026 жылғы қыркүйекте мұндай жағдай ПриватБанк тарапындағы өзгерістен кейін туындады: банк кодтауды өңдеу тәртібін өзгертіп, сұрау түрін қатаңырақ тексере бастады. Торгсофт бағдарламасында API-мен жұмыс істеуге қатысты мәселе түзетілді. Сондықтан мұндай хабарлама шықса, шотты өзгерту немесе үзінді деректерін қолмен түзету қажет емес — алдымен Торгсофт соңғы нұсқасына жаңартыңыз.

monobank: жеке шот, ИП немесе заңды тұлға

Торгсофт бағдарламасында monobank үшін Merchant түрі → MonoBank тармағын таңдаңыз.

Содан кейін шот түрін анықтау қажет:

• Жеке шот/ИП;

• Заңды тұлғаның шоты.

Қосылу үшін MonoBankAPI токені пайдаланылады. Торгсофт анықтамасында оны алу үшін api.monobank.ua сайты көрсетілген: пайдаланушы QR-код арқылы авторизациядан өтіп, қол жеткізу токенін алады. 

ИП немесе жеке шот үшін

1. monobank токенін алыңыз.

2. Оны «MonoBankAPI токені» өрісіне енгізіңіз.

3. «Шоттарды жүктеу» түймесін басыңыз.

4. Қажетті шотты таңдаңыз.

5. Оны Торгсофт тиісті есеп айырысу шотымен байланыстырыңыз.

Заңды тұлға үшін

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

monobank үзіндіні қайтармаса

Мыналарды ретімен тексеріңіз:

• токен қажетті пайдаланушы тіркелгісі үшін алынған ба;

• шот түрі дұрыс таңдалған ба;

• операциялар бар шоттың дәл өзі таңдалған ба;

• ол Торгсофт есеп айырысу шотымен дұрыс байланыстырылған ба;

• таңдалған кезеңде monobank жүйесінің өзінде операциялар бар ма.

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

UKRSIBBANK: баптау неге өзгеше?

UKRSIBBANK қосылымын баптау күрделірек, өйткені банктің бизнес-кабинетіне қол жеткізуден бөлек, криптографиялық кілттер қажет.

Қарапайым тілмен айтқанда, кілттер банкке үзінді алу туралы сұраудың дәл Торгсофт рұқсат етілген қосылымынан келгенін растау үшін қажет.

1-қадам. OpenSSL орнатыңыз

UKRSIBBANK интеграциясы үшін Торгсофт анықтамасында OpenSSL бағдарламасының 32 биттік нұсқасы талап етіледі. Ол банкпен қорғалған деректер алмасуға арналған кілттерді жасау кезінде пайдаланылады. 

Торгсофт бағдарламасында Merchant түрі → УКРСИББАНК тармағын таңдағаннан кейін «Кілттерді жасау» әрекеті қолжетімді болады.

2-қадам. Жеке және ашық кілттерді жасаңыз

Торгсофт екі файл жасайды:

• жеке кілт кәсіпкерде қалады және интеграцияның жұмыс істеуі үшін пайдаланылады;

• ашық кілт UKRSIBBANK банкіне беріледі.

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

3-қадам. Банктен қажетті параметрлерді алыңыз

API қосу үшін ашық кілт UKRSIBBANK банкіне беріледі. Тіркеуден кейін банк Client_ID және Client_secret параметрлерін ұсынады.

Оларды IBAN шотымен бірге Торгсофт қосылымының тиісті өрістеріне енгізу қажет.

Client_secret, жеке кілт немесе оның құпиясөзін скриншоттарда және хат алмасуда жарияламаңыз.

4-қадам. UKRSIB business жүйесінде авторизациядан өтіңіз

Үзінді алу кезінде Торгсофт UKRSIB business авторизация бетін ашады. Жүйеге сәтті кіргеннен кейін бағдарлама банкпен жұмыс істеуге арналған токенді алады.

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

Үзінділер неге жүктелмейді: тексеру тәртібі

Себептерді кезекпен тексеру маңызды. Егер ПриватБанк жұмыс істеп, ал UKRSIBBANK жұмыс істемесе, алдымен UKRSIBBANK баптауларын тексеру қажет.

Бухгалтерге немесе менеджерге қалай рұқсат беруге болады?

Үзінділерге қол жеткізу рұқсатын әр пайдаланушы үшін бөлек баптауға болады.

Банк шоты үшін үш деңгей қарастырылған:

• Түсімдер — пайдаланушы кіріс операцияларын көреді;

• Шығыстар — шығыс операцияларын көреді;

• Толық қол жеткізу — шоттың барлық операцияларын көреді. 

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

Баптаудан кейін қосылымды қалай тексеруге болады?

Баптауды аяқтағаннан кейін бірден бірнеше айлық үзіндіні сұратудан бастамаңыз.

1. Банктің жеке кабинетіне кіріп, операциялар нақты болған күнді табыңыз.

2. Торгсофт бағдарламасында Төлем → Банк шоттарының үзінділері бөлімін ашыңыз.

3. Сол шотты таңдаңыз.

4. Қысқа кезеңді — бір немесе екі күнді белгілеңіз.

5. «Үзінділерді алу» түймесін басыңыз.

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

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

Техникалық қолдау қызметіне қашан жүгіну керек?

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

Айқын нәрселерді қайта тексеруге уақыт жоғалтпау үшін маманға мыналарды хабарлаңыз:

• банк атауын;

• Торгсофт нұсқасын;

• қандай шот түрі пайдаланылатынын;

• үзіндіні қай кезең үшін алып жатқаныңызды;

• хабарламаның нақты мәтінін;

• оның қай қадамда пайда болатынын.

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