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

Return to the regular view of this page.

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

Приём платежей пользователей осуществляется путем заполнения одного из шаблонов платежей.

Шаблон платежа содержит HTML форму платежной системы. Шаблон позволяет заполнить ряд полей этой формы автоматически. Например для того, чтобы понять какой пользователь совершил платеж, мы можем в поле “Назначение платежа” указать идентификатор пользователя.

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

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

1 - CryptoCloud.plus

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

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

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

{
  "pay_systems": {
    "cryptocloud": {
      "name": "CryptoCloud"
      "api_key":"API_KEY"
      "shop_id":"Идентификтор магазина"
      "template_id": "crypto-cloud-plus"
      "show_for_client": true
    }
  }
}
  • Настройте URL для уведомлений: https://ВАШ_ДОМЕН/shm/pay_systems/cryptocloud.cgi
  • Создайте шаблон с именем crypto-cloud-plus вида:
<form action="/shm/pay_systems/cryptocloud.cgi" method="POST" target="_blank" name="userForm">
    <input type="hidden" name="action" value="create" />
    <div class="modal-header">
        <h4 class="modal-title">Оплата с помощью сервиса CryptoCloud.plus</h4>
    </div>
    <div class="modal-body" style="min-height: 0vh;">
        <div class="form-group">
            <label class="col-sm-4 control-label">Сумма в USDT:</label>
            <div class="col-sm-8">
                <input type="number" name="amount" class="form-control" value=10 required=1>
            </div>
        </div>
    </div>

    <div class="modal-footer">
        <input class="btn btn-primary" ng-disabled="userForm.$invalid" type="submit" value="Далее" />
    </div>
</form>

2 - ЮKassa

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

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

{
  "pay_systems": {
    "yookassa": {
      "name": "ЮKassa"
      "account_id": ВАШ_shopId
      "api_key": ВАШ_Секретный_ключ
      "customer_email": укажите_email_для_получения_чеков
      "description": укажите_наименования_товара_для_чека
      "return_url": укажите_url_для_возврата_после_платежа
      "template_id": "yookassa_template"
      "show_for_client": true
    }
  }
}
  • В разделе “Интеграция” -> “HTTP-уведомления” (https://yookassa.ru/my/merchant/integration/http-notifications) укажите URL для уведомлений вида: https://admin.ВАШ-ДОМЕН/shm/pay_systems/yookassa.cgi
  • Создайте шаблон с именем yookassa_template вида:
<form action="/shm/pay_systems/yookassa.cgi" method="POST" target="_blank" name="userForm">
    <input type="hidden" name="action" value="create" />
    <div class="modal-header">
        <h4 class="modal-title">Оплата с помощью сервиса ЮKassa</h4>
    </div>
    <div class="modal-body" style="min-height: 0vh;">
        <div class="form-group">
            <label class="col-sm-4 control-label">Сумма в рублях:</label>
            <div class="col-sm-8">
                <input type="number" name="amount" class="form-control" value=10 required=1>
            </div>
        </div>
    </div>

    <div class="modal-footer">
        <input class="btn btn-primary" ng-disabled="userForm.$invalid" type="submit" value="Далее" />
    </div>
</form>
  • Если используете Telegram bot, то можете использовать ссылку для оплаты вида: https://{{ config.api.url }}/shm/pay_systems/yookassa.cgi?user_id={{ user.id }}&action=create&amount={{ user.pays.forecast.total }}&message_id={{ message.message_id + 1 }}

3 - ЮMoney

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

  • Сохраните в конфиг SHM следующие данные:
{
  "pay_systems": {
    "yoomoney": {
      "account":"АККАУНТ_ЮMONEY",
      "secret":"СЕКРЕТ_ЮMONEY"
    }
  }
}

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