SAFIR API · RESTRESTSAFIR API · REST

SAFIR API — встройте страхование в вашу системуSAFIR API — embed insurance into your system

Выпускайте Takaful-полисы, получайте вебхуки по медицинским событиям и инициируйте клеймы — напрямую из вашей CRM, системы бронирования или кабинета страховщика.Issue Takaful policies, receive webhooks on medical events and initiate claims — directly from your CRM, booking system or insurer cabinet.

Запросить API-ключ →Request API key → ДокументацияDocumentation

ВозможностиCapabilities

Три ключевых вызова APIThree core API calls

SAFIR API закрывает полный жизненный цикл защиты паломника — от выпуска полиса до выплаты по клейму.The SAFIR API covers the full lifecycle of pilgrim protection — from policy issuance to claim payout.

Выпуск полисовPolicy issuance

Создавайте цифровой TakafulTakaful-полис для паломника одним POST-запросом. В ответ — номер полиса, QR и ссылка на медкарту.Create a digital TakafulTakaful policy for a pilgrim with a single POST request. The response returns a policy number, QR and medical-card link.

Вебхуки по медсобытиямMedical-event webhooks

Получайте события в реальном времени: госпитализация, авторизация клиники, смена статуса. Подпись запроса и повтор доставки.Receive real-time events: hospitalization, clinic authorization, status change. Request signing and delivery retries.

Инициация клеймаClaim initiation

Открывайте клейм из своей системы с ICDICD-кодом и документами. Дальнейший ассистанс и клиринг берёт на себя SAFIR.Open a claim from your system with an ICDICD code and documents. SAFIR handles the assistance and clearing that follow.

Краткая документацияQuick reference

Пример: выпуск полисаExample: issue a policy

Аутентификация — по токену BearerBearer. Базовый URL и тестовый ключ вы получаете при подключении.Authentication uses a BearerBearer token. The base URL and a test key are provided on connection.

# Запрос: выпустить Takaful-полис для паломникаRequest: issue a Takaful policy for a pilgrim POST /v1/policies Host: api.safir.ikshar.ru Authorization: Bearer sk_live_8f2a…c91 Content-Type: application/json { "group_id": "grp_5XK29", "pilgrim": { "full_name": "Aigerim Toktarova", "passport": "N12345678", "birth_date": "1979-03-12" }, "coverage": "umrah_standard", "valid_from": "2026-07-01" } # Ответ 201 CreatedResponse 201 Created { "policy_id": "pol_Qh7Z1A", "status": "active", "issuer": "ALMA Insurance", "product": "Takaful", "qr_url": "https://safir.ikshar.ru/p/Qh7Z1A", "medical_card_url": "https://safir.ikshar.ru/m/Qh7Z1A" }

Полис TakafulTakaful выпускает лицензированный партнёр ALMA Insurance. Поля и значения в примере приведены для иллюстрации.The TakafulTakaful policy is issued by licensed partner ALMA Insurance. Fields and values shown are illustrative.

Интеграция KSAKSA integration

Connect Umrah · External Agents — через APIConnect Umrah · External Agents — via API

Сценарий внешнего агента Connect UmrahConnect Umrah предусматривает обмен данными паломников и полисов через API. SAFIR проектирует интеграцию так, чтобы выпуск полиса и медкарта были привязаны к записи паломника на стороне оператора.The Connect UmrahConnect Umrah External Agents scenario provides for exchanging pilgrim and policy data via API. SAFIR designs the integration so that policy issuance and the medical card are linked to the pilgrim record on the operator side.

Привязка полиса к записи паломника и группеPolicy linked to the pilgrim record and group Вебхуки по статусам медицинских событийWebhooks on medical-event statuses Готовность к требованиям внешнего агента Connect UmrahConnect UmrahReadiness for Connect UmrahConnect Umrah External Agent requirements

Обсудить партнёрствоDiscuss partnership

Совместимость с Connect UmrahConnect Umrah и Nusuk Masar находится на этапе соответствия и в активной дорожной карте — это не подтверждённая сертификация.Compatibility with Connect UmrahConnect Umrah and Nusuk Masar is in the compliance stage and on our active roadmap — this is not a confirmed certification.

Запросите доступ к SAFIR APIRequest access to the SAFIR API

Получите тестовый ключ, базовый URL и документацию — и встройте выпуск полисов и клеймы в вашу систему.Get a test key, base URL and documentation — and embed policy issuance and claims into your system.

Запросить API-ключ →Request API key → Подключить компаниюConnect company