Отслеживание продажи
Эндпоинты трекинга 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 только после успешной оплаты (например, в обработчике вебхука вашей платёжной системы об успешной оплате). Передача события до подтверждения платежа приведёт к ложным комиссиям, которые потом придётся отзывать.
Обновлено