Коннектор Stripe
Подключите свой аккаунт Stripe к Tajo для синхронизации платёжных данных только на чтение (клиенты, платежи, подписки и счета) в разрешение контактов, сегментацию и автоматизации на основе выручки (через Brevo и других провайдеров взаимодействия).
Обзор
| Свойство | Значение |
|---|---|
| Аутентификация | Секретный ключ Stripe (sk_live_... / sk_test_...) или ограниченный ключ |
| Доступ | Только на чтение, Tajo никогда не пишет в ваш аккаунт Stripe |
| Базовый API | https://api.stripe.com/v1 |
| Направление синхронизации | Stripe → Tajo |
| Вебхуки в реальном времени | Пока нет, сегодня синхронизация работает по опросу |
Настройка
- В Stripe Dashboard откройте Developers → API keys.
- Создайте ограниченный ключ: достаточно права на чтение для Customers, Charges, Subscriptions и Invoices. Ограниченный ключ настоятельно предпочтительнее полного секретного ключа: Tajo только читает, поэтому выдавайте только чтение.
- Вставьте ключ в подключение Stripe в Tajo.
Подключение проверяется запросом только на чтение до начала любой синхронизации. Вы можете в любой момент сменить или отозвать ключ в Stripe.
Что синхронизируется
| Данные | Что Tajo с ними делает |
|---|---|
| Клиенты | Разрешаются в контакты (email, имя, телефон, адрес) для идентификации и сегментации. Согласие никогда не выводится из самого факта существования записи клиента. |
| Платежи | События выручки для автоматизаций жизненного цикла на основе покупок и сегментации по LTV |
| Подписки | Статус жизненного цикла (active, past_due, canceled…) для напоминаний о неоплате, возврата клиентов и удержания |
| Счета | Статус оплаты для сообщений, связанных с биллингом |
Пагинация использует курсорную модель Stripe (starting_after), поэтому крупные аккаунты синхронизируются полностью и с возможностью возобновления.
Текущие ограничения
Сказано прямо, чтобы вы могли это учесть:
- Пока нет вебхуков в реальном времени. Изменения приходят по расписанию синхронизации, а не в момент успешного платежа. Приём вебхуков есть в планах.
- Только чтение. Tajo не создаёт и не изменяет клиентов, платежи или подписки в Stripe.
- Нет приложения Stripe. Сегодня в Stripe App Marketplace нет приложения Tajo; подключение настраивается в Tajo, а не в Stripe Dashboard.
Устранение неполадок
| Симптом | Причина и решение |
|---|---|
| 401 от Stripe | Ключ отозван или заменён. Вставьте актуальный ключ в подключение |
| Клиенты синхронизируются, а платежи нет | У ограниченного ключа нет права на чтение для Charges |
| У контакта нет email | Клиенты Stripe без email синхронизируются как анонимные записи о выручке; они присоединяются к графу контактов, если email добавят позже |
Дальнейшие шаги
- Синхронизация клиентов: сопоставление клиентов Stripe с вашей системой учёта
- Стройте в Tajo автоматизации напоминаний о неоплате и возврата клиентов по изменениям статуса подписки