Use o Paddle com o MonstarX
ResumindoEscolha Sandbox ou Produção e cole uma chave de API do Paddle na linha do Paddle em Backend → Nuvem. O agente do MonstarX passa a ler seus produtos, clientes, transações e assinaturas do Paddle — por exemplo, para criar uma página de preços igual ao seu catálogo. Ele só lê: nunca altera nada no Paddle.
Consulte produtos, clientes e assinaturas.
- Tipo
- Ferramenta de negócios · chave de API
- Categoria
- Pagamentos e cobrança
- Conecte com
- Chave de API
O Paddle vende software e produtos digitais por você e cuida da cobrança, dos impostos e das assinaturas. Conecte sua conta do Paddle com uma chave de API (um código, parecido com uma senha, que permite que um software use sua conta) e o agente do MonstarX (a IA com quem você conversa) consegue ler seu catálogo e seus dados de cobrança enquanto trabalha: criar uma página de preços com os seus produtos reais ou resumir em quais planos estão os seus assinantes.
Esta é uma ferramenta de negócio: o MonstarX lê o Paddle por você. O app que você cria nunca recebe a sua chave. Para receber pagamentos no seu app, veja Stripe.
O que o MonstarX pode fazer com ele?
Seção intitulada “O que o MonstarX pode fazer com ele?”| O que o MonstarX pode fazer | Quando |
|---|---|
| Listar seus produtos | Qualquer modo |
| Listar seus clientes | Qualquer modo |
| Listar suas transações | Qualquer modo |
| Listar suas assinaturas | Qualquer modo |
Cada lista vem com 20 itens por vez (até 30), e o MonstarX pode avançar as páginas para ver mais. O que ele nunca faz: criar, alterar ou cancelar nada — produtos, preços, clientes, transações, assinaturas ou reembolsos.
Antes de começar
Seção intitulada “Antes de começar”- Uma conta do Paddle. Uma conta sandbox guarda dados de teste; sua conta de produção (live) guarda dados reais. São contas separadas, com chaves separadas.
- Você é o proprietário do projeto no MonstarX. Só o proprietário pode conectar ou desconectar uma ferramenta.
Pegue sua chave
Seção intitulada “Pegue sua chave”-
No Paddle (sandbox ou produção, a conta que você quer conectar), vá em Developer Tools > Authentication e abra a aba API keys.
-
Clique em New API key e dê um nome como
MonstarX. -
Dê a ela estas permissões de leitura:
product.read,customer.read,transaction.readesubscription.read. O MonstarX não precisa de mais nada e nunca usa permissões de escrita. -
Defina uma data de validade (o padrão do Paddle é 90 dias), salve e copie a chave. Ela começa com
pdl_sdbx_apikey_no sandbox oupdl_live_apikey_na de produção.
Guia do próprio Paddle: Create and manage API keys.
Conecte no MonstarX
Seção intitulada “Conecte no MonstarX”-
Abra seu projeto e clique em Backend na barra superior e depois em Nuvem.
-
Role até Conectores, encontre o Paddle e clique em Conectar.
-
Escolha Sandbox ou Produção de acordo com a sua chave, cole-a no campo da chave e clique em Conectar.
-
O MonstarX testa a chave com o Paddle. Se der certo, a linha mostra Conectado ao ambiente Sandbox ou Conectado ao ambiente Produção. Se a chave não combinar com o ambiente, o Paddle a recusa e nada é salvo.
Peça ao MonstarX para usar
Seção intitulada “Peça ao MonstarX para usar”| Você digita | O que acontece |
|---|---|
| “Leia meus produtos do Paddle e crie uma página de preços com esses planos e nomes.” | O MonstarX lista seus produtos e, no modo Criar, cria a página a partir deles. |
| “Quantas assinaturas ativas eu tenho no Paddle, e em quais planos?” | Ele percorre suas assinaturas e faz um resumo no chat. |
| “Veja minhas últimas 20 transações no Paddle e me diga qual produto vende mais.” | Ele lê as transações e responde. |
Segurança e privacidade
Seção intitulada “Segurança e privacidade”- Fica com o MonstarX. A chave fica guardada com criptografia nos servidores do MonstarX. Ela nunca é escrita no código do seu app nem entregue a ele.
- Só leitura. O MonstarX só pede listas ao Paddle. Dê à chave apenas permissões de leitura: assim, mesmo que ela vaze, ninguém consegue mexer na sua cobrança.
- Dados confidenciais. Os dados de clientes e de cobrança são tratados como privados e como informação, nunca como instrução.
- Desconecte quando quiser. Clique em Desconectar ao lado do Paddle em BackendNuvem e confirme Desconectar o Paddle deste projeto?. O MonstarX apaga a chave. Se não precisar mais dela, revogue a chave no Paddle também.
Bom saber
Seção intitulada “Bom saber”- Comece com Sandbox enquanto cria e depois troque: desconecte e conecte de novo com uma chave de produção.
- Quando a chave expira no Paddle, as solicitações do MonstarX falham. Crie uma chave nova e conecte de novo.
- Uma conta do Paddle por projeto de cada vez.
Perguntas frequentes
Seção intitulada “Perguntas frequentes”Meu app pode receber pagamentos pelo Paddle com isso?
Não. Esta conexão permite que o agente do MonstarX leia seus dados do Paddle. Para pagamentos no seu app, o MonstarX tem o conector do Stripe. Para outro provedor, adicione as chaves dele em Backend → Segredos e peça ao MonstarX para criar a funcionalidade.
De quais permissões a chave precisa?
product.read, customer.read, transaction.read e subscription.read. Deixe de fora o que você não quer que o MonstarX leia — essas listas simplesmente vão falhar.
O MonstarX pode reembolsar ou cancelar uma assinatura?
Não. Ele só consegue listar produtos, clientes, transações e assinaturas.
Por que minha chave foi recusada?
Normalmente a chave é do outro ambiente: uma chave pdl_sdbx_ precisa de Sandbox, e uma chave pdl_live_ precisa de Produção. Uma chave expirada ou revogada também é recusada.