Skip to Content

Отслеживание продажи

Эндпоинты трекинга sale-событий поддерживают два режима:

  • server-side — вызывается с бэкенда, использует секретный API-ключ rr_*
  • client-side — вызывается с фронтенда, использует publishable key rr_pk_*

Серверный вызов

  • Method: POST
  • URL: https://api.revroute.ru/track/sale
  • Auth: Authorization: Bearer rr_* (ключ из /<workspace>/settings/tokens)
curl -X POST "https://api.revroute.ru/track/sale" \ -H "Authorization: Bearer rr_xxxxxx" \ -H "Content-Type: application/json" \ -d '{ "customerExternalId": "cus_oFUYbZYqHFR0knk0MjsMC6b0", "amount": 99000, "paymentProcessor": "custom", "eventName": "Invoice paid", "invoiceId": "INV_1234567890", "currency": "rub" }'

Поля запроса

ПолеОбязательноеЧто передать
customerExternalIdдаИдентификатор пользователя в вашей системе — тот же, что в track/lead. До 100 символов.
amountдаСумма в копейках, целое число: 99000 — это 990 ₽.
currencyнетКод валюты по ISO 4217, по умолчанию rub. Сумма сохраняется в переданной валюте без пересчёта.
invoiceIdнетИдентификатор платежа. Повторный вызов с тем же invoiceId не создаёт вторую продажу.
eventNameнетНазвание события, по умолчанию Purchase. Например, Подписка или Покупка кредитов.
paymentProcessorнетИсточник платежа, см. «Поле paymentProcessor».
metadataнетОбъект с дополнительными данными, до 10 000 символов в JSON.
leadEventNameнетНазвание события лида, с которым связать продажу (с учётом регистра). По умолчанию — последний лид пользователя.
clickIdнетДля продажи без события лида: значение cookie rr_id.
discountCodeнетПромокод партнёра для продажи без события лида и без clickId.
customerName, customerEmail, customerAvatarнетДля продажи без события лида: имя, email и адрес аватара покупателя.

Клиентский вызов

  • Method: POST
  • URL: https://api.revroute.ru/track/sale/client
  • Auth: Authorization: Bearer rr_pk_* (ключ из /<workspace>/settings/analytics?step=connect)
curl -X POST "https://api.revroute.ru/track/sale/client" \ -H "Authorization: Bearer rr_pk_xxxxxx" \ -H "Content-Type: application/json" \ -d '{ "customerExternalId": "cus_oFUYbZYqHFR0knk0MjsMC6b0", "amount": 99000, "paymentProcessor": "custom", "eventName": "Invoice paid", "invoiceId": "INV_1234567890", "currency": "rub" }'

Поле paymentProcessor

Опциональное поле для пометки источника платежа: stripe, shopify, polar, paddle, revenuecat или custom — самостоятельная интеграция или другой провайдер (по умолчанию). Значение вне этого списка записывается как custom.

Поле справочное — оно не влияет на атрибуцию или начисление комиссии, но помогает фильтровать события в аналитике по источнику платежа.

Когда вызывать эндпоинт

Вызывайте track/sale только после успешной оплаты (например, в обработчике вебхука вашей платёжной системы об успешной оплате). Передача события до подтверждения платежа приведёт к ложным комиссиям, которые потом придётся отзывать.

Обновлено