API для интеграции платежей в Freedom Bank с системой ZERO.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"32850478","collectionId":"140ab776-4eec-4918-8241-da96e09259a5","publishedId":"2sBXqDtirY","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-20T07:35:11.000Z"},"item":[{"name":"Ведомость оплат","item":[{"name":"Ведомость оплат за день для сверки","id":"3823c1a3-8ef2-496a-8916-7f72d55bcd5a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"/cIRjvyU3PcU6ZiWa9EDIOPY5yhbSgTg/poxZ8hSgC4kAId00jonjWCadzbxzNdf9AaZVqPiBn6zwIMHIlyjpw=="}]},"isInherited":false},"method":"GET","header":[],"url":"https://cityschool.kz/api/services/app/FreedomBankPayments/GetDailyStatement?date=2026-06-03","urlObject":{"path":["api","services","app","FreedomBankPayments","GetDailyStatement"],"host":["https://cityschool.kz"],"query":[{"key":"date","value":"2026-06-03"}],"variable":[]}},"response":[{"id":"0fd28cb5-7b58-4d09-8296-688426d87f1b","name":"Ведомость оплат за день для сверки","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://cityschool.kz/api/services/app/FreedomBankPayments/GetDailyStatement?date=2026-06-03","host":["https://cityschool.kz"],"path":["api","services","app","FreedomBankPayments","GetDailyStatement"],"query":[{"key":"date","value":"2026-06-03","description":"Дата ведомости, то есть за какой день получить ведомость. Опциональный параметр, по умолчанию вчерашняя дата."}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":":status","value":200},{"key":"content-length","value":"400"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"server","value":"Microsoft-IIS/10.0"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-robots-tag","value":"noindex, nofollow"},{"key":"date","value":"Fri, 05 Jun 2026 04:23:53 GMT"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"[\n {\n \"date\": \"03.06.2026\", // Дата ведомости, то есть за какой день эта ведомость\n \"kodbn\": \"KCJBKZKX\", // БИК расчётного счёта обр.учреждения\n \"numrs\": \"KZ118562203112448288\", // ИИК - банковский счет обр.учреждения 20 значный\n \"organization_bin\": \"950103350797\", // БИН обр.учреждения\n \"sump\": 10000, // Общая сумма по обр.учреждения\n \"namepol\": \"Товарищество с ограниченной ответственностью \\\"Ақбұлақ 1 - Астана\\\"\", // Наименование обр.учреждения\n \"naznpl\": \"Платеж за образовательные услуги\", // Назначение платежа\n \"kbe\": \"222\", // КБЕ\n \"knp\": \"861\", // КНП\n \"payments\": [ // Массив платежей по этому обр.учереждению\n {\n \"txn_id\": \"888\", // Уникальный ID транзакции\n \"sum\": 10000 // Сумма оплаты\n }\n ]\n }\n]"}],"_postman_id":"3823c1a3-8ef2-496a-8916-7f72d55bcd5a"},{"name":"Приём результата сверки от Freedom банка.","id":"76d2cb23-37a2-4c55-94fd-2bc0ff944894","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"/cIRjvyU3PcU6ZiWa9EDIOPY5yhbSgTg/poxZ8hSgC4kAId00jonjWCadzbxzNdf9AaZVqPiBn6zwIMHIlyjpw=="}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"date\": \"03.06.2026\",\r\n \"total_sum_status\": \"mismatch\",\r\n \"total_sum_expected\": 20000.00,\r\n \"total_sum_received\": 10000.00,\r\n \"organization_bin\": \"950103350797\",\r\n \"payments\": [\r\n {\r\n \"txn_id\": \"888\", \r\n \"status\": \"mismatch\",\r\n \"sum_expected\": 20000,\r\n \"sum_received\": 10000\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cityschool.kz/api/services/app/FreedomBankPayments/SeedReconciliationResult","urlObject":{"path":["api","services","app","FreedomBankPayments","SeedReconciliationResult"],"host":["https://cityschool.kz"],"query":[],"variable":[]}},"response":[{"id":"4c0b58ba-b33d-4993-bc0e-fcb2353f9542","name":"Приём результата сверки от Freedom банка.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"date\": \"05.02.2026\", // Дата ведомости, то есть за какой день эта ведомость\r\n \"total_sum_status\": \"mismatch\", // Общий статус. ЕСЛИ все суммы сходятся - success, если хоть одна не сходится - mismatch\r\n \"total_sum_expected\": 20000.00, // Общая ожидаемая сумма в Freedom Bank\r\n \"total_sum_received\": 10000.00, // Общая сумма полученная от ZERO в ведомости\r\n \"organization_bin\": \"950103350797\", // БИН организации\r\n \"payments\": [\r\n {\r\n \"txn_id\": \"888\", \r\n \"status\": \"mismatch\",\r\n \"sum_expected\": 20000, // Сумма которая записана в Freedom Bank\r\n \"sum_received\": 10000 // Сумма которая записана в ведомости от ZERO\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cityschool.kz/api/services/app/FreedomBankPayments/SeedReconciliationResult"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":":status","value":200},{"key":"content-length","value":"27"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"server","value":"Microsoft-IIS/10.0"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-robots-tag","value":"noindex, nofollow"},{"key":"date","value":"Fri, 05 Jun 2026 04:24:10 GMT"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"result\": 0,\n \"comment\": \"OK\"\n}"}],"_postman_id":"76d2cb23-37a2-4c55-94fd-2bc0ff944894"}],"id":"1cda5ccf-e0f7-44c4-b7ca-52962756cd28","_postman_id":"1cda5ccf-e0f7-44c4-b7ca-52962756cd28","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"140ab776-4eec-4918-8241-da96e09259a5","id":"140ab776-4eec-4918-8241-da96e09259a5","name":"ZERO - Freedom Bank Payments API","type":"collection"}}},{"name":"Freedom Bank совершение оплаты","item":[{"name":"1. Проверка возможности оплаты","id":"50d1d097-d0f5-4e2e-9582-3d37e8c93f25","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"/cIRjvyU3PcU6ZiWa9EDIOPY5yhbSgTg/poxZ8hSgC4kAId00jonjWCadzbxzNdf9AaZVqPiBn6zwIMHIlyjpw=="}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://cityschool.kz/api/services/app/FreedomBankPayments/ProcessTotalPayment?txn_id=1234567&account=","urlObject":{"path":["api","services","app","FreedomBankPayments","ProcessTotalPayment"],"host":["https://cityschool.kz"],"query":[{"description":{"content":"Уникальный идентификатор транзакции в системе партнёра/платёжного шлюза.
\n","type":"text/plain"},"key":"txn_id","value":"1234567"},{"description":{"content":"Идентификатор внутреннего аккаунта клиента.
\n","type":"text/plain"},"key":"account","value":""},{"disabled":true,"description":{"content":"Опциональная сумма переданная с POS терминала (не учитывается).
\n","type":"text/plain"},"key":"sum","value":"200.00"}],"variable":[]}},"response":[{"id":"4b3f2629-5ef1-49d1-8a74-349f32e4dbbd","name":"Пример успешного ответа на запрос","originalRequest":{"method":"GET","header":[{"key":"Abp-TenantId","value":"2","type":"text","disabled":true}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://cityschool.kz/api/services/app/FreedomBankPayments/ProcessTotalPayment?txn_id=1234567&account=","host":["https://cityschool.kz"],"path":["api","services","app","FreedomBankPayments","ProcessTotalPayment"],"query":[{"key":"txn_id","value":"1234567","description":"Уникальный идентификатор транзакции в системе партнёра/платёжного шлюза. "},{"key":"account","value":"","description":"Идентификатор внутреннего аккаунта клиента."},{"key":"sum","value":"200.00","description":"Опциональная сумма переданная с POS терминала (не учитывается).","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":":status","value":200},{"key":"content-length","value":"615"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"server","value":"Microsoft-IIS/10.0"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-robots-tag","value":"noindex, nofollow"},{"key":"date","value":"Tue, 09 Jun 2026 06:06:25 GMT"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n // Идентификатор транзакции из запроса\n \"txn_Id\": \"1234567\",\n\n // Код результата:\n // 0 - успешно\n // != 0 - ошибка\n \"result\": 0,\n\n // Человекочитаемый комментарий по результату проверки\n \"comment\": \"Плательщик найден: Аманова Аружан\",\n\n // ИИН/БИН клиента\n \"bin\": \"860910302854\",\n\n // Общая сумма к оплате / задолженность\n \"sum\": 2050000.0,\n\n // Дополнительные поля для отображения\n \"fields\": {\n\n // Первое дополнительное поле\n \"field1\": {\n\n // Системное название поля\n \"name\": \"childName\",\n\n // Значение поля\n \"text\": \"Аманова Аружан\"\n },\n\n // Второе дополнительное поле\n \"field2\": {\n\n // Системное название поля\n \"name\": \"class\",\n\n // Значение поля\n \"text\": \"Akbulak Premium\"\n }\n },\n\n // Список платежей на оплату\n \"payments\": [\n {\n \"id\": 139, // ID платежа\n \"name\": \"Оқу ақысы 832-2-podpishi (2026-2027)|Оплата за обучение 832-2-podpishi (2026-2027)\", // Наименование платежа\n \"sum\": 1950000 // Сумма платежа\n },\n {\n \"id\": 138,\n \"name\": \"Кіру ақысы 832-2-podpishi (2026-2027)|Вступительный взнос 832-2-podpishi (2026-2027)\",\n \"sum\": 100000\n }\n ]\n}"}],"_postman_id":"50d1d097-d0f5-4e2e-9582-3d37e8c93f25"},{"name":"2. Проведение оплаты","id":"7c2323d0-be21-4565-9298-d60e67614dc6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"/cIRjvyU3PcU6ZiWa9EDIOPY5yhbSgTg/poxZ8hSgC4kAId00jonjWCadzbxzNdf9AaZVqPiBn6zwIMHIlyjpw=="}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"txn_id\": \"12165445147001\",\r\n \"account\": \"\",\r\n \"txn_date\": \"2026-04-23T10:30:00\",\r\n \"payments\": [\r\n {\r\n \"id\": \"138\",\r\n \"sum\": \"14500\"\r\n },\r\n {\r\n \"id\": \"139\",\r\n \"sum\": \"14500\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cityschool.kz/api/services/app/FreedomBankPayments/ProcessTotalPayment","urlObject":{"path":["api","services","app","FreedomBankPayments","ProcessTotalPayment"],"host":["https://cityschool.kz"],"query":[],"variable":[]}},"response":[{"id":"12d57304-ebe0-4da3-b8e8-4287352f31ad","name":"Проведение оплаты","originalRequest":{"method":"POST","header":[{"key":"Abp-TenantId","value":"4","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"txn_id\": \"12165445147001\", // Уникальный ID транзакции\r\n \"account\": \"\", // Идентификатор внутреннего аккаунта клиента.\r\n \"txn_date\": \"2026-04-23T10:30:00\", // Дата оплаты\r\n \"payments\": [\r\n {\r\n \"id\": \"138\", // ID платежа с GET запроса /ProcessTotalPayment\r\n \"sum\": \"14500.00\" // Оплачиваемая сумма за платёж\r\n },\r\n {\r\n \"id\": \"139\", // ID платежа с GET запроса /ProcessTotalPayment\r\n \"sum\": \"14500.00\" // Оплачиваемая сумма за платёж\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cityschool.kz/api/services/app/FreedomBankPayments/ProcessTotalPayment"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":":status","value":200},{"key":"content-length","value":"163"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"server","value":"Microsoft-IIS/10.0"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-robots-tag","value":"noindex, nofollow"},{"key":"date","value":"Tue, 09 Jun 2026 06:11:16 GMT"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n // Уникальный идентификатор текущей транзакции\n \"txn_id\": \"12165445147824\",\n\n // Внутренний идентификатор платежа в системе поставщика услуг\n // Обычно формируется из account + txn_id\n \"prv_txn_id\": \"4-338-12165445147824\",\n\n // Код результата операции:\n // 0 - успешно\n // != 0 - ошибка\n \"result\": 0,\n\n // Сумма успешно принятого платежа\n \"sum\": \"29000.00\",\n\n // ИИН/БИН плательщика\n \"bin\": \"860910302854\",\n\n // Текстовое описание результата операции\n \"comment\": \"Оплата принята успешно\"\n}"}],"_postman_id":"7c2323d0-be21-4565-9298-d60e67614dc6"}],"id":"e3475139-fc71-450f-a18a-1574bb2cc949","_postman_id":"e3475139-fc71-450f-a18a-1574bb2cc949","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"140ab776-4eec-4918-8241-da96e09259a5","id":"140ab776-4eec-4918-8241-da96e09259a5","name":"ZERO - Freedom Bank Payments API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]}},"event":[{"listen":"prerequest","script":{"id":"38cabcb6-ad1f-4a70-b298-dad3909b010f","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"589a9e90-c106-4c2c-aa89-2a5e4134a3a2","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://cityschool.kz"},{"key":"bearerToken","value":"/cIRjvyU3PcU6ZiWa9EDIOPY5yhbSgTg/poxZ8hSgC4kAId00jonjWCadzbxzNdf9AaZVqPiBn6zwIMHIlyjpw=="},{"key":"account","value":""}]}