Партнёрская API-программа

Реферальный API (ref_id)

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

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

Механика каждого вознаграждения по ref_id.

Вы получаете 5% выручки с каждой подтверждённой активации с вашим ref_id. Одно исключение: если прибыль по продаже очень мала, вознаграждение ограничивается долей этой прибыли. Это ограничение ещё ни разу не применялось.

Вознаграждение создаётся только если активация подтверждена, то есть код действительно пришёл. Отменённая или возвращённая активация не приносит дохода.

Вознаграждения зачисляются на баланс кошелька сразу, без периода ожидания.

Доход от API зачисляется как средства на балансе: минимальной суммы и заявок на вывод нет, но вывести его наличными нельзя. Тратьте на любой продукт платформы.

Отправка ref_id

Оба API-канала принимают один и тот же реферальный код, различается только способ передачи.

Современный API (v1, тело JSON)

curl -X POST "https://smsbulk.net/api/v1/activations" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceCode": "wa",
    "countryIso": "US",
    "ref_id": "K7M2QXWP"
  }'

{
  "id": "act_9f1c...",
  "status": "PENDING",
  "phoneNumber": "+1...",
  "referral": {
    "accepted": true,
    "reason": null
  }
}

Канал, совместимый с SMS-Activate (параметр запроса)

curl "https://smsbulk.net/stubs/handler_api.php\
?api_key=YOUR_KEY&action=getNumber&service=wa&country=187&ref_id=K7M2QXWP"

ACCESS_NUMBER:12345678:79991234567

Два правила, которые партнёры чаще всего понимают неверно

Эти проверки защищают программу от самовыплат и двойных выплат. Если вознаграждение не появилось, причина почти всегда в одном из них.

Самовыплата блокируется

Если ref_id принадлежит тому же аккаунту, который совершает покупку, вознаграждение не создаётся. Указание собственного ref_id в своём же трафике никогда не приносит комиссию.

Уже привязанные аккаунты игнорируются

Если покупатель уже зарегистрировался по реферальной ссылке того же партнёра, отправка ref_id этого партнёра при покупке игнорируется: связь уже существует, поэтому второе вознаграждение не создаётся. ref_id другого партнёра при этом работает как обычно.

Неверный ref_id никогда не блокирует покупку

Неизвестный, некорректный или устаревший ref_id молча игнорируется. Покупка всегда завершается нормально, независимо от наличия действительного реферального кода.

Поле referral в ответе v1

POST /v1/activations включает объект referral только если в запросе был передан ref_id. Запросы без него получают точно такой же ответ, как и раньше.

accepted: true означает, что ref_id принят и привязан к этой активации. Само вознаграждение начисляется позже, когда активация подтверждается.
accepted: false означает, что вознаграждение не создано; смотрите значение reason ниже.

значения reason

reason	Значение
unknown_code	ref_id не соответствует коду ни одного партнёра. Повторные попытки подбора ограничены по частоте.
self_dealing	ref_id принадлежит тому же аккаунту, который совершил покупку.
already_referred	Покупатель уже привязан к этому же партнёру при регистрации, поэтому код игнорируется, а не считается ошибкой.
referrer_inactive	Партнёрский аккаунт, стоящий за этим ref_id, неактивен или заблокирован.

В канале, совместимом с SMS-Activate, поля referral нет

Этот протокол возвращает не JSON, а строку в виде обычного текста, например ACCESS_NUMBER:id:phoneNumber, поэтому передать accepted/reason просто негде. ref_id на этом канале работает точно так же, вы лишь не увидите результат в ответе. Для подтверждения проверяйте партнёрскую панель.

Начните зарабатывать на своём API-трафике

Получите реферальный код в партнёрской панели и добавьте его в свою интеграцию.

Открыть партнёрскую панель Назад к документации