Перейти к содержанию
somonly

TJSSomonly — продукт Dushanbe Soft

Эквайринг в Таджикистане — 24+ платёжных услуг в одном API

Somonly объединяет более 24 платёжных и банковских услуг — мобильные банки, карты Visa и Mastercard, QR-код SmartPay и оплату по лицевому счёту — в одном API. Подключите проект за 5 минут и принимайте оплату в сомони.

  • Суммы в сомони (TJS)
  • Вебхуки HMAC-SHA256
  • 24+ платёжных услуг
Схема работы SomonlyПроекты отправляют платежи в Somonly, Somonly передаёт их в SmartPay по одному ключу, SmartPay работает с банками и платёжными сервисами и возвращает вебхук, который Somonly доставляет нужному проекту.ПРОЕКТЫШЛЮЗПРОЦЕССИНГУСЛУГИAPIhookМагазинДоставкаОбучениеТакси+ новый проектsomonlyмаршрутизация1 API-ключAlifEskhata BankHumoDushanbe City BankVisa+19

Принимайте оплату через

  • Alif Mobi
  • Eskhata Online
  • Amonat Mobile
  • DC Next
  • Фаврӣ (CBT)
  • Vasl Pay
  • ICB Pay
  • MyBabilon
  • Humo Online
  • Arvand Online
  • Imon Online
  • IBT
  • ССБ
  • Visa
  • Mastercard
  • American Express
  • Apple Pay
  • Google Pay
  • QR-код SmartPay
  • Ссылка на оплату по SMS
  • Платёжные терминалы
  • Оплата по лицевому счёту
  • Диплинк в приложение банка
  • Страница оплаты на сайте

Зачем нужен Somonly

Одна интеграция вместо десятков

Dushanbe Soft запускает новые продукты еженедельно. Чтобы не интегрироваться с процессингом каждый раз заново, мы создали Somonly — единый шлюз, через который проекты принимают оплату всеми популярными способами Таджикистана.

Без Somonly

  • SmartPay выдаёт только один API-ключ на мерчанта
  • Каждый новый проект требует отдельной интеграции
  • Вебхуки, подписи и повторы реализуются заново
  • Нет общей картины платежей по всем проектам

С Somonly

  • Один API — 24+ платёжных и банковских услуг
  • Проект получает свой ключ sm_live_… за 5 минут
  • Подписанные вебхуки и повторы — из коробки
  • Журнал транзакций и статистика в одной панели

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

Два сценария оплаты — одна интеграция

Somonly поддерживает и онлайн-оплату по инвойсу, и оплату по лицевому счёту из банковских приложений. Проекту не нужно знать, как устроен SmartPay.

01

Онлайн-оплата по инвойсу

Проект создаёт платёж — клиент платит по ссылке или в банке.

  1. Проект

    Отправляет запрос в Somonly API со своим ключом X-Project-Key.

  2. Somonly → SmartPay

    Somonly создаёт инвойс в SmartPay по единому ключу компании.

  3. Клиент

    Оплачивает по payment_link или через диплинк в приложении своего банка.

  4. SmartPay → Somonly

    SmartPay присылает вебхук об оплате, Somonly обновляет статус платежа.

  5. Somonly → Проект

    Подписанный вебхук (HMAC-SHA256) уходит на callback URL проекта — с повторными попытками.

Пример: интернет-магазин создаёт счёт на 150,50 TJS, клиент нажимает «Оплатить в Alif» и подтверждает платёж в приложении банка.

Клиент платит из приложения своего банка

02

Оплата по лицевому счёту

Клиент сам находит сервис в приложении банка и вводит номер счёта.

  1. Клиент

    Открывает Alif Mobi или приложение другого банка и выбирает сервис SmartPay.

  2. Клиент

    Вводит номер лицевого счёта — например, номер договора или заказа.

  3. SmartPay → Somonly

    SmartPay отправляет запрос check (проверка) или pay (оплата).

  4. Somonly

    Определяет проект по префиксу лицевого счёта и проксирует запрос в него.

  5. Проект → Клиент

    Ответ проекта возвращается через Somonly и SmartPay прямо в приложение банка.

Пример: лицевой счёт 104000123 — код 104 направит запрос в проект «TV CRM», счёт 000123.

Сервис SmartPay в приложениях банков

SmartPay

Преимущества

Всё, что нужно проекту для приёма платежей

Somonly берёт на себя интеграцию с процессингом, безопасность и надёжность доставки — команда проекта занимается продуктом.

  • Один ключ — бесконечно проектов

    Ключ SmartPay хранится только в Somonly. Каждый проект получает собственный ключ sm_live_… и не видит чужие платежи.

  • Подключение за 5 минут

    Создайте проект в панели, укажите callback URL и префикс лицевого счёта — и принимайте оплату сразу.

  • Маршрутизация по префиксу

    Запросы check/pay по лицевому счёту автоматически уходят в нужный проект по его префиксу.

  • Подписанные вебхуки

    Каждое уведомление подписано HMAC-SHA256 секретом проекта — подделать событие невозможно.

  • Повторы и идемпотентность

    Недоставленные вебхуки отправляются повторно, а повторный запрос с тем же order_id не создаст дубль.

  • Журнал транзакций и логов

    Каждый запрос к SmartPay и каждый вебхук сохраняются — разбор инцидентов занимает минуты.

  • Панель администратора

    Управление проектами, ключами, секретами и callback URL в одном интерфейсе.

  • Статистика по проектам

    Обороты, количество и конверсия платежей по каждому проекту и банку.

  • Суммы в сомони (TJS)

    Все платежи и отчёты — в национальной валюте Таджикистана, без конвертаций.

платёжных и банковских услуг в одном API
24+
для всех услуг и всех проектов
1API
на подключение нового проекта
5мин
проектов без новых интеграций с процессингом
∞
год основания Dushanbe Soft
2017

Эквайринг в Таджикистане

24+ платёжных и банковских услуг в одном API

Somonly — эквайринг в Таджикистане, объединяющий более 24 платёжных и банковских услуг в одном API. Клиенты платят из привычного мобильного банка, картой или по QR-коду SmartPay, а вы подключаете всё одной интеграцией.

24+

Все услуги доступны проекту через одну интеграцию с Somonly.

  • Мобильные банки и кошельки13
  • Карты и кошельки5
  • Способы оплаты6

Мобильные банки и кошельки

  • Alif Mobi
  • Eskhata Online
  • Amonat Mobile
  • DC Next
  • Фаврӣ (CBT)
  • Vasl Pay
  • ICB Pay
  • MyBabilon
  • Humo Online
  • Arvand Online
  • Imon Online
  • IBT
  • ССБ

Карты и кошельки

  • Visa
  • Mastercard
  • American Express
  • Apple Pay
  • Google Pay

Способы оплаты

  • QR-код SmartPay
  • Ссылка на оплату по SMS
  • Платёжные терминалы
  • Оплата по лицевому счёту
  • Диплинк в приложение банка
  • Страница оплаты на сайте

Список услуг определяется подключением SmartPay и постоянно расширяется.

Логотипы — товарные знаки их владельцев и показаны для обозначения поддерживаемых способов оплаты.

Для разработчиков

Простой REST API и надёжные вебхуки

Проекту достаточно одного HTTP-запроса, чтобы создать платёж, и одного обработчика, чтобы узнать об оплате.

  1. 1

    Получите ключ проекта

    Администратор создаёт проект в панели Somonly и выдаёт ключ sm_live_… и секрет для вебхуков.

  2. 2

    Создайте платёж

    POST /api/v1/payments с заголовком X-Project-Key. Повтор с тем же order_id безопасен — работает идемпотентность.

  3. 3

    Перенаправьте клиента

    Откройте payment_link или deeplink_url выбранного банка (bank_id).

  4. 4

    Примите вебхук

    Проверьте X-Somonly-Signature — HMAC-SHA256 от «сырого» тела запроса с секретом проекта — и ответьте 2xx.

bash
# Создание платежа в Somonlycurl -X POST "https://api.somonly.com/api/v1/payments" \  -H "X-Project-Key: sm_live_xxxxxxxxxxxxxxxx" \  -H "Content-Type: application/json" \  -d '{    "order_id": "42",    "amount": 150.5,    "description": "Оплата заказа #42",    "return_url": "https://shop.example.tj/orders/42",    "bank_id": 8  }'
Авторизация
X-Project-Key
Подпись
HMAC-SHA256
Валюта
TJS (сомони)

FAQ

Частые вопросы

Как подключить эквайринг в Таджикистане?

Свяжитесь с нами по телефону или в Telegram и расскажите о проекте. Мы создадим проект в панели Somonly и выдадим ключ sm_live_… и секрет для вебхуков. Дальше достаточно одного запроса POST /api/v1/payments — и клиенты смогут платить через 24+ платёжных услуг Таджикистана.

Какие банки и кошельки поддерживает Somonly?

Somonly объединяет 24+ платёжных и банковских услуг. Мобильные банки и кошельки: Alif Mobi, Eskhata Online, Amonat Mobile, DC Next, Фаврӣ (CBT), Vasl Pay, ICB Pay, MyBabilon, Humo Online, Arvand Online, Imon Online, IBT, ССБ; Карты и кошельки: Visa, Mastercard, American Express, Apple Pay, Google Pay; Способы оплаты: QR-код SmartPay, Ссылка на оплату по SMS, Платёжные терминалы, Оплата по лицевому счёту, Диплинк в приложение банка, Страница оплаты на сайте. Список постоянно расширяется.

Сколько стоит подключение?

Тарифы рассчитываются индивидуально и предоставляются по запросу. Свяжитесь с нами по телефону +992 901 000 535 или в Telegram — подберём условия под ваш проект.

Зачем нужен Somonly, если есть SmartPay?

SmartPay выдаёт один API-ключ на мерчанта. Somonly интегрирован со SmartPay один раз и распределяет платежи между проектами, выдавая каждому собственный ключ sm_live_…, — так новый проект начинает принимать оплату без отдельной интеграции.

Сколько времени занимает подключение нового проекта?

Около 5 минут: администратор создаёт проект в панели, указывает callback URL и префикс лицевого счёта, а команда проекта получает ключ sm_live_… и секрет для проверки вебхуков.

Как Somonly понимает, какому проекту принадлежит оплата по лицевому счёту?

Каждому проекту назначается уникальный префикс лицевого счёта. Когда SmartPay присылает запрос check или pay, Somonly определяет проект по префиксу и перенаправляет запрос в него, а ответ проекта возвращает клиенту.

Как проверить, что вебхук действительно отправил Somonly?

Каждый вебхук содержит заголовок X-Somonly-Signature — HMAC-SHA256 от исходного тела запроса, вычисленный с секретом вашего проекта. Тип события передаётся в заголовке X-Somonly-Event. Посчитайте подпись у себя и сравните значения безопасным сравнением.

Что будет, если мой сервер был недоступен?

Somonly повторит доставку вебхука несколько раз с увеличивающимся интервалом. Все попытки и ответы вашего сервера видны в журнале логов панели администратора.

Не создастся ли дубль, если запрос на платёж отправлен дважды?

Нет. Создание платежа идемпотентно: повторный запрос с тем же order_id в рамках проекта вернёт уже созданный платёж.

В какой валюте проводятся платежи?

Все суммы указываются и учитываются в таджикских сомони (TJS).

Подключите эквайринг Somonly

Запускаете новый продукт? Напишите нам — расскажем об условиях, выдадим ключ проекта и поможем с интеграцией. Уже подключены? Войдите в панель, чтобы управлять проектами и смотреть статистику.