Справочник

Эндпоинты и ошибки

Эндпоинты

Среда	URL
`Бета`	https://beta.api.acquiring.averspay.kg/v1/payment
`Прод`	https://api.acquiring.averspay.kg/v1/payment

Распространённые ошибки

Статус	Значение
`400`	Некорректный запрос — например, недействительная/отсутствующая метка времени или Amount ≤ 0.
`401`	Недействительная подпись.
`403`	Запрещено.

400 Bad Request

{ "statusCode": 400, "ErrorMessage": "A valid UNIX timestamp must be provided in the header" }
{ "statusCode": 400, "ErrorMessage": "An invalid amount is provided. Amount must be greater than 0." }

401 Unauthorized

{ "statusCode": 401, "ErrorMessage": "An invalid signature is provided" }

403 Forbidden

{ "statusCode": 403, "ErrorMessage": "Forbidden" }

Публичные ключи

Используйте публичный ключ, соответствующий вашей среде, для проверки подписей webhook.

Прод — public-key.pem

Бета — public-key.pem

Часто задаваемые вопросы

Как начать интеграцию с Finik Web SDK?

Изучите эту документацию: сгенерируйте RSA-ключи (раздел «Генерация ключей»), затем создайте API-ключ в личном кабинете Finik. Для предпринимателей — всё через приложение и личный кабинет. Для организаций — обратитесь к представителям Finik, они помогут на каждом шаге.

Как получить API-ключи для Web SDK?

Сначала сгенерируйте RSA-ключи командами openssl (см. раздел «Генерация ключей»). Затем войдите в личный кабинет Finik, откройте раздел «Ключи» и нажмите «Сгенерировать ключ» — укажите публичный ключ и тип WEB. Готово: вы получите x-api-key для интеграции.

В чём разница между тестовой (beta) и боевой (production) средой для Web SDK?

Тестовая среда (beta) используется для отладки интеграции — вы можете создавать платежи без реального списания денег. Боевая среда (production) работает с реальными средствами. Для каждой среды выдаются отдельные API-ключи: бета — https://beta.api.acquiring.averspay.kg/v1/payment, прод — https://api.acquiring.averspay.kg/v1/payment.

Данная ошибка обычно возникает из-за некорректного API-ключа.

Проверьте следующее:

Используется ли API-ключ для соответствующей среды (beta или production). Частая причина — использование beta API-ключа в production-среде или наоборот. Корректно ли скопирован API-ключ. При копировании могут быть случайно пропущены несколько символов в начале или конце ключа. Убедитесь, что используется актуальный и действующий API-ключ.

В большинстве случаев ошибка связана с использованием неверного API-ключа или его некорректным копированием.

Что такое Callback URL и как его настроить для Web SDK?

Callback URL — это адрес вашего сервера, на который мы отправляем POST-уведомления о статусе платежа (успех/ошибка). Это опционально, но рекомендуется для автоматизации. Вы можете указать его при отправке публичного ключа или добавить позже через личный кабинет. Формат уведомления описан в документации.

Почему запросы на мой Callback URL не приходят?

Проверьте, что ваш сервер доступен извне, поддерживает HTTPS и принимает POST-запросы. Также убедитесь, что вы правильно указали Callback URL в настройках (без ошибок в домене). Если всё корректно — проверьте логи вашего сервера и обратитесь к нам для проверки доставки уведомлений.

Можно ли использовать один и тот же публичный ключ для нескольких мерчантов?

Нет, каждый мерчант должен иметь свой уникальный публичный ключ. Для каждого юридического лица или ИП генерируется отдельная пара ключей. Это требование безопасности.

Нужно ли пополнять баланс для тестирования в beta-среде?

Нет, в beta-среде пополнение не требуется, так как платежи не списывают реальные средства. Однако если вы используете production-среду для тестов, вам необходимо пополнить счёт, так как списываются реальные деньги (комиссия за транзакции).

Какие данные необходимо передавать при создании платежа через Web SDK?

Обязательные поля: CardType (всегда FINIK_QR), PaymentId (уникальный UUID), RedirectUrl, объект Data с полями accountId, name_en и webhookUrl. Поле Amount опционально — если не указать, клиент вводит сумму сам. Подробности — в разделе «Тело запроса».

Как понять, что интеграция работает корректно?

Проведите тестовый платёж на минимальную сумму (например, 0.01 сома) в beta-среде. Если вы получаете успешный ответ и видите транзакцию в своём личном кабинете (если есть доступ), а также получаете уведомление на Callback URL (если настроили) — интеграция работает.