Finanças e pagamentos
Stripe no seu produto e nos seus agentes de IA, por uma API
O toolkit do Stripe cobre clientes, cobranças, assinaturas e faturas, com busca, criação de clientes e de faturas em rascunho e atualização de assinaturas. Seu cliente conecta uma vez com uma API key, e seu produto ou agente de IA chama cada operação pelo Connect, que guarda a credencial e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/stripe_create_customer/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Como funciona
Do cliente conectado à primeira chamada no Stripe.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Stripe. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Stripe.
Visões de cobrança no seu produto
Busque assinaturas, faturas e cobranças de um cliente por status ou data para mostrar o histórico de cobrança dentro do seu SaaS ou painel de agência.
Faturar a partir do seu fluxo
Crie um cliente, uma fatura em rascunho e suas linhas, e finalize e envie por email com Send invoice quando um trabalho ou projeto terminar.
Perguntas de receita para um agente
Deixe um agente de IA buscar assinaturas novas ou canceladas em um período, ou definir cancel_at_period_end em uma assinatura, dentro de um fluxo de retenção.
Tools
12 tools do Stripe
- Buscar clientesGETBusca clientes com a linguagem de consulta de busca do Stripe, por email, nome, telefone, data de criação ou metadata. A resposta traz data, has_more e next_page; envie next_page como page para a próxima página. Um cliente criado ou atualizado no último minuto pode ainda não aparecer.
- Obter clienteGETRetorna um cliente, com nome, email, telefone, endereço, saldo em centavos e configurações de fatura. Um cliente excluído volta apenas com id e deleted true.
- Criar clientePOSTCria um cliente. Nenhum campo é obrigatório, mas o Stripe só envia faturas e recibos a clientes com email. Endereço, tax ids e metadata não estão disponíveis aqui.
- Atualizar clientePOSTAtualiza o nome, o email, o telefone ou a descrição de um cliente. Os campos não enviados permanecem como estão.
- Buscar cobrançasGETBusca as cobranças, que são as tentativas de pagamento com status, valor, reembolsos e disputas, com a linguagem de consulta de busca do Stripe. Os valores estão na menor unidade da moeda, como centavos. A resposta traz data, has_more e next_page; envie next_page como page para a próxima página.
- Listar assinaturasGETLista as assinaturas, da mais nova à mais antiga, opcionalmente de um cliente, um preço ou um status. Sem status, assinaturas canceladas ficam de fora. Cada assinatura traz seus preços em items.data. Pagine com starting_after enquanto has_more for true.
- Buscar assinaturasGETBusca assinaturas por status, data de criação, data de cancelamento ou metadata com a linguagem de consulta de busca do Stripe, o que serve para perguntas como assinaturas novas ou canceladas em um período. A resposta traz data, has_more e next_page; envie next_page como page para a próxima página.
- Atualizar assinaturaPOSTAtualiza uma assinatura, por exemplo para cancelá-la no fim do período atual com cancel_at_period_end, ou para desfazer isso. Alterar os itens ou preços da assinatura não está disponível aqui.
- Buscar faturasGETBusca faturas por cliente, assinatura, status, data, total ou número com a linguagem de consulta de busca do Stripe. Os valores estão na menor unidade da moeda, como centavos. A resposta traz data, has_more e next_page; envie next_page como page para a próxima página.
- Criar faturaPOSTCria uma fatura em rascunho para um cliente. Adicione as linhas com Create invoice item e envie por email com Send invoice. Com collection_method send_invoice, envie days_until_due ou due_date.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
Perguntas sobre o toolkit do Stripe
Preciso implementar a API do Stripe?
Não. O Connect já traz 12 tools do Stripe descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Stripe?
Pelo modo que o toolkit aceita: Chave de API. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Toolkits da mesma categoria
Ver os 100 toolkitsVeja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.

Conta Azul