• SUCCESS
  • PENDING
  • REVERSED
  • MANUAL

Como processar e estornar pagamentos com sua IA

Conecte a Nuvei ao seu agente para gerenciar todo o ciclo de transações sem sair da janela de chat.

Pergunte à IA sobre esta página

Resposta rápida

Consigo gerenciar transações da Nuvei pelo meu IA?

Sim. Seu agente usa as ferramentas da Nuvei para autorizar cobranças, capturar valores e lidar com reembolsos ou cancelamentos diretamente no chat. Você verá o resultado de cada transação na hora.

Resultados das transações

Para onde o dinheiro vai

Cada comando enviado ao seu agente resulta em um destes quatro estados.

SUCCESS

Valores capturados

O agente conclui o processo de pagamento. Você receberá uma confirmação assim que o dinheiro for movido com sucesso.

PENDING

Autorização retida

O agente reserva o valor no cartão do cliente. A transação fica pendente até que você realize a captura.

REVERSED

Reembolsos e cancelamentos

O agente devolve o dinheiro ao cliente ou cancela uma cobrança pendente. Você receberá um comprovante do estorno.

MANUAL

Intervenção humana

Se uma transação falhar ou exigir verificação extra, o agente parará e pedirá que você resolva pelo painel da Nuvei.

O fluxo

O que sua IA faz quando chega um pedido de pagamento.

Seu agente transforma suas instruções em linguagem natural em chamadas de API específicas para a Nuvei.

  1. Reservar os valores

    O agente verifica os dados do cliente e solicita uma autorização inicial para garantir que há saldo disponível.

    create_payment

  2. Finalizar a venda

    Assim que você confirmar que o pedido está pronto, o agente transfere os valores autorizados para sua conta.

    capture_payment

  3. Cancelar pedidos pendentes

    Se o cliente desistir antes da captura do valor, o agente cancela a transação imediatamente.

    void_payment

  4. Devolver o dinheiro

    Para vendas concluídas que precisam de estorno, o agente processa o reembolso pelo método de pagamento original.

    refund_payment

Teste

Copie estes comandos para começar.

Use estes prompts para acionar ações na Nuvei.

Pontos de partida

Substitua as informações entre colchetes pelos nomes dos clientes, valores ou IDs de transação reais.

Nuvei Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Nuvei capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "nuvei-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/mcp"
    }
  }
}
Copie no chat04

  • Crie um novo pagamento de R$ 50,00 para o cliente Jane Doe.

  • Capture o pagamento da transação ID 98765.

  • Reembolse a última cobrança de R$ 25,00 do cliente Acme Corp.

  • Cancele a autorização pendente do pedido #12345.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte a Nuvei uma vez e pronto.

Faça login na sua conta Nuvei através da interface do Vinkius. Uma vez conectado, seu agente poderá gerenciar seus pagamentos imediatamente.

Conectar Nuvei ao seu IA

FAQ

Como o MCP da Nuvei funciona

  • 01

    Minha IA pode alterar as configurações da minha conta Nuvei?

    Não. O agente tem permissão apenas para realizar as ações de pagamento específicas listadas em seu conjunto de ferramentas.

  • 02

    A IA manipula os números reais do cartão de crédito?

    Não. O agente interage com IDs de transação e valores. Ele não visualiza nem armazena dados brutos de cartões.

  • 03

    Posso pedir para a IA listar todas as minhas transações passadas?

    Não. Este conector específico foi criado para processar e estornar pagamentos, não para recuperar histórico de transações.

  • 04

    O que acontece se um reembolso falhar?

    O agente informará a mensagem de erro retornada pela Nuvei. Você precisará acessar o painel da Nuvei para resolver o problema.

  • 05

    A IA pode excluir uma transação inteira?

    Não. O agente pode cancelar um pagamento pendente ou reembolsar um capturado, mas não pode apagar registros do seu histórico na Nuvei.

  • Mais dúvidas sobre a Nuvei? A página do conector responde. Veja tudo o que o MCP da Nuvei pode fazer

Conecte Nuvei ao Claude, Cursor, ChatGPT e outros