Подписки

Общее

Swagger: https://api.radist.online/v2/docs#/Subscriptions

Необходимые права доступа (scopes) для работы с API: subscriptions

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

Реквизиты — реквизиты ИП или ООО. Используются для выставления счетов на оплату.

Срок подписки

Пример подписки

{
  "id": 1926,
  "connections": [
    29228,
    30111
  ],
  "subscription_type": "CONNECTION_TELEGRAM_BOT",
  "current_size": 2,
  "test_until": "2022-11-27T07:17:28.784647Z",
  "paid_until": "2220-05-25T13:38:57.518834Z",
  "paused_at": null
}

Если подписка на паузе (paused_at ≠ null)

Оставшийся срок подписки = paid_until - paused_at

Если подписка не на паузе

Оставшийся срок подписки = paid_until - {текущие дата и время}

Примеры

Изменить список подключений в подписке

// После этой операции в подписке будет 2 подключения: 29228, 30111.

// Если убрать все подключения из подписки, передав пустой список,
// подписка перейдёт в состояние "на паузе".

POST /companies/{company_id}/subscriptions/{subscription_id}
{"connections":[29228, 30111]}


Response
{
  "id": 1926,
  "connections": [
    29228,
    30111
  ],
  "subscription_type": "CONNECTION_TELEGRAM_BOT",
  "current_size": 2,
  "test_until": "2022-11-27T07:17:28.784647Z",
  "paid_until": "2220-05-25T13:38:57.518834Z",
  "paused_at": null
}

Добавить реквизиты

POST /companies/{company_id}/subscriptions/requisites/
{
  "tin": "1699982918",
  "name": "ООО \"Маша и Миша\""
}


Response
{
  "id": 2004,
  "tin": "1699982918",
  "name": "ООО \"Маша и Миша\"",
  "approval_status": "APPROVED"
}

Выставить счёт на оплату подписок и WABA-диалогов

// 3 месяца, 3 подписки, 100 диалогов

// Получим предпросмотр (preview=true).
// Это не создаст счёт, но даст итоговую стоимость и состав счёта.
// Чтобы сформировать настоящий счёт, передайте preview=false.

// payment_method - CARD_RU (карта РФ), CARD_OTHER (карта не РФ),
// BANK_TRANSFER (банковский перевод, обязательно передать company_requisite_id)

POST /companies/{company_id}/subscriptions/invoices/
{
  "preview": true,
  "items": [
    {
      "type": "SUBSCRIPTION",
      "id": 11
    },
    {
      "type": "SUBSCRIPTION",
      "id": 1926
    },
    {
      "type": "SUBSCRIPTION",
      "id": 6752
    },
    {
      "type": "WABA_DIALOGS",
      "count": 100
    }
  ],
  "payment_method": "CARD_RU",
  "period_months": 3,
  "promo_code": null // Указать, если есть
}


Response // Это предпросмотр (id=0, preview=true)
{
  "id": 0,
  "preview": true,
  "status": "new",
  "lifetime": "2024-12-09T10:34:03.947066Z",
  "summary": {
    "payment_method": "CARD_RU",
    "period_months": 3,
    "items": [
      {
        "type": "SUBSCRIPTION",
        "subscription_id": 6752,
        "old_size": 2,
        "products": [
          {
            "connection_id": 45406,
            "amount": 3000,
            "discount": 300,
            "discounts": {
              "period_discount_percent": 10,
              "quantity_discount_percent": 0,
              "promo_discount_percent": 0,
              "partner_discount_percent": 0,
              "test_period_discount_percent": 0
            }
          },
          {
            "connection_id": 53991,
            "amount": 2400,
            "discount": 240,
            "discounts": {
              "period_discount_percent": 10,
              "quantity_discount_percent": 0,
              "promo_discount_percent": 0,
              "partner_discount_percent": 0,
              "test_period_discount_percent": 0
            }
          }
        ]
      },
      {
        "type": "SUBSCRIPTION",
        "subscription_id": 1926,
        "old_size": 1,
        "products": [
          {
            "connection_id": 29228,
            "amount": 4500,
            "discount": 450,
            "discounts": {
              "period_discount_percent": 10,
              "quantity_discount_percent": 0,
              "promo_discount_percent": 0,
              "partner_discount_percent": 0,
              "test_period_discount_percent": 0
            }
          }
        ]
      },
      {
        "type": "SUBSCRIPTION",
        "subscription_id": 11,
        "old_size": 2,
        "products": [
          {
            "connection_id": 31147,
            "amount": 15000,
            "discount": 1500,
            "discounts": {
              "period_discount_percent": 10,
              "quantity_discount_percent": 0,
              "promo_discount_percent": 0,
              "partner_discount_percent": 0,
              "test_period_discount_percent": 0
            }
          },
          {
            "connection_id": 55868,
            "amount": 10500,
            "discount": 1050,
            "discounts": {
              "period_discount_percent": 10,
              "quantity_discount_percent": 0,
              "promo_discount_percent": 0,
              "partner_discount_percent": 0,
              "test_period_discount_percent": 0
            }
          }
        ]
      },
      {
        "type": "WABA_DIALOGS",
        "count": 100,
        "price": 10.6915
      }
    ],
    "promo_code": null,
    "total_discount": 3540,
    "partner_discount_percent": 0,
    "company_requisite": null
  },
  "amount": 32929.15,
  "currency": "RUB",
  "payment_url": null,
  "preview_url": "https://invoices.radist.online/private/invoices/06019947-8962-4129-8276-cd9c388e4ba1",
  "act_url": null,
  "receipt": {
    "items": [
      {
        "name": "Лицензия на ПО для ЭВМ \"ЮKassa Radist.Online\"",
        "quantity": 1,
        "price": 4860
      },
      {
        "name": "Лицензия на ПО для ЭВМ \"Telegram Bot Radist.Online\"",
        "quantity": 1,
        "price": 4050
      },
      {
        "name": "Лицензия на ПО для ЭВМ \"WhatsApp Business API Radist.Online\"",
        "quantity": 1,
        "price": 22950
      },
      {
        "name": "Диалоги WhatsApp Business API",
        "quantity": 1,
        "price": 1069.15
      }
    ]
  },
  "created_at": "2024-12-02T10:34:03.945486Z"
}