Paddle
Renta выгружает в ваше хранилище данных шесть объектов Paddle: клиентов, продукты, цены, подписки, транзакции с платежами и позициями, а также корректировки, то есть возвраты, кредиты и чарджбэки.
Поля каждого объекта вы выбираете сами. Каждый запуск заново читает полный список записей из Paddle, поэтому таблицы следуют за текущим состоянием аккаунта: новые записи, смены статусов и правки приходят со следующим запуском.
Аутентификация
Renta подключается к Paddle по API-ключу. Создайте ключ в Paddle Dashboard в разделе Developer tools > Authentication и вставьте его в форму подключения.
Подключение источника Paddle
Выполните эти шаги, чтобы добавить Paddle как источник в Renta с помощью API-ключа.
- Перейдите в раздел Connections > Catalog в левом меню.
- Откройте категорию Finance и нажмите на карточку Paddle.
- Source name.
Отображаемое имя подключения. Используется только в интерфейсе Renta. - API key.
Вставьте API-ключ из Paddle Dashboard.
- Проверьте Source name.
- Нажмите Save.
Перед сохранением Renta проверяет ключ в Paddle, поэтому недействительный ключ или ключ без прав на чтение не пройдёт этот шаг.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
После подключения источника создайте пайплайн, чтобы загружать данные Paddle в ваше хранилище.
Создание пайплайна Paddle
Свяжите источник Paddle с хранилищем и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите Paddle в списке и нажмите Next step.
Выберите созданное ранее подключение Paddle и нажмите Next step. На карточке видно имя подключения и дату добавления.
На шаге Destination выберите хранилище (например, Google BigQuery) и нажмите Next step.
Выберите подключение хранилища и нажмите Next step. На карточке видно датасет и проект, куда попадут данные.
Настройка пайплайна
На последнем шаге выберите тип отчёта, отметьте его поля, задайте имя таблицы и расписание.
Тип отчёта
Выберите, какой объект Paddle попадёт в хранилище. Один пайплайн загружает один тип отчёта.
| Тип отчёта | Описание |
|---|---|
| Customers (клиенты) | Клиенты аккаунта: имя, email, статус, локаль, согласие на рассылки и ваши пользовательские данные. |
| Products (продукты) | Каталог продуктов: название, описание, тип, статус, налоговая категория и ссылка на изображение. |
| Prices (цены) | Цены продуктов: сумма и валюта, платёжный цикл, ограничения количества, пробный период, налоговый режим и особые цены для отдельных стран. |
| Adjustments (корректировки) | Возвраты, кредиты и чарджбэки: действие, статус, причина, итоги в валюте транзакции и валюте выплаты, разбивка по позициям. |
| Subscriptions (подписки) | Подписки: статус, платёжный цикл, даты начала, первого списания, паузы и отмены, позиции подписки, скидка и запланированное изменение. |
| Transactions (транзакции) | Платёжная история аккаунта: статус, происхождение, номер инвойса, итоги до и после корректировок в валюте транзакции и валюте выплаты, позиции, налоговые ставки и попытки оплаты. |
Параметры
Отметьте поля Paddle, которые попадут в таблицу назначения.
Под каждым полем подписано, как будет называться его колонка в таблице назначения. Чтобы выбрать все поля сразу, нажмите Select All. Всё выбранное собрано на вкладке Selected.
Денежные суммы Paddle отдаёт строками в минимальных единицах валюты, и Renta загружает их как есть: платёж на $100.00 придёт как 10000. В запросах приводите эти колонки к числу. Временные метки приходят обычными datetime-колонками, а Created Date At содержит готовую дату создания записи.
Поля со списком значений загружаются вложенными записями.
| Тип отчёта | Поля, которые загружаются вложенными записями |
|---|---|
| Adjustments | Items, Tax Rates Used |
| Subscriptions | Items |
| Transactions | Items, Details Line Items, Details Tax Rates Used, Payments |
Имя таблицы
Задайте имя таблицы назначения. Оставьте автоматически созданное или введите своё. В data lake оно станет именем папки.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска) и нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL. Там видны запуски, их прогресс и имя таблицы назначения.
Стратегия синхронизации
Все типы отчётов Paddle работают в режиме полной перезагрузки.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Полная перезагрузка | Customers, Products, Prices, Adjustments, Subscriptions, Transactions | При каждом запуске Renta читает полный список записей выбранного объекта и заменяет содержимое таблицы назначения. Таблица отражает текущее состояние аккаунта: изменения, сделанные в Paddle после загрузки записи, придут со следующим запуском. |
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.