Paddle в MonstarX

Q: Какие права нужны ключу?

product.read, customer.read, transaction.read и subscription.read. Не давайте права на то, что MonstarX читать не должен, — эти списки просто не загрузятся.

Q: Почему мой ключ отклонён?

Чаще всего ключ от другого режима: ключу pdl_sdbx_ нужен Тестовый режим, ключу pdl_live_ — Рабочий режим. Ключ с истёкшим сроком или отозванный ключ тоже отклоняется.

КраткоВыберите тестовый или рабочий режим и вставьте ключ API Paddle в строку Paddle в разделе «Облачные сервисы» → «Облако». После этого конструктор MonstarX сможет читать ваши товары, клиентов, транзакции и подписки в Paddle — например, чтобы создать страницу с ценами, которая совпадает с вашим каталогом. Он только читает и ничего не меняет в Paddle.

Находит товары, клиентов и подписки.

Тип: Рабочий сервис · ключ API
Категория: Платежи и подписки
Как подключить: Ключ API

Paddle продаёт программы и цифровые товары от вашего имени и берёт на себя оплату, налоги и подписки. Подключите свой аккаунт Paddle по ключу API (коду вроде пароля, через который программа пользуется вашим аккаунтом), и конструктор MonstarX — ИИ, с которым вы общаетесь в чате, — сможет во время работы читать ваш каталог и платёжные данные: создать страницу с ценами по вашим реальным товарам или подвести итог, какие тарифы у ваших подписчиков.

Это рабочий сервис: MonstarX читает Paddle за вас. Само приложение, которое вы создаёте, ваш ключ никогда не получает. Чтобы принимать оплату в приложении, см. Stripe.

Что может MonstarX?

Что может MonstarX	Когда
Показать ваши товары	В любом режиме
Показать ваших клиентов	В любом режиме
Показать ваши транзакции	В любом режиме
Показать ваши подписки	В любом режиме

Каждый список приходит по 20 записей за раз (максимум 30), и MonstarX может листать дальше. Чего MonstarX никогда не делает: не создаёт, не меняет и не отменяет ничего — ни товары, ни цены, ни клиентов, ни транзакции, ни подписки, ни возвраты.

Что понадобится

Аккаунт Paddle. В тестовом аккаунте (sandbox) — тестовые данные, в рабочем (live) — настоящие. Это разные аккаунты с разными ключами.
Вы — владелец проекта в MonstarX. Подключать и отключать сервисы может только владелец.

Получите ключ

В Paddle (в тестовом или рабочем аккаунте — какой хотите подключить) откройте Developer Tools > Authentication и вкладку API keys.
Нажмите New API key и задайте имя, например MonstarX.
Дайте ключу права на чтение: product.read, customer.read, transaction.read и subscription.read. Больше MonstarX ничего не нужно, и права на запись он никогда не использует.
Задайте срок действия (по умолчанию в Paddle — 90 дней), сохраните и скопируйте ключ. Он начинается с pdl_sdbx_apikey_ для тестового аккаунта или с pdl_live_apikey_ для рабочего.

Инструкция Paddle: Create and manage API keys.

Подключите ключ в MonstarX

Откройте проект, нажмите Облачные сервисы на верхней панели, затем Облако.
Прокрутите до раздела Подключения, найдите Paddle и нажмите Подключить.
Выберите Тестовый режим или Рабочий режим — в зависимости от ключа, вставьте ключ в поле Ключ API Paddle и нажмите Подключить.
MonstarX проверяет ключ в Paddle. Если всё в порядке, в строке появится Подключено: Тестовый режим или Подключено: Рабочий режим. Если ключ не соответствует выбранному режиму, Paddle его отклонит, и ничего не сохранится.

Как попросить MonstarX

Вы пишете	Что происходит
«Посмотри мои товары в Paddle и сделай страницу с ценами с этими тарифами и названиями.»	MonstarX получает список товаров и в режиме Создать создаёт по ним страницу.
«Сколько у меня активных подписок в Paddle и на каких тарифах?»	MonstarX листает подписки и подводит итог в чате.
«Посмотри мои последние 20 транзакций в Paddle и скажи, какой товар продаётся лучше всего.»	MonstarX читает транзакции и отвечает.

Безопасность и конфиденциальность

Ключ остаётся в MonstarX. Он хранится в зашифрованном виде на серверах MonstarX, никогда не попадает в код приложения и не передаётся самому приложению.
Только чтение. MonstarX запрашивает у Paddle только списки. Дайте ключу только права на чтение — тогда даже утёкший ключ не сможет ничего изменить в вашей оплате.
Конфиденциальные данные. Данные клиентов и платежей MonstarX считает конфиденциальными и воспринимает как информацию, а не как инструкции.
Отключить можно в любой момент. Нажмите Отключить рядом с Paddle в разделе Облачные сервисыОблако и подтвердите вопрос Отключить Paddle от этого проекта?. MonstarX удалит ключ. Если ключ больше не нужен, отзовите его и в Paddle.

Полезно знать

Пока создаёте приложение, выбирайте Тестовый режим, а потом переключитесь: отключите Paddle и подключите заново с рабочим ключом.
Когда срок действия ключа в Paddle истечёт, запросы MonstarX перестанут проходить. Создайте новый ключ и подключите его заново.
К одному проекту можно одновременно подключить только один аккаунт Paddle.

Вопросы и ответы

Может ли приложение принимать оплату через Paddle с помощью этого подключения?

Нет. Это подключение позволяет конструктору MonstarX читать ваши данные в Paddle. Для оплаты в приложении у MonstarX есть подключение Stripe. Для другого платёжного сервиса добавьте его ключи в разделе Облачные сервисы → Секреты и попросите MonstarX создать оплату.

Какие права нужны ключу?

product.read, customer.read, transaction.read и subscription.read. Не давайте права на то, что MonstarX читать не должен, — эти списки просто не загрузятся.

Может ли MonstarX оформить возврат или отменить подписку?

Нет. Он может только показывать товары, клиентов, транзакции и подписки.

Почему мой ключ отклонён?

Чаще всего ключ от другого режима: ключу pdl_sdbx_ нужен Тестовый режим, ключу pdl_live_ — Рабочий режим. Ключ с истёкшим сроком или отозванный ключ тоже отклоняется.