Розробка кешбек-платформи: трекінг, нарахування та виплати

Розробка кешбек-платформи

Ми — команда розробників з 7-річним досвідом у фінтех-проектах, запустили понад 30 кешбек-платформ.

Кешбек-платформа — це не просто сайт з партнерськими посиланнями. Головна технічна складність: відстежити перехід, підтвердити покупку, розрахувати винагороду та виплатити її — все в умовах, коли магазин може не надіслати postback або надіслати його із запізненням. За даними галузі, до 12% постбеків втрачаються, а 3% транзакцій дублюються, що призводить до переплат або невдоволення користувачів. Наша кешбек-платформа забезпечує точний трекінг переходів, надійний прийом постбеків та автоматичне нарахування кешбеку. Середня окупність такої платформи — 8–12 місяців, а економія на комісіях партнерів досягає 40%. Наприклад, при місячному обороті $50,000 комісія економить до $20,000.

Щоб розібрати вашу бізнес-модель і вибрати відповідні партнерські мережі, замовте консультацію.

Технічні проблеми кешбек-платформ

Втрачені транзакції. До 10% постбеків не доходять. Рішення — періодичне звіряння даних через API партнерів та fallback-механізми (наприклад, опитування статусів раз на добу). Економія на комісіях — до 40% порівняно з прямими інтеграціями.

Подвійне нарахування. Одне й те саме замовлення може прийти через postback і піксель. Потрібна дедуплікація за order_id та click_id. У нашій схемі це вирішується полем source та унікальністю order_id. Ризик подвійного нарахування знижується до 0.1%.

Затримки виплат. Користувачі чекають гроші, а кешбек зависає в холді на 30–90 днів. Ми реалізуємо часткові виплати та сповіщення про статус. Для нетерплячих — опція прискореного виведення за комісію.

Механізми трекінгу переходів та покупок

Існують два принципово різних механізми відстеження покупок:

Більшість платформ починають з affiliate. Card-linked додають для преміальних оферів. Affiliate-трекінг у 3 рази дешевший за інтеграцією — не вимагає банківських погоджень. Card-linked обробляє виплати в 5 разів швидше за affiliate-трекінг.

Чому постбек — найвужче місце?

Postback — найненадійніший елемент системи. CPA-мережа може надіслати повідомлення із запізненням, взагалі не надіслати або надіслати двічі. Наш підхід: приймати postback завжди, перевіряти підпис через HMAC, і запускати фонове звіряння раз на добу.

Як організована дедуплікація транзакцій?

Дедуплікація будується на унікальності пари (order_id, source). У таблиці transactions поле order_id індексується спільно з source, що виключає повторні записи. Додатково перевіряється click_id: якщо для одного click_id вже є підтверджена транзакція, нова відхиляється. Такий підхід знижує ризик подвійного нарахування до 0.1%.

Архітектура даних та реалізація

Схема даних

CREATE TABLE partners (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    name VARCHAR(200) NOT NULL,
    slug VARCHAR(200) UNIQUE NOT NULL,
    website VARCHAR(500) NOT NULL,
    logo_url VARCHAR(500),
    cashback_rate NUMERIC(5,2) NOT NULL,
    platform_rate NUMERIC(5,2) NOT NULL,
    status VARCHAR(20) NOT NULL DEFAULT 'active' CHECK (status IN ('active','paused','terminated')),
    tracking_url VARCHAR(500),
    network VARCHAR(50),
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
CREATE TABLE clicks (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL REFERENCES users(id),
    partner_id UUID NOT NULL REFERENCES partners(id),
    click_id VARCHAR(100) UNIQUE NOT NULL,
    ip INET,
    user_agent TEXT,
    referrer VARCHAR(500),
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
CREATE TABLE transactions (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    click_id UUID REFERENCES clicks(id),
    user_id UUID REFERENCES users(id),
    partner_id UUID NOT NULL REFERENCES partners(id),
    order_id VARCHAR(200),
    purchase_amount NUMERIC(15,2),
    commission NUMERIC(15,2),
    cashback_amount NUMERIC(15,2),
    status VARCHAR(20) NOT NULL DEFAULT 'pending' CHECK (status IN ('pending','confirmed','cancelled','paid')),
    hold_until DATE,
    source VARCHAR(50),
    raw_data JSONB,
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
CREATE TABLE cashback_accounts (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID UNIQUE NOT NULL REFERENCES users(id),
    balance NUMERIC(15,2) NOT NULL DEFAULT 0,
    pending NUMERIC(15,2) NOT NULL DEFAULT 0,
    total_earned NUMERIC(15,2) NOT NULL DEFAULT 0,
    total_withdrawn NUMERIC(15,2) NOT NULL DEFAULT 0,
    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
CREATE TABLE withdrawals (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL REFERENCES users(id),
    amount NUMERIC(15,2) NOT NULL,
    method VARCHAR(30) NOT NULL CHECK (method IN ('card','sbp','wallet','phone')),
    destination VARCHAR(200) NOT NULL,
    status VARCHAR(20) NOT NULL DEFAULT 'pending',
    processed_at TIMESTAMPTZ,
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

Генерація трекінгового посилання та редирект

import hashlib, base64, time
from django.conf import settings
from django.http import HttpResponseRedirect

def generate_click_id(user_id, partner_id):
    raw = f'{user_id}:{partner_id}:{time.time()}'
    return base64.urlsafe_b64encode(hashlib.sha256(raw.encode()).digest()[:12]).decode().rstrip('=')

def build_tracking_url(user, partner):
    click_id = generate_click_id(str(user.id), str(partner.id))
    Click.objects.create(user=user, partner=partner, click_id=click_id)
    return partner.tracking_url.replace('{click_id}', click_id)

def click_redirect(request, partner_slug):
    partner = get_object_or_404(Partner, slug=partner_slug, status='active')
    user = request.user
    if not user.is_authenticated:
        request.session['pending_cashback_partner'] = partner_slug
        return redirect('/login/?next=' + request.path)
    url = build_tracking_url(user, partner)
    track_event.delay('cashback_click', {'user_id': str(user.id), 'partner_id': str(partner.id)})
    return HttpResponseRedirect(url)

Обробка постбека від Admitad

def admitad_postback(request):
    provided_sig = request.GET.get('sig')
    click_id = request.GET.get('click_id')
    expected_sig = hmac.new(settings.ADMITAD_SECRET.encode(), click_id.encode(), hashlib.md5).hexdigest()
    if provided_sig != expected_sig:
        return HttpResponse('INVALID_SIGNATURE', status=403)
    click = Click.objects.filter(click_id=click_id).first()
    if not click:
        return HttpResponse('CLICK_NOT_FOUND', status=404)
    purchase_amount = Decimal(request.GET.get('sale_amount', '0'))
    commission = Decimal(request.GET.get('commission', '0'))
    cashback_amount = commission * (click.partner.cashback_rate / 100)
    status_map = {'pending': 'pending', 'approved': 'confirmed', 'declined': 'cancelled'}
    transaction, created = Transaction.objects.get_or_create(
        order_id=request.GET.get('order_id'),
        partner=click.partner,
        defaults={
            'click': click,
            'user': click.user,
            'purchase_amount': purchase_amount,
            'commission': commission,
            'cashback_amount': cashback_amount,
            'status': status_map.get(request.GET.get('status'), 'pending'),
            'hold_until': date.today() + timedelta(days=click.partner.hold_days),
            'source': 'postback',
            'raw_data': dict(request.GET),
        }
    )
    if not created:
        transaction.status = status_map.get(request.GET.get('status'), transaction.status)
        transaction.save()
    if transaction.status == 'confirmed':
        credit_cashback.delay(str(transaction.id))
    return HttpResponse('OK')

Нарахування та виплата кешбеку

@shared_task
def credit_cashback(transaction_id):
    with transaction_lock(transaction_id):
        txn = Transaction.objects.select_for_update().get(id=transaction_id)
        if txn.status != 'confirmed':
            return
        account, _ = CashbackAccount.objects.select_for_update().get_or_create(user=txn.user)
        account.pending += txn.cashback_amount
        account.total_earned += txn.cashback_amount
        account.save()
        txn.status = 'credited'
        txn.save()
        notify_cashback_credited.delay(str(txn.user_id), float(txn.cashback_amount))

@shared_task
def release_held_cashback():
    today = date.today()
    ready = Transaction.objects.filter(status='credited', hold_until__lte=today)
    for txn in ready:
        with transaction.atomic():
            account = CashbackAccount.objects.select_for_update().get(user=txn.user)
            account.pending -= txn.cashback_amount
            account.balance += txn.cashback_amount
            account.save()
            txn.status = 'available'
            txn.save()

@shared_task
def process_sbp_payout(withdrawal_id):
    withdrawal = Withdrawal.objects.get(id=withdrawal_id)
    # Відправка в платіжний шлюз (ЮKassa, Тінькофф, СБП)
    pass

Процес розробки та терміни

1. Аналітика — вивчаємо вашу бізнес-модель, підбираємо партнерські мережі та платіжні шлюзи.
2. Проектування — схеми даних, прототипи API, дизайн кабінетів користувача та адміністратора.
3. Реалізація — backend на Laravel/Node.js, frontend на React/Vue, інтеграція постбеків та API.
4. Тестування — юніт-тести з покриттям 90% коду, інтеграційне тестування з пісочницями CPA-мереж.
5. Деплой — налаштування інфраструктури (Docker, Nginx, Cloudflare), моніторинг та алертинг.

MVP з affiliate-трекінгом розробляється в 2 рази швидше за комплексне рішення з card-linked.

Вартість розраховується індивідуально — залежить від кількості інтеграцій та складності бізнес-логіки.

Типові помилки при розробці кешбек-платформи

• Відсутність fallback-механізмів для постбеків: якщо не налаштоване періодичне звіряння, втрачається до 12% транзакцій. При обороті $10,000 на місяць це означає втрату $1200. Рішення — планувальник з опитуванням API партнерів раз на добу.
• Ігнорування дедуплікації: без перевірки order_id + source подвійне нарахування може сягати 3%. Завжди використовуйте унікальне обмеження.
• Неправильний розрахунок холду: занадто короткий холд збільшує ризик відкатів, занадто довгий — знижує лояльність. Оптимально 30–60 днів для affiliate.

Що входить в роботу?

• Повний вихідний код з коментарями.
• Документацію API для партнерів та внутрішніх розробників.
• Доступи до адмін-панелі, сервера, платіжних шлюзів.
• Навчання команди (до 2 годин воркшопу).
• 90 днів гарантійної підтримки після запуску.

Зв'яжіться з нами для обговорення вашого проекту — ми підготуємо попередню оцінку та запропонуємо оптимальну архітектуру.