Saltar para o conteúdo

Integração · Pagamentos

Conecte Claude e ChatGPT ao Paddle

Pergunte à sua IA sobre o seu MRR do mês passado ou quais as assinaturas que renovam esta semana, e ela lê a resposta do Paddle. Ela pode criar clientes, produtos, preços e descontos, alterar ou cancelar assinaturas, emitir faturas e lidar com reembolsos e créditos.

Ligar Paddle gratuitamente

Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.

Experimente pedir

  • “Qual foi o nosso MRR no início e no final de setembro?”

    A IA retira o MRR diário de setembro e compara o primeiro e o último dia.

  • “Mostre a assinatura e a próxima data de faturação para [email protected].”

    Ela encontra o cliente, lista as suas assinaturas e lê os itens, status e próxima data de faturação.

  • “Reembolsar a transação txn_01h8 integralmente. Motivo: cobrança duplicada.”

    Ela cria um reembolso integral na transação concluída com esse motivo.

O que a sua IA pode fazer

Métricas de receita

Ler MRR, receita líquida e assinantes ativos por dia para qualquer intervalo de datas.

Assinaturas e transações

Consultar, alterar e cancelar assinaturas, criar transações para faturação, obter PDFs de fatura e listar reembolsos e créditos.

Catálogo e clientes

Criar e atualizar produtos, preços, descontos e clientes, e pesquisar clientes por nome ou email.

  • “Pegue-me o PDF da fatura do último pagamento da Acme.”

    Ela encontra a última transação da Acme e retorna um link para o seu PDF de fatura.

  • “Criar um código de desconto de 15% SPRING15 limitado a 100 usos.”

    Ela cria um desconto percentual com o código de checkout e limite de uso.

  • “Cancelar a assinatura de Tom no final do período de faturação.”

    Ela cancela a assinatura a partir da próxima data de faturação, para que ela rode até ao fim do período atual.

99 ferramentas para Paddle

Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.

  • cancel_subscriptionElimina dadosCancele uma assinatura por `subscription_id`, seja no final do período de faturamento ou imediatamente (`effective_from`). O cancelamento imediato não pode ser desfeito.
  • create_a_customer_portal_sessionAltera dadosCrie uma nova sessão de portal do cliente. Pesquise clientes primeiro para evitar duplicatas. Resumo da API: Criar uma sessão de portal do cliente.
  • create_customerAltera dadosCrie um cliente com `email` e nome/idioma opcionais. Pesquise primeiro para evitar duplicatas.
  • create_customer_2Elimina dadosCrie um novo cliente. Obrigatório: nome. Pesquise clientes primeiro para evitar duplicatas. Ação destrutiva; pode exigir aprovação. Resumo da API: Criar um token do lado do cliente.
  • create_customer_addressAltera dadosCrie um novo endereço para um cliente. Obrigatório: código do país. Pesquise endereços primeiro para evitar duplicatas. Resumo da API: Criar um endereço para um cliente.
  • create_customer_auth_tokenElimina dadosCrie um novo token de autenticação para um cliente. Ação destrutiva; pode exigir aprovação. Resumo da API: Gerar um token de autenticação para um cliente.
  • create_customer_companyAltera dadosCrie uma nova empresa para um cliente. Obrigatório: nome. Pesquise empresas primeiro para evitar duplicatas. Resumo da API: Criar um negócio para um cliente.
  • create_discountAltera dadosCrie um desconto com `type` (porcentagem ou valor fixo), `amount` e `description`, além de checkout opcional `code`, expiração e limite de uso.
  • create_discount_groupAltera dadosCrie um novo grupo de descontos. Obrigatório: nome. Resumo da API: Criar um grupo de desconto.
  • create_event_replayAltera dadosCrie uma nova replay para um evento. Resumo da API: Replayar um evento para uma execução de simulação.
  • create_notification_replayAltera dadosCrie uma nova replay para uma notificação. Resumo da API: Replayar uma notificação.
  • create_notification_settingAltera dadosCrie uma nova configuração de notificação. Obrigatório: descrição, tipo, destino ou eventos assinados. Resumo da API: Criar uma configuração de notificação.
  • create_payment_revise_transactionAltera dadosCrie um novo pagamento para um pagamento. Resumo da API: Revisar informações do cliente em uma transação cobrada ou concluída.
  • create_priceAltera dadosCrie um preço para um `product_id` com `unit_price` (valor na unidade menor + moeda) e `description`; adicione `billing_cycle` para preços recorrentes.
  • create_pricing_previewAltera dadosCriar uma nova prévia de precificação. Obrigatório: itens. Resumo da API: Visualizar preços.
  • create_productAltera dadosCriar um produto com `name` e `tax_category`, além de descrição e imagem opcionais.
  • create_refundAltera dadosReembese ou credite uma transação concluída: passe `transaction_id`, `action` (reembolso ou crédito), `reason` e `type` (total ou parcial com `items`). Reembolsos devolvem dinheiro ao cliente e não podem ser desfeitos.
  • create_reportAltera dadosCriar um novo relatório. Obrigatório: corpo. Resumo da API: Criar um relatório.
  • create_simulationAltera dadosCriar uma nova simulação. Obrigatório: corpo. Resumo da API: Criar uma simulação.
  • create_simulation_runAltera dadosCriar uma nova execução para uma simulação. Resumo da API: Criar uma execução de simulação.
  • create_subscriptionAltera dadosCriar uma nova assinatura para uma assinatura. Resumo da API: Pausar uma assinatura.
  • create_subscription_resume_subscriptionAltera dadosCriar uma nova assinatura para uma assinatura. Obrigatório: corpo. Resumo da API: Retomar uma assinatura pausada.
  • create_transactionAltera dadosCrie uma transação a partir de `items` (IDs e quantidades de preço) para um cliente, ex. para emitir uma fatura ou checkout. Defina `collection_mode` manual para fatura.
  • delete_customer_payment_methodElimina dadosExcluir permanentemente um método de pagamento pelo ID do método de pagamento. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir um método de pagamento de um cliente.
  • delete_notification_settingElimina dadosExcluir permanentemente uma configuração de notificação pelo ID da configuração de notificação. Ação destrutiva; pode exigir aprovação.
  • delete_paymentElimina dadosExcluir permanentemente um pagamento pelo ID do domínio. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir um domínio de checkout.
  • download_report_urlBaixar o documento para um relatório. Resumo da API: Obter um arquivo CSV para um relatório.
  • get_active_subscriber_metricsObter o número de assinantes ativos por dia entre as datas `from` e `to`.
  • get_customerObter um cliente pelo `customer_id` (ctm_...), incluindo nome, e-mail e status.
  • get_customer_2Obter um cliente pelo ID do cliente. Resumo da API: Obter um token de lado do cliente.
  • get_customer_addressObter um endereço para um cliente pelo ID do endereço. Resumo da API: Obter um endereço de um cliente.
  • get_customer_companyObter uma empresa para um cliente pelo ID da empresa. Resumo da API: Obter um negócio de um cliente.
  • get_customer_payment_methodObter um método de pagamento para um cliente pelo ID do método de pagamento. Resumo da API: Obter um método de pagamento de um cliente.
  • get_discountObter um desconto pelo `discount_id` (dsc_...).
  • get_discount_groupObter um grupo de desconto pelo ID do grupo de desconto. Resumo da API: Obter um grupo de desconto.
  • get_mrr_metricsObter a receita recorrente mensal (MRR) por dia entre as datas `from` e `to`.
  • get_notificationObter uma notificação pelo ID da notificação. Resumo da API: Obter uma notificação.
  • get_notification_settingObter uma configuração de notificação pelo ID da configuração de notificação. Resumo da API: Obter uma configuração de notificação.
  • get_paymentObter um pagamento pelo ID do domínio. Resumo da API: Obter um domínio de checkout.
  • get_priceObter um preço pelo `price_id` (pri_...).
  • get_productObter um produto pelo `product_id` (pro_...).
  • get_reportObter um relatório por ID de relatório. Resumo da API: Obter um relatório.
  • get_revenue_metricsObter a receita líquida por dia entre as datas `from` e `to`.
  • get_run_eventObter um evento para uma execução pelo ID do evento de simulação. Resumo da API: Obter um evento de uma execução de simulação.
  • get_simulationObter uma simulação pelo ID da simulação. Resumo da API: Obter uma simulação.
  • get_simulation_runObter uma execução para uma simulação pelo ID da execução de simulação. Resumo da API: Obter uma execução de uma simulação.
  • get_subscriptionObter uma assinatura pelo `subscription_id` (sub_...), com itens, status, próxima data de faturamento e alterações agendadas.
  • get_transactionObter uma transação pelo ID (txn_...), incluindo itens, totais, status e pagamentos.
  • get_transaction_invoice_pdfObter um link para o fatura em PDF de uma transitação cobrada ou concluída até `transaction_id`.
  • list_addressesListar endereços. Resumo da API: Obter os endereços IP do Paddle.
  • list_adjustment_credit_notesListar notas de crédito para um ajuste. Filtros opcionais: disposição. Resumo da API: Obter uma nota de crédito em PDF para um ajuste.
  • list_adjustmentsListar ajustes (devoluções e créditos), filtrados por `customer_id`, `transaction_id`, `subscription_id`, `action` ou `status`.
  • list_chargebacksListar cobranças. Filtros opcionais: de ou para. Resumo da API: Obter métricas de cobrança.
  • list_checkout_conversionsListar conversões de checkout. Filtros opcionais: de ou para. Resumo da API: Obter métricas de conversão de checkout.
  • list_customer_credit_balancesListar saldos de crédito de um cliente. Filtros opcionais: código de moeda.
  • list_customer_payment_methodsListar métodos de pagamento de um cliente. Filtros opcionais: ID do endereço, ordenação ou suporte a checkout. Os resultados são paginados.
  • list_customersListar ou pesquisar clientes por `search` texto, `email`, `id` ou `status`. Use para encontrar um ID de cliente.
  • list_customers_2Listar clientes. Filtros opcionais: ordenação ou status. Os resultados são paginados. Resumo da API: Listar tokens do lado do cliente.
  • list_discount_groupsListar grupos de desconto. Filtros opcionais: ID ou ordenação. Os resultados são paginados.
  • list_discountsListar descontos, filtrados por `code`, `status` ou `mode`.
  • list_event_typesListar tipos de evento. Resumo da API: Listar tipos de eventos.
  • list_eventsListar eventos. Filtros opcionais: ordenação ou tipo de evento. Os resultados são paginados.
  • list_monthly_recurring_revenue_changesListar alterações na receita recorrente mensal. Filtros opcionais: de ou para. Resumo da API: Obter métricas de alteração de receita recorrente mensal (MRR).
  • list_notification_logsListar logs para uma notificação. Os resultados são paginados.
  • list_notification_settingsListar configurações de notificação. Filtros opcionais: ordenação, ativa ou fonte de tráfego. Os resultados são paginados.
  • list_paymentsListar pagamentos. Filtros opcionais: ID, domínio, ordenação ou status. Os resultados são paginados. Resumo da API: Listar domínios de checkout.
  • list_pricesListar preços, filtrados por `product_id`, `status`, `recurring` ou ciclo de faturamento.
  • list_productsListar produtos, filtrados por `status`, `type` ou `tax_category`.
  • list_refundsListar devoluções. Filtros opcionais: de ou para. Resumo da API: Obter métricas de devolução.
  • list_reportsListar relatórios. Filtros opcionais: ordenação ou status. Os resultados são paginados.
  • list_run_eventsListar eventos para uma execução. Filtros opcionais: ID ou ordenação. Os resultados são paginados. Resumo da API: Listar eventos para uma execução de simulação.
  • list_simulation_runsListar execuções para uma simulação. Filtros opcionais: ID ou ordenação. Os resultados são paginados.
  • list_simulation_typesListar tipos de simulação.
  • list_simulationsListar simulações. Filtros opcionais: ID, ID da configuração de notificação, ordenação ou status. Os resultados são paginados.
  • list_subscription_historiesListar históricos de uma assinatura. Filtros opcionais: ação, origem, tipo de ator, ID do ator, motivo ou data de ocorrência. Os resultados são paginados. Resumo da API: Listar histórico para uma assinatura.
  • list_subscriptionsListar assinaturas, filtradas por `customer_id`, `status`, `price_id`, `next_billed_at` ou `scheduled_change_action`.
  • list_transactionsListar transações (ordens, renovações, faturas), filtradas por `customer_id`, `subscription_id`, `status`, `invoice_number`, `billed_at` ou `created_at`.
  • pay_subscriptionMovimenta dinheiroCarregar uma assinatura (ID da assinatura). Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Criar um carregamento único para uma assinatura.
  • search_customer_addressesPesquisar endereços para um cliente por ID, ordem, status ou busca. Use isso para encontrar endereços existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Listar endereços para um cliente.
  • search_customer_companiesPesquisar empresas para um cliente por ID, ordem, status ou busca. Use isso para encontrar empresas existentes antes de criar uma nova. Os resultados são paginados. Resumo da API: Listar negócios para um cliente.
  • search_notificationsPesquisar notificações por ID de configuração de notificação, ordem, busca, status, filtro ou destinatário. Use isso para encontrar notificações existentes antes de criar uma nova. Os resultados são paginados. Resumo da API: Listar notificações.
  • submit_paymentMovimenta dinheiroVisualizar um pagamento (ID da assinatura). Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Visualizar um carregamento único para uma assinatura.
  • submit_payment_payment_methodVisível para outras pessoasVerificar um pagamento (ID do domínio). Tem efeitos visíveis fora deste sistema. Resumo da API: Verificar um método de pagamento para um domínio de checkout.
  • submit_payment_previewVisível para outras pessoasVisualizar um pagamento. Tem efeitos visíveis fora deste sistema. Resumo da API: Visualizar uma transação.
  • submit_subscriptionVisível para outras pessoasAtivar uma assinatura (ID da assinatura). Tem efeitos visíveis fora deste sistema. Resumo da API: Ativar uma assinatura de teste.
  • submit_subscription_previewVisível para outras pessoasVisualizar uma assinatura (ID da assinatura). Tem efeitos visíveis fora deste sistema. Resumo da API: Visualizar uma atualização para uma assinatura.
  • update_customerAltera dadosAtualizar o nome, e-mail, idioma, status ou dados personalizados de um cliente por `customer_id`.
  • update_customer_2Elimina dadosAtualizar um cliente existente identificado pelo ID do cliente. Apenas os campos que você passar são alterados. Ação destrutiva; pode exigir aprovação. Resumo da API: Atualizar um token do lado do cliente.
  • update_customer_addressAltera dadosAtualizar um endereço existente identificado pelo ID do endereço. Apenas os campos que você passar são alterados. Resumo da API: Atualizar um endereço para um cliente.
  • update_customer_companyAltera dadosAtualizar uma empresa existente identificada pelo ID da empresa. Apenas os campos passados são alterados. Resumo da API: Atualizar um negócio para um cliente.
  • update_discountAltera dadosAtualizar um desconto existente identificado pelo ID do desconto. Apenas os campos passados são alterados. Resumo da API: Atualizar um desconto.
  • update_discount_groupAltera dadosAtualizar um grupo de desconto existente identificado pelo ID do grupo de desconto. Apenas os campos passados são alterados. Resumo da API: Atualizar um grupo de desconto.
  • update_notification_settingAltera dadosAtualizar uma configuração de notificação existente identificada pelo ID da configuração de notificação. Apenas os campos passados são alterados. Resumo da API: Atualizar uma configuração de notificação.
  • update_paymentAltera dadosAtualizar um pagamento existente identificado pelo ID do pagamento. Apenas os campos passados são alterados. Resumo da API: Atualizar uma transação.
  • update_priceAltera dadosAtualizar o valor, nome, descrição, período de teste ou status de um preço por `price_id`. Assinaturas existentes mantêm seu preço.
  • update_productAltera dadosAtualizar o nome, descrição, imagem, categoria de imposto ou status (arquivado) de um produto por `product_id`.
  • update_simulationAltera dadosAtualizar uma simulação existente identificada pelo ID da simulação. Apenas os campos passados são alterados. Resumo da API: Atualizar uma simulação.
  • update_subscriptionAltera dadosAlterar uma assinatura por `subscription_id`: itens, quantidades, desconto, próxima data de faturamento ou detalhes de faturamento; `proration_billing_mode` controla o cobrimento. Alterações podem cobrar o cliente.
  • update_subscription_payment_method_transactionAltera dadosAtualizar uma assinatura existente identificada pelo ID da assinatura. Resumo da API: Obter uma transação para atualizar o método de pagamento.

Configure em três passos

  1. 1

    Escolha a aplicação

    Crie uma conta gratuita no PipMCP e escolha Paddle na lista de aplicações.

  2. 2

    Cole a sua chave

    Cole uma chave da API do Paddle. Vá em Ferramentas de desenvolvedor > Autenticação, abra a aba Chaves da API, crie uma chave com as permissões necessárias e copie-a. As chaves Live começam com pdl_live_apikey_ e as chaves sandbox com pdl_sdbx_apikey_.

  3. 3

    Adicione a ligação à sua IA

    Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:

    1. Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
    2. Cole a sua ligação no campo URL do servidor MCP remoto.
    3. Ative-o no menu + de uma conversa.

Perguntas

O que pode fazer a IA no Paddle?

A IA pode ler clientes, assinaturas, transações, produtos, preços, descontos e ajustes, e retirar métricas de MRR, receita e assinantes ativos. Ela pode criar clientes, produtos, preços, descontos e transações, alterar ou cancelar assinaturas, obter PDFs de fatura, e reembolsar ou creditar transações concluídas.

Posso testar com o sandbox do Paddle primeiro?

Sim. As chaves sandbox do Paddle começam com pdl_sdbx_apikey_. Conecte uma chave sandbox para tentar reembolsos, preços e alterações de assinatura em dados de teste, e depois conecte uma chave Live quando estiver pronto.

A IA vê a minha chave da API do Paddle?

Não. Sua chave da API está criptografada em repouso e nunca é mostrada à IA. Uma vez salva, ela não é mostrada novamente, nem mesmo a você. A IA funciona apenas através das ferramentas que você ativa.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas. Ações arriscadas, como um reembolso ou cancelamento imediato, podem exigir sua aprovação antes de executar. Todas as chamadas de ferramenta são registradas para que você veja o que a IA fez.

Funciona com o ChatGPT?

Sim. No ChatGPT, vá para Configurações › Aplicações e Conectores › Avançado, ative o Modo Desenvolvedor e adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona no Claude em Configurações › Conectores › Adicionar conector personalizado e no Cursor.

Qual é o custo?

O PipMCP tem um plano gratuito e não precisa de cartão de crédito para começar. Os planos pagos cobram por tarefa concluída, então você paga pelo trabalho que a IA realmente termina.

Deixe a sua IA trabalhar em Paddle ainda hoje.

Comece gratuitamente. A sua chave permanece encriptada e é você quem decide o que a IA pode fazer.

Ligar Paddle gratuitamente

O PipMCP não tem qualquer afiliação com Paddle. Os nomes dos produtos são marcas comerciais dos respetivos titulares.