Начало работы

Введение

Эта документация поможет вам интегрировать платёжную систему Finik в ваше приложение, чтобы ваши клиенты могли легко оплачивать ваши услуги через любое финансовое приложение Кыргызстана.

В первую очередь вы будете работать с Finik Web SDK — платёжным провайдером для вашего приложения.

Интеграция с Finik Web SDK состоит из следующих шагов:

Сгенерируйте пару ключей RSA — приватный и публичный. Они нужны для первого этапа авторизации.
Получите корпоративный счёт:
- Предпринимателям — создайте счёт в мобильном приложении Finik (инструкция).
- Организациям — получите счёт у представителей Finik.
Создайте API-ключ типа WEB в личном кабинете Finik, загрузив ваш публичный ключ (инструкция).
Настройте подпись запросов — второй этап авторизации: каждый запрос подписывается приватным ключом.
Создавайте платежи — отправляйте подписанные запросы в Finik Web SDK и получайте ссылку на оплату.
Обрабатывайте webhook — принимайте уведомления о статусе платежа и проверяйте их подпись.

Ниже каждый шаг разобран подробно.

Настройка аккаунта

Скачайте приложение Finik

Зарегистрируйтесь и пройдите онлайн-идентификацию прямо в приложении. Если вы иностранный гражданин — поможем пройти идентификацию офлайн в нашем офисе.
Генерация ключей

Сгенерируйте приватный и публичный ключи RSA — они нужны для авторизации в Finik Web SDK. Смотрите раздел «Генерация ключей» этой документации.
Сгенерируйте API-ключи в личном кабинете
- Войдите в личный кабинет
- Откройте раздел «Ключи» в левом меню
- Нажмите «Сгенерировать ключ» и заполните форму:
  - Пользователь — выберите себя
  - Название клиента — ваше юридическое наименование и бренд, например ИП Асан Асанов (Mancho)
  - Тип клиента — выберите Веб-клиент
  - Публичный ключ — загрузите файл finik_public.pem, сгенерированный на шаге 2
  - QuickPay ключ, QuickPay ID, Callback URL — необязательные поля, пропустите
- Нажмите «Создать» — ваши ключи появятся в разделе «Ключи»
Реализуйте техническую интеграцию

Следуйте шагам ниже — подпись запросов, создание платежа, обработка webhook.

Как это работает

Полный платёжный поток от начала до подтверждения.

Посмотрите демонстрацию платёжного процесса на практике.