API для интеграции платежей в Freedom Bank с системой ZERO.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"32850478","collectionId":"e001eb37-b741-46eb-b969-fa96a0eadf9a","publishedId":"2sA3kdAHe8","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-14T11:19:13.000Z"},"item":[{"name":"Авторизация","item":[{"name":"Получение токена авторизации","id":"60c5fe51-d229-4e75-8f4c-4ac1be8f405f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"userNameOrEmailAddress\": \"\", // Имя пользователя или Email адрес в ZERO\r\n \"password\": \"\" // Пароль в ZERO\r\n}"},"url":"https://test.linked.kz/api/TokenAuth/Authenticate","description":"Получение Bearer токена для авторизации в ZERO. Этот токен затем необходимо приложить к запросу для получения платежей клиента и на отправку в ZERO произведённых клиентом оплат.
\n","urlObject":{"path":["api","TokenAuth","Authenticate"],"host":["https://test.linked.kz"],"query":[],"variable":[]}},"response":[{"id":"1be6d12b-46bc-434e-9147-afdd0f7fbb83","name":"Успешная авторизация","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"userNameOrEmailAddress\": \"\",\r\n \"password\": \"\"\r\n}"},"url":"https://test.linked.kz/api/TokenAuth/Authenticate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"3133"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"Request-Context","value":"appId=cid-v1:b440d97c-8ba2-4fef-a68a-1ff4b1eebd65"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Date","value":"Thu, 06 Jun 2024 05:47:18 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true, // Авторизация прошла успешно\n \"result\": {\n \"accessToken\": \"\" // Bearer токен для авторизации в ZERO\n }\n}"},{"id":"af518212-1efd-4c1c-9da0-c06ca8726c70","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"text/plain"}],"body":{"mode":"raw","raw":"{\r\n \"userNameOrEmailAddress\": \"\", // Имя пользователя или Email адрес в ZERO\r\n \"password\": \"\" // Пароль в ZERO\r\n}","options":{"raw":{"language":"text"}}},"url":"https://test.linked.kz/api/TokenAuth/Authenticate"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"188"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"Request-Context","value":"appId=cid-v1:b440d97c-8ba2-4fef-a68a-1ff4b1eebd65"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Date","value":"Thu, 06 Jun 2024 06:35:40 GMT"}],"cookie":[],"responseTime":null,"body":"{ \n \"success\": false, // Авторизация провалилась\n \"error\": {\n \"code\": 0,\n \"message\": \"Invalid user name or password\",\n \"details\": null,\n \"validationErrors\": null\n } \n}"}],"_postman_id":"60c5fe51-d229-4e75-8f4c-4ac1be8f405f"}],"id":"b8ec10fc-492a-4499-9607-b6784d2a5c1b","description":"Авторизация в ZERO.
\n","_postman_id":"b8ec10fc-492a-4499-9607-b6784d2a5c1b"},{"name":"Операции с платежами","item":[{"name":"Получение платежей ожидающих оплату по ИИН ученика","id":"b9c47c6a-9014-43c4-9a65-f2c785fe8650","protocolProfileBehavior":{"disabledSystemHeaders":{},"strictSSL":false,"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Этот метод возвращает платежи ожидающие оплату по ИИН ученика.
\nMethod: GET
\nEndpoint: https://test.linked.kz/api/services/app/FreedomBankPayments/GetPaymentForFreedomBank
Query Parameters:
\nИИН ученика
\n","type":"text/plain"},"key":"iin","value":"161124502880"}],"variable":[]}},"response":[{"id":"f2ecb059-aaa1-4a3f-b87a-ee954fc1e98e","name":"ИИН найден","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://test.linked.kz/api/services/app/FreedomBankPayments/GetPaymentForFreedomBank?iin=161124502880","host":["https://test.linked.kz"],"path":["api","services","app","FreedomBankPayments","GetPaymentForFreedomBank"],"query":[{"key":"iin","value":"161124502880","description":"ИИН ученика"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"792"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"Request-Context","value":"appId=cid-v1:b440d97c-8ba2-4fef-a68a-1ff4b1eebd65"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Date","value":"Thu, 06 Jun 2024 10:32:19 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"fullName\": \"Мұхарбек Аян Дәуренұлы\", // Полное имя ученика\n \"iin\": \"161124502880\", // ИИН ученика\n \"class\": \"3А\", // ИИН ученика\n \"freedomBankPayments\": [ // Массив данных о платежах, ожидающих оплату\n {\n \"name\": \"Оқу ақысы (2024-2025)|Оплата за обучение (2024-2025)\", // Наименование платежа\n \"sum\": 550000, // Сумма платежа\n \"id\": 2024202500 // Идентификатор платежа в ZERO\n },\n {\n \"name\": \"Оқу ақысы (2023-2024)|Оплата за обучение (2023-2024)\", // Наименование платежа\n \"sum\": 2335000, // Сумма платежа\n \"id\": 2023202400 // Идентификатор платежа в ZERO\n },\n {\n \"name\": \"Өсім (2023-2024)|Пеня (2023-2024)\", // Наименование платежа\n \"sum\": 67690, // Сумма платежа\n \"id\": 2023202405 // Идентификатор платежа в ZERO\n },\n {\n \"name\": \"Өсім (2024-2025)|Пеня (2024-2025)\", // Наименование платежа\n \"sum\": 11550, // Сумма платежа\n \"id\": 2024202505 // Идентификатор платежа в ZERO\n },\n {\n \"name\": \"Шеңбер үшін төлем: |Оплата за кружок: Шахматы\", // Наименование платежа\n \"sum\": 34500, // Сумма платежа\n \"id\": 25 // Идентификатор платежа в ZERO\n },\n {\n \"name\": \"Шеңбер үшін төлем: |Оплата за кружок: Шахматы\", // Наименование платежа\n \"sum\": 7875, // Сумма платежа\n \"id\": 15 // Идентификатор платежа в ZERO\n }\n ],\n \"result\": 0, // ИИН найден\n \"comment\": \"ИИН найден\" // Комментарий о выполнении запроса\n}"},{"id":"8f3be17b-ee45-40e7-8924-8cd0c406b8a4","name":"ИИН не найден","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{authToken}}","description":"Заголовок для авторизации по Bearer токену"}],"url":{"raw":"https://test.linked.kz/api/services/app/FreedomBankPayments/GetPaymentForFreedomBank?iin=161124502880","host":["https://test.linked.kz"],"path":["api","services","app","FreedomBankPayments","GetPaymentForFreedomBank"],"query":[{"key":"iin","value":"161124502880","description":"ИИН ученика"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"112"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"Request-Context","value":"appId=cid-v1:b440d97c-8ba2-4fef-a68a-1ff4b1eebd65"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Date","value":"Thu, 06 Jun 2024 06:36:51 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": 1, // ИИН не найден\n \"comment\": \"ИИН не найден\" // Комментарий о выполнении запроса\n}"},{"id":"9e5e03aa-7227-4db7-bac1-d31cabff844b","name":"Внутренная ошибка ZERO","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{authToken}}","description":"Заголовок для авторизации по Bearer токену"}],"url":"https://test.linked.kz/api/services/app/FreedomBankPayments/GetPaymentForFreedomBank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"112"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"Request-Context","value":"appId=cid-v1:b440d97c-8ba2-4fef-a68a-1ff4b1eebd65"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Date","value":"Thu, 06 Jun 2024 06:36:51 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": 5, // Внутренняя ошибка ZERO\n \"comment\": \"Другая ошибка провайдера\" // Комментарий о выполнении запроса\n}"}],"_postman_id":"b9c47c6a-9014-43c4-9a65-f2c785fe8650"},{"name":"Отправить в ZERO произведённые клиентом оплаты","id":"0f5be4cf-835c-4670-84aa-1c4d53318785","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Метод для сохранения в ZERO оплат произведённых клиентом через Freedom Bank.
\niin (string): ИИН ученика
payId (number): Идентификатор оплаты в сервисе Freedom Bank
freedomBankReceipts
(array): Массив чеков об оплатах, произведённых клиентом
\nid (number): Идентификатор платежа в ZERO
sum (number): Сумма оплаты
Получение платежей клиента ожидающих оплату и отправка в ZERO информации об оплаченных клиентом платежей.
\n","_postman_id":"2292c9a8-0b48-4510-9868-b55beb823196"}],"event":[{"listen":"prerequest","script":{"id":"d69a6944-900f-42e8-9eea-ab2dfc979f2d","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"14ccdf76-ccc0-45de-be10-646a2e65255a","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://test.linked.kz","type":"string"},{"key":"childIin","value":"161124502880","type":"string"}]}