API и события для собственной партнерской программы
Подключение строится вокруг публичного ключа программы, JS tracking и server-side billing events. Все события идемпотентны по `event_id`.
POST /api/v1/events
Authorization: Bearer lk_live_...
{
"event_id": "evt_123",
"type": "payment_succeeded",
"external_customer_id": "cus_42",
"amount": 590000,
"currency": "RUB"
}Минимальный контракт событий
В MVP достаточно закрыть путь от лида до оплаты, продления, возврата и отмены.
lead_created
payment_succeeded
subscription_renewed
refund_created
subscription_cancelled
Что важно в интеграции
Linkado не хранит карточные данные и не пытается быть платежной системой. Он принимает безопасные события от продукта мерчанта.
Публичный ключ программы используется только для click tracking.
Приватный API token нужен для серверных событий.
Дубликаты event_id не создают повторные комиссии.
Raw payload и processing status нужны для поддержки пилотов.