Интеграция партнёра

Базовый шаблон URL для вашей кнопки:

https://zbrcheck.ru/r/REF<ваш_id>?kn=<кадастровый_номер>

Параметры:

• REF<ваш_id> — ваш партнёрский код. Найдите его в реф-кабинете на странице «Партнёрская программа».
• ?kn= — кадастровый номер участка. Необязательный. Если передан — форма заказа отчёта у клиента будет предзаполнена.

Пример:

https://zbrcheck.ru/r/REF123?kn=50:13:0020101:2524

Клиент перейдёт на ваш партнёрский лендинг, увидит «Партнёр уже подобрал участок: 50:13:0020101:2524», зарегистрируется или войдёт, и сразу попадёт на форму создания отчёта с этим КН. От него остаётся только выбрать тариф (Pro / экспертный) и оплатить.

На примере aiogram 3.x (Python):

from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton

PARTNER_REF = "REF123"  # ваш партнёрский код

def make_check_button(cadastral_number: str) -> InlineKeyboardMarkup:
    url = f"https://zbrcheck.ru/r/{PARTNER_REF}?kn={cadastral_number}"
    return InlineKeyboardMarkup(inline_keyboard=[
        [InlineKeyboardButton(
            text="🌍 Проверить участок (Земля без риска)",
            url=url,
        )]
    ])

# Использование:
await message.answer(
    f"Получен кадастровый номер: {cadastral_number}\n\n"
    f"Хотите углублённую проверку и экспертный отчёт?",
    reply_markup=make_check_button(cadastral_number),
)

Клиент тапает кнопку — открывается наш сайт в браузере (или WebApp если настроите соответствующим образом) — клиент авторизуется и платит у нас — вам идёт 5% автоматически.

<a
  href="https://zbrcheck.ru/r/REF123?kn=50:13:0020101:2524"
  target="_blank"
  rel="noopener"
  class="check-button"
>
  🌍 Проверить участок
</a>

Динамически подставьте КН пользователя:

function buildCheckUrl(cn) {
  const ref = "REF123"; // ваш партнёрский код
  return `https://zbrcheck.ru/r/${ref}?kn=${encodeURIComponent(cn)}`;
}

Если хотите автоматически показывать актуальные цены на свой стороне, раз в день дёргайте публичный endpoint:

curl https://zbrcheck.ru/api/v1/services

Ответ (упрощённо):

{
  "version": "1.0",
  "currency": "RUB",
  "services": {
    "free": { "name": "Free-проверка", "price_rub": 0, "available": true },
    "pro":  { "name": "Pro-отчёт",      "price_rub": 599, "available": true },
    "ai":   { "name": "Экспертный отчёт PDF",   "price_rub": 1200, "available": true }
  },
  "packages": {
    "pro": [{"count":1,"price_rub":599}, {"count":5,"price_rub":2499}, ...],
    "ai":  [{"count":1,"price_rub":1200}, {"count":3,"price_rub":2999}, ...]
  },
  "deeplink_template": "https://zbrcheck.ru/r/{ref_code}?kn={cadastral_number}",
  "partner_program": {
    "commission_pct": 5,
    "min_payout_rub": 5000
  }
}

Endpoint публичный, без аутентификации. Не нагружайте — лимит 120 запросов/минуту с одного IP. Кэшируйте на своей стороне на 1-24 часа.

• 5% автоматически зачисляется на ваш реф-баланс при каждом успешном платеже клиента.
• Минимум на вывод — 5 000 ₽.
• Частота — не чаще 1 раза в месяц.
• Для вывода (самозанятый, ИП или ООО) заполните реквизиты в реф-кабинете. Физлицо вывод не оформляет — бонус копится на оплату услуг.
• Для ИП и ООО — нужен подписанный партнёрский договор (это автоматическая процедура в реф-кабинете).
• Статистика по кликам, регистрациям и платежам — в реф-кабинете.

Можно ли передать партнёрский ID без кадастрового номера?

Да. Просто https://zbrcheck.ru/r/REF123 — клиент попадёт на лендинг приглашения и сам введёт КН в форме.

Что если клиент уже зарегистрирован у вас?

Реф-привязка не происходит — он остаётся «своим» клиентом. Антифрод-проверка не позволяет привязать партнёра к уже активному юзеру (это защищает от накруток).

Можно ли вернуть деньги клиенту?

Да, в течение 14 дней до использования отчёта — через нашу поддержку. Соответственно ваша комиссия по этой транзакции тоже отменяется.