This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Приём Платежей

1: Aaio
2: Crypto Bot
3: Cryptomus
4: T-bank
5: Wallet
6: ЮMoney
7: ЮKassa
8: FreeKassa
9: CryptoCloud.plus

SHM поддерживает различные платежные системы.

Настройка платежных систем осуществляется в интерфейсе администратора.

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

Вы можете воспользоваться платежными системами из списка или написать свой скрипт, который будет принимать информацию от платежной системы и зачислять этот платеж вашему клиенту в SHM по средствам API.

1 - Aaio

Настройка платежной системы Aaio

SHM не умеет конвертировать валюты, поэтому в биллинге следует установить все цены для услуг в той валюте какую указываете в currency

Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "aaio": {
      "currency":"валюта_RUB_USD_EUR_UAH",
      "description":"укажите_описание_товара",
      "merchant_id":"ID_Магазина_из_настройки_магазина",
      "name":"отабражаемое_имя_платежный_системы_(Aaio)",
      "secret":"из_настроек_Секретные_ключи_1_й_секретный_ключ",
      "secret2":"из_настроек_Секретные_ключи_2_й_секретный_ключ",
      "show_for_client":"true"
    }
  }
}

Ваш секретный ключ можно посмотреть в Настройках магазина.

В настройках вашего магазина в Основный настройках в поле URL Оповещения напишите:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/aaio.cgi

Пример ссылки для создания платежа:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/aaio.cgi?action=create&amount=123

2 - Crypto Bot

Настройка платежной системы (https://t.me/CryptoBot) или так же известный как (https://t.me/send)

SHM не умеет конвертировать валюты, поэтому в биллинге следует установить все цены для услуг в той валюте какую указываете в fiat

Валюту для приёма платежа можно выбрать из списка доступнх: USD, EUR, RUB, BYN, UAH, GBP, CNY, KZT, UZS, GEL, TRY, AMD, THB, INR, BRL, IDR, AZN, AED, PLN и ILS
Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "cryptopay": {
      "api_key":"ВАШ_Секретный_ключ",
      "description":"укажите_наименования_товара_для_чека",
      "fiat":"валюта_USD_EUR_RUB",
      "name":"CryptoPay",
      "paid_btn_name":"openBot",
      "paid_btn_url":"укажите_url_бота_для_возврата_после_удачного_платежа",
      "show_for_client":"true"
    }
  }
}

В телеграм боте (https://t.me/CryptoBot) “Crypto Pay” -> “Мои приложения” -> “Название приложения” -> “Вебхуки” нажмите включть вебхука, на сообщение Пришлите URL укажите URL для уведомлений вида:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/cryptopay.cgi

Ваш секретный ключ можно посмотреть в “Crypto Pay” -> “Мои приложения” -> “API-токен”

Если вы хотите попробовать и используете API-токен из Тестового Бота то SHM не сможет обработать платеж.

Пример ссылки для создания платежа:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/cryptopay.cgi?action=create&amount=123

3 - Cryptomus

Сервис позволяет принимать крипто-валюту от ваших клиентов.

SHM не умеет конвертировать валюты, поэтому в биллинге следует установить все цены для услуг в той же валюте что указано в currency.

Настройка платежной системы Cryptomus

Зарегистрируйтесь в сервисе Cryptomus (https://cryptomus.com/ru)
Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "cryptomus": {
      "name": "CryptoCloud"
      "api_key": "Платежный_api_ключ_из_настроек_мерчанта"
      "merchant": "ID_мерсанта_из_настроек_мерчанта"
      "currency": "RUB_или_USD"
      "url_success": "укажите_url_бота_для_возврата_после_удачного_платежа"
      "url_callback": "https://ВАШ_ДОМЕН/shm/pay_systems/cryptomus.cgi"
      "show_for_client": true
    }
  }
}

Дополнительные параметры:

lifetime в секундах, по умолчанию (3600) 1 час

min: 300
max: 43200

to_currency всегда должен быть кодом криптовалюты, а не кодом фиатной валюты.

Параметр используется для указания целевой валюты для пересчета суммы счета. При создании счета-фактуры вы указываете сумму и валюту, и API преобразует эту сумму в эквивалентное значение в to_currency Например, чтобы создать счет на 20 USD в BTC:

amount: 20
currency: "USD"
to_currency: "BTC"

API конвертирует сумму в размере 20 USD в ее эквивалент в BTC на основе текущего обменного курса, и пользователь будет платить в BTC.

course_source Сервис, из которого берутся обменные курсы для пересчета в счете-фактуре.

min: 4
max: 20

Доступные значения:

Binance
BinanceP2P
Exmo
Kucoin
Garantexio

Если не задано, используются обменные курсы Cryptomus.

Настройте URL для уведомлений:

в параметр url_callback добавьте ссылку

https://ВАШ_ДОМЕН/shm/pay_systems/cryptomus.cgi"

Пример ссылки для создания платежа:

https://ВАШ_ДОМЕН/shm/pay_systems/cryptomus.cgi?action=create&amount=123&user_id=123

4 - T-bank

Настройка платежной системы Т-Банк

Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "tbank": {
      "name": "отабражаемое_имя_платежный_системы_(T-Bank)",
      "terminal_key": "TerminalKey_из_настроек_магазина",
      "password": "из_настроек_магазина_пароль",
      "description": "укажите_описание_товара",
      "save_payments": false,
      "payment_object": "(Не_обязательный_параметр)_(Default=commodity)",
      "ffd": "Обязателен_если_подключена_онлайн_касса_(false_или_true)",
      "tax": "(Не_обязательный_параметр)_(Default=none)",
      "taxation": "(Не_обязательный_параметр)_(Default=osn)",
      "ffd_ver": "(Не_обязательный_параметр)_(Default=1.05)",
      "show_for_client": true,
    }
  }
}

Ваш TerminalKey можно посмотреть в Настройках магазина.

Описание параметров:

“tax” это - Ставка НДС. Перечисление со значениями:

none — без НДС,
vat0 — НДС по ставке 0%,
vat5 — НДС по ставке 5%*,
vat7 — НДС по ставке 7%*,
vat10 — НДС по ставке 10%,
vat20 — НДС по ставке 20%,
vat105 — НДС чека по расчетной ставке 5/105*,
vat107 — НДС чека по расчетной ставке 7/107*,
vat110 — НДС чека по расчетной ставке 10/110,
vat120 — НДС чека по расчетной ставке 20/120.

*Изменения вступают в силу с 01.01.2025.

“taxation” это - Система налогообложения. Возможные значения:

osn — общая СН;
usn_income — упрощенная СН (доходы);
usn_income_outcome — упрощенная СН (доходы минус расходы);
envd — единый налог на вмененный доход;
esn — единый сельскохозяйственный налог;
patent — патентная СН.

“payment_object” это - Признак предмета расчета. Возможные значения:

commodity — товар,
excise — подакцизный товар,
job — работа,
service — услуга,
gambling_bet — ставка азартной игры,
gambling_prize — выигрыш азартной игры,
lottery — лотерейный билет,
lottery_prize — выигрыш лотереи,
intellectual_activity — предоставление результатов интеллектуальной деятельности,
payment — платеж,
agent_commission — агентское вознаграждение,
composite — составной предмет расчета,
another — иной предмет расчета,

Если значение не передано, по умолчанию в онлайн-кассу отправляется признак предмета расчёта commodity.

“save_payments” это - рекуррентный платеж

true если хотите включить и сохранить карту пользователя

В настройках вашего магазина в настройках в поле `URL Оповещения` напишите:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/tbank.cgi

Пример ссылки для создания платежа:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/tbank.cgi?action=create&amount=123&user_id=123

5 - Wallet

Настройка платежной системы Telegram Wallet

SHM не умеет конвертировать валюты, поэтому в биллинге следует установить все цены для услуг в той валюте какую указываете в currencyCode

Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "wallet": {
      "api_key":"ВАШ_Секретный_ключ",
      "autoConversionCurrency":"Перечисление_на_ваш_счёт_TON_BTC_USDT",
      "currencyCode":"валюта_RUB_USD_EUR_USDT_BTC_TON",
      "description":"укажите_наименования_товара_для_чека",
      "failReturnUrl":"укажите_url_для_возврата_после_неудачного_платежа",
      "name":"Wallet",
      "returnUrl":"укажите_url_для_возврата_после_платежа",
      "show_for_client":"true"
    }
  }
}

Ваш секретный ключ можно посмотреть в Настройках.

В настройках вашего магазина включите тумблер Включить Webhooks в появившемся поле укажите:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/wallet.cgi

Пример ссылки для создания платежа:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/wallet.cgi?action=create&amount=123

6 - ЮMoney

Настройка платежной системы ЮMoney

Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "yoomoney": {
      "account":"АККАУНТ_ЮMONEY",
      "secret":"СЕКРЕТ_ЮMONEY"
    }
  }
}

Аккаунт можно посмотреть в платежной форме. Если форма еще не создана, введите любое значение в поле “Назначение платежа”, и платежная форма появится. Найдите в ней значение вашего аккаунта (account=). Секрет можно посмотреть здесь.

Для HTTP-уведомлений на странице: https://yoomoney.ru/transfer/myservices/http-notification настройте URL:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/yoomoney.cgi

Пример ссылки для создания платежа:

https://admin.ВАШ_ДОМЕН/shm/pay_systems/yoomoney.cgi?action=create&amount=123

7 - ЮKassa

Сервис позволяет принимать оплату самозанятым, ИП и Юридическим лицам.

Настройка платежной системы ЮKassa

Зарегистрируйтесь в сервисе ЮKassa (https://yookassa.ru/)
Создайте секретный ключ на странице “Интеграция” -> “Ключи API” (https://yookassa.ru/my/merchant/integration/api-keys)
Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "yookassa": {
      "name": "ЮKassa"
      "account_id": ВАШ_shopId
      "api_key": ВАШ_Секретный_ключ
      "customer_email": укажите_email_для_получения_чеков
      "description": укажите_наименования_товара_для_чека
      "return_url": укажите_url_для_возврата_после_платежа
      "show_for_client": true
    }
  }
}

В разделе “Интеграция” -> “HTTP-уведомления” (https://yookassa.ru/my/merchant/integration/http-notifications) укажите URL для уведомлений вида:

https://admin.ВАШ-ДОМЕН/shm/pay_systems/yookassa.cgi

Пример ссылки для создания платежа:

https://ВАШ_ДОМЕН/shm/pay_systems/yookassa.cgi?action=create&amount=123

8 - FreeKassa

Настройка платежной системы FreeKassa

Зарегистрируйтесь в сервисе FreeKassa (https://freekassa.com/)
Откройте страницу “Настройки” (https://merchant.freekassa.com/settings)
Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "freekassa": {
      "name": "FreeKassa"
      "show_for_client": true
      "merchant_id": ID_магазина_сверху_страницы
      "secret_word_1": СЕКРЕТНОЕ_СЛОВО_1
      "secret_word_2": СЕКРЕТНОЕ_СЛОВО_2
    }
  }
}

В разделе “Ссылки и методы” укажите URL ОПОВЕЩЕНИЯ и МЕТОД POST:

https://admin.ВАШ-ДОМЕН/shm/pay_systems/freekassa.cgi
Нажмите кнопку “ПРОВЕРИТЬ СТАТУС”. Вы должны увидеть статус 200, а в Админке SHM, в платежах, Вы увидите тестовый платеж.
Остальные поля заполните по вашему усмотрению

Пример ссылки для создания платежа:

https://ВАШ_ДОМЕН/shm/pay_systems/freekassa.cgi?action=create&amount=123

9 - CryptoCloud.plus

Сервис позволяет принимать крипто-валюту от ваших клиентов.

SHM не умеет конвертировать валюты, поэтому в биллинге следует установить все цены для услуг в долларах, и принимать только крипто-валюту: USDT.

Настройка платежной системы CryptoCloud.plus

Зарегистрируйтесь в сервисе CryptoCloud.plus (https://cryptocloud.plus/)
Сохраните в конфиг SHM следующие данные:

{
  "pay_systems": {
    "cryptocloud": {
      "name": "CryptoCloud"
      "api_key":"API_KEY"
      "shop_id":"Идентификтор магазина"
      "show_for_client": true
    }
  }
}

Настройте URL для уведомлений:

https://ВАШ_ДОМЕН/shm/pay_systems/cryptocloud.cgi

Пример ссылки для создания платежа:

https://ВАШ_ДОМЕН/shm/pay_systems/cryptocloud.cgi?action=create&amount=123

Приём Платежей

1 - Aaio

Пример ссылки для создания платежа:

2 - Crypto Bot

Пример ссылки для создания платежа:

3 - Cryptomus

Настройка платежной системы Cryptomus

Дополнительные параметры:

Доступные значения:

Настройте URL для уведомлений:

Пример ссылки для создания платежа:

4 - T-bank

Описание параметров:

“tax” это - Ставка НДС. Перечисление со значениями:

“taxation” это - Система налогообложения. Возможные значения:

“payment_object” это - Признак предмета расчета. Возможные значения:

“save_payments” это - рекуррентный платеж

В настройках вашего магазина в настройках в поле URL Оповещения напишите:

Пример ссылки для создания платежа:

5 - Wallet

Пример ссылки для создания платежа:

6 - ЮMoney

Пример ссылки для создания платежа:

7 - ЮKassa

Настройка платежной системы ЮKassa

Пример ссылки для создания платежа:

8 - FreeKassa

Настройка платежной системы FreeKassa

Пример ссылки для создания платежа:

9 - CryptoCloud.plus

Настройка платежной системы CryptoCloud.plus

Пример ссылки для создания платежа:

В настройках вашего магазина в настройках в поле `URL Оповещения` напишите: