Stripe
Renta выгружает данные Stripe в ваше хранилище: платежи, счета, подписки, клиентов, выплаты и другие объекты аккаунта.
Аутентификация
Renta подключается к Stripe по API-ключу: секретному ключу аккаунта или restricted-ключу. Ключ создаётся в Stripe Dashboard в разделе Developers > API keys и вставляется в форму подключения.
Подключение источника Stripe
Выполните эти шаги, чтобы добавить Stripe как источник в Renta по API-ключу.
- Перейдите в раздел Connections > Catalog в левом меню.
- Откройте категорию Finance и нажмите карточку Stripe.
- Source name.
Название подключения. Используется только в интерфейсе Renta. - API key.
Вставьте ваш секретный или restricted-ключ Stripe.
- Проверьте Source name.
- Нажмите Save.
Перед сохранением Renta проверяет ключ на стороне Stripe, поэтому недействительный ключ или restricted-ключ без права на чтение Customers отклоняется прямо на этом шаге.
Новый источник появляется в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
После подключения источника создайте пайплайн, чтобы выгружать данные Stripe в хранилище.
Создание пайплайна Stripe
Свяжите источник Stripe с назначением и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите Stripe в списке Already connected и нажмите Next step.
Выберите подключение Stripe, созданное ранее, и нажмите Next step. На карточке видны название подключения и дата его добавления.
На шаге Destination выберите ваше назначени е (например, Google BigQuery) и нажмите Next step.
Выберите подключение, в которое нужно загружать данные, и нажмите Next step. На карточке видны датасет и проект, куда попадут данные.
Настройка пайплайна
На последнем шаге выберите тип отчёта, отметьте его поля и задайте диапазон дат и расписание.
Тип отчёта
Выберите, какой объект Stripe выгружает пайплайн. Один пайплайн загружает один тип отчёта.
| Тип отчёта | Описание |
|---|---|
| Balance Transactions | Все движения баланса Stripe: платежи, возвраты, переводы, выплаты и комиссии Stripe, с валовой суммой, комиссией и её разбивкой, а также чистой суммой. Суммы списаний отрицательные. |
| Charges | Платежи с суммой, статусом и валютой, данными карты и плательщика, оценкой риска, ссылками на чеки и идентификаторами клиента, счёта и платёжного намерения. |
| Coupons | Купоны на скидку: фиксированная сумма или процент, длительность, лимиты применения и срок действия. |
| Credit Notes | Кредитные ноты, выпущенные по счетам: итоги, причина, статус, кредитуемые строки и связанные возвраты. |
| Customers | Клиенты с email, именем, валютой, балансом аккаунта, признаком просрочки, настройками счетов и вашими метаданными. |
| Disputes | Оспоренные платежи с оспариваемой суммой, причиной, статусом и состоянием доказательств. |
| Invoice Line Items | Отдельные строки счетов: сумма, валюта, количество, расчётный пе риод и идентификаторы цены и подписки. |
| Invoices | Счета с итогами, суммами к оплате, оплаченными и оставшимися, статусом, причиной выставления, способом оплаты и временными метками смены статусов. |
| Payment Intents | Платёжные намерения с суммой, статусом, доступными способами оплаты, причиной отмены и деталями последней ошибки платежа. |
| Payouts | Выплаты на банковский счёт или карту: сумма, валюта, статус, способ и дата поступления. |
| Plans | Тарифные планы устаревшей модели подписок: сумма, валюта, интервал списания и тип использования. |
| Prices | Цены ваших продуктов: сумма за единицу, валюта, схема тарификации и интервал повторения. |
| Products | Каталог продуктов: название, описание, признак активности, изображения и атрибуты. |
| Refunds | Возвраты с суммой, валютой, статусом, причиной и идентификаторами платежа и платёжного намерения. |
| Subscriptions | Подписки со статусом, расчётным периодом, датами пробного периода, деталями отмены и позициями подписки с привязанными ценами. |
Параметры
Выберите поля Stripe, которые попадут в таблицу назначения.
Имя колонки в таблице назначения указано под каждым полем. Select All отмечает полный набор, результат виден на вкладке Selected.
Набор доступных полей зависит от типа отчёта. По полю Created Date (готовой дате из временной метки создания) Renta партиционирует таблицу назначения, а инкрементальная загрузка работает только тогда, когда оно выбрано.
Stripe отдаёт денежные суммы в минимальных единицах валюты, и Renta загружает их без изменений: платёж на $19.99 приходит как 1999. Временные метки, такие как Created, приходят в Unix-секундах. Created Date остаётся единственной готовой колонкой с датой.
Поля, которые ссылаются на другой объект Stripe, содержат его идентификатор: поле Customer платежа хранит ID клиента. Чтобы получить атрибуты связанного объекта, создайте пайплайн для его типа отчёта и соедините таблицы по ID. Вложенные объекты приходят разложенными на отдельные колонки с префиксом родителя, например данные плательщика и способа оплаты у платежа.
Поля со списками значений загружаются вложенными записями.
| Тип отчёта | Поля, которые загружаются вложенными записями |
|---|---|
| Balance Transactions | Fee Details |
| Credit Notes | Lines, Refunds |
| Invoices | Custom Fields |
| Subscriptions | Items |
Имя таблицы
Назовите пайплайн и таблицу назначения.
- Integration name.
Название пайплайна. Используется только в интерфейсе Renta. - Table name.
Имя таблицы назначения. Можно оставить автоматически созданное имя или задать своё.
Диапазон дат
Задайте период, который покрывает пайплайн. Renta отбирает записи по дате их создания в Stripe.
- Date start.
Первая дата периода. - Date end.
Последняя дата периода. Оставьте Today, чтобы конец периода сдвигался с каждым запуском.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска) и нажмите Create pipeline.
Новый пайплайн появляется в разделе Pipelines на вкладке ETL, где видны его запуски, прогресс и имя таблицы назначения.
Стратегия синхронизации
Как Renta синхронизирует тип отчёта Stripe, зависит от того, выбран ли параметр Created Date.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | Balance Transactions, Charges, Coupons, Credit Notes, Customers, Disputes, Invoices, Payment Intents, Payouts, Plans, Prices, Products, Refunds, Subscriptions (с выбранным параметром Created Date) | Таблица назначения партиционируется по дню создания записи. Renta отбирает записи по дате создания, поэтому каждый запуск забирает записи, созданные после предыдущего, и заменяет только затронутые дневные партиции. Первый запуск загружает весь настроенный диапазон дат. |
| Полная перезагрузка | Invoice Line Items, а также перечисленные выше типы отчётов без выбранного параметра Created Date | Renta перечитывает весь настроенный диапазон дат на каждом запуске и заменяет содержимое таблицы назначения. У строк счетов нет собственной даты создания, поэтому этот тип отчёта всегда работает так. |
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.