API для интеграции платежей в Freedom Bank с системой ZERO.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"32850478","collectionId":"f7f818d5-85bd-4a4c-8e88-83b35569efef","publishedId":"2sBXwtqUx3","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-06-17T09:27:33.000Z"},"item":[{"name":"Ведомость оплат","item":[{"name":"Ведомость оплат за день для сверки","id":"91c54a1f-917a-4f72-93be-c116e424eadf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Z9/qE9tbAC9dMu7TPrhlHXBfT+dARiivS4/irclb3tbs/UwXu7wnyBgBLXVRtcdl94DRMhxmqs+1glws/6dUAQ=="}]},"isInherited":false},"method":"GET","header":[],"url":"https://linked.kz/api/services/app/FreedomBankPayments/GetDailyStatement?date=2026-06-17","urlObject":{"path":["api","services","app","FreedomBankPayments","GetDailyStatement"],"host":["https://linked.kz"],"query":[{"key":"date","value":"2026-06-17"}],"variable":[]}},"response":[{"id":"6723156b-6f4e-4e42-bf09-28fd1f2f3717","name":"Ведомость оплат за день для сверки","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://linked.kz/api/services/app/FreedomBankPayments/GetDailyStatement?date=2026-06-03","host":["https://linked.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":"91c54a1f-917a-4f72-93be-c116e424eadf"},{"name":"Приём результата сверки от Freedom банка.","id":"de123d2a-65eb-4c2b-a796-e26b1b600ead","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Z9/qE9tbAC9dMu7TPrhlHXBfT+dARiivS4/irclb3tbs/UwXu7wnyBgBLXVRtcdl94DRMhxmqs+1glws/6dUAQ=="}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"date\": \"17.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://linked.kz/api/services/app/FreedomBankPayments/SeedReconciliationResult","urlObject":{"path":["api","services","app","FreedomBankPayments","SeedReconciliationResult"],"host":["https://linked.kz"],"query":[],"variable":[]}},"response":[{"id":"49f6f7b0-e5ba-4504-be90-097c2baff840","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://linked.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":"de123d2a-65eb-4c2b-a796-e26b1b600ead"}],"id":"cdf63a8c-27b4-4af6-86ea-537f8d32b5d7","_postman_id":"cdf63a8c-27b4-4af6-86ea-537f8d32b5d7","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"f7f818d5-85bd-4a4c-8e88-83b35569efef","id":"f7f818d5-85bd-4a4c-8e88-83b35569efef","name":"ZERO - Freedom Bank Subservice","type":"collection"}}},{"name":"Freedom Bank совершение оплаты","item":[{"name":"1. Проверка возможности оплаты","id":"f29abccf-6919-4f97-bc2e-1878c0143017","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Z9/qE9tbAC9dMu7TPrhlHXBfT+dARiivS4/irclb3tbs/UwXu7wnyBgBLXVRtcdl94DRMhxmqs+1glws/6dUAQ=="}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://linked.kz/api/services/app/FreedomBankPayments/ProcessTotalPayment?txn_id=1234567&account=4-338","urlObject":{"path":["api","services","app","FreedomBankPayments","ProcessTotalPayment"],"host":["https://linked.kz"],"query":[{"description":{"content":"Уникальный идентификатор транзакции в системе партнёра/платёжного шлюза.
\n","type":"text/plain"},"key":"txn_id","value":"1234567"},{"description":{"content":"Идентификатор внутреннего аккаунта клиента.
\n","type":"text/plain"},"key":"account","value":"4-338"},{"disabled":true,"description":{"content":"Опциональная сумма переданная с POS терминала (не учитывается).
\n","type":"text/plain"},"key":"sum","value":"200.00"}],"variable":[]}},"response":[{"id":"609d9752-3ff0-455a-a51f-a7d2b81a3a55","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://linked.kz/api/services/app/FreedomBankPayments/ProcessTotalPayment?txn_id=1234567&account=4-338","host":["https://linked.kz"],"path":["api","services","app","FreedomBankPayments","ProcessTotalPayment"],"query":[{"key":"txn_id","value":"1234567","description":"Уникальный идентификатор транзакции в системе партнёра/платёжного шлюза. "},{"key":"account","value":"4-338","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":"f29abccf-6919-4f97-bc2e-1878c0143017"},{"name":"2. Проведение оплаты","id":"4560551c-7f1b-45a3-9970-54bc5285754f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Z9/qE9tbAC9dMu7TPrhlHXBfT+dARiivS4/irclb3tbs/UwXu7wnyBgBLXVRtcdl94DRMhxmqs+1glws/6dUAQ=="}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"txn_id\": \"12165445147001\",\r\n \"account\": \"4-338\",\r\n \"txn_date\": \"2026-06-17T10:30:00\",\r\n \"payments\": [\r\n {\r\n \"id\": \"77\",\r\n \"sum\": \"100\"\r\n },\r\n {\r\n \"id\": \"78\",\r\n \"sum\": \"10\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://linked.kz/api/services/app/FreedomBankPayments/ProcessTotalPayment","urlObject":{"path":["api","services","app","FreedomBankPayments","ProcessTotalPayment"],"host":["https://linked.kz"],"query":[],"variable":[]}},"response":[{"id":"34916017-009e-4ecd-9230-07cbe3f7cece","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\": \"4-338\", // Идентификатор внутреннего аккаунта клиента.\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://linked.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":"4560551c-7f1b-45a3-9970-54bc5285754f"}],"id":"e594df0e-93bd-4953-a1b1-88f384cde992","_postman_id":"e594df0e-93bd-4953-a1b1-88f384cde992","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":true,"source":{"_postman_id":"f7f818d5-85bd-4a4c-8e88-83b35569efef","id":"f7f818d5-85bd-4a4c-8e88-83b35569efef","name":"ZERO - Freedom Bank Subservice","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]}},"event":[{"listen":"prerequest","script":{"id":"11573957-8f67-452d-9a90-01f6bd6dddf8","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"8aa4851b-551f-4b0e-98b8-153ef3b4113c","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://linked.kz"},{"key":"bearerToken","value":"Z9/qE9tbAC9dMu7TPrhlHXBfT+dARiivS4/irclb3tbs/UwXu7wnyBgBLXVRtcdl94DRMhxmqs+1glws/6dUAQ=="},{"key":"account","value":"4-338"}]}