> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Pagamentos com SumUp, Mercado Pago, Flow e Wompi > Como conectar SumUp, Mercado Pago, Flow ou Wompi a um agente do ChatNorris e configurar a Ação Pagamento para cobrar no chat: catálogo de itens, carrinho com vários itens, confirmação do pagamento e as particularidades de cada provedor. # Pagamentos com SumUp, Mercado Pago, Flow e Wompi Com a Ação **Pagamento**, o seu agente do ChatNorris cobra dentro da conversa. Você configura um catálogo fechado de itens com os seus valores, e o agente: * monta um carrinho com um ou vários itens do catálogo, com o total; * pede ao visitante uma confirmação explícita antes de cobrar; * gera um link de pagamento pelo total com o provedor que você escolher; * avisa no chat quando o provedor confirma o pagamento. O agente nunca inventa um valor: ele só pode cobrar os valores exatos que você configura. As cobranças são processadas na sua própria conta do provedor. | Provedor | Para quem | Moedas | | - | - | - | | [**SumUp**](#sumup) | Links de cobrança com o Hosted Checkout da SumUp. | A que você configurar em cada item. | | [**Mercado Pago**](#mercado-pago) | Links de cobrança com o Checkout Pro: uma única conexão para toda a América Latina. | A que você configurar em cada item. | | [**Flow**](#flow-chile) | Negócios no Chile: Webpay, Khipu e os demais meios da sua conta do Flow. | Apenas pesos chilenos (CLP). | | [**Wompi**](#wompi-colômbia) | Negócios na Colômbia: cartão, Nequi, Daviplata, PSE, Transferencia Bancolombia e SU+ Pay. | Apenas pesos colombianos (COP). | Funciona no widget web, WhatsApp, Instagram, Messenger, Telegram, Email e na API. ## Requisitos * Uma conta do ChatNorris com plano **Standard** ou **Premium**. Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing). * Pelo menos um agente criado no ChatNorris. Se você ainda não tiver um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md). * Uma conta em pelo menos um dos provedores (SumUp, Mercado Pago, Flow ou Wompi) e acesso às credenciais de API dela. * Função **Owner** ou **Admin** na sua organização do ChatNorris. ## Conectar um provedor Conecte pelo menos um provedor no agente. Você pode conectar vários e escolher na Ação com qual a cobrança é feita. **1. Abra o hub de Integrações do agente** No ChatNorris, acesse `Agentes → [seu agente] → Integrações` e escolha **SumUp**, **Mercado Pago**, **Flow** ou **Wompi**. **2. Cole as credenciais e conecte** Cada provedor pede dados diferentes: você os encontra mais abaixo, na seção de cada um. Clique em **Conectar**. **3. Teste a conexão** Use **Testar conexão** para confirmar que as credenciais funcionam antes de usá-las na Ação. O hub mostra apenas os últimos 4 caracteres de cada chave. Se você trocá-la no provedor, use **Substituir chave** no menu **···** da linha: a conexão continua sendo a mesma e a Ação não é alterada. ### SumUp Pede o **Merchant code** (você o vê no dashboard da SumUp, por exemplo `MH4H92C7`) e a **API key**, que você gera em `me.sumup.com/settings/api-keys`. O visitante paga na página de pagamento da SumUp (Hosted Checkout). ### Mercado Pago Pede a **Public Key** e o **Access Token**, que você encontra na sua conta do Mercado Pago, em **Suas integrações → Credenciais** (começam com `APP_USR-`). O visitante paga na página do Mercado Pago (Checkout Pro). Uma única conexão serve para toda a América Latina. O link expira em 30 minutos; se vencer, o visitante pode pedir um novo. ### Flow (Chile) Pede a **API Key** e a **Secret Key** da sua conta do Flow, que você encontra em **Flow → Mis datos**, aba **Integraciones**. O ChatNorris as valida no Flow ao salvá-las e detecta se são de testes (sandbox) ou de produção: produção e sandbox são contas diferentes, com chaves diferentes. Com chaves de sandbox, a conexão mostra a etiqueta **Sandbox** e os pagamentos são de teste, sem dinheiro real. Se você escolher **Flow** como gateway na Ação: * Os itens precisam estar em **pesos chilenos (CLP)**, com valores inteiros e de pelo menos **350 CLP** (o mínimo do Flow). Se algum item habilitado não cumprir essas regras, a Ação pede que você o corrija ou desabilite antes de ativá-la. * Antes de gerar o link, o agente pede o **email** do visitante, se ainda não o tiver: o Flow o exige para enviar o comprovante. Se o Flow recusar esse email, o agente pede outro. * O visitante paga na página do Flow com **Webpay** (crédito, débito e pré-pago), **Khipu** (transferência) ou os demais meios que você tiver habilitados na sua conta do Flow. * O link expira em 30 minutos; se vencer, o visitante pode pedir um novo. ### Wompi (Colômbia) Por enquanto, funciona com contas do Wompi Colômbia. Pede quatro dados que você encontra no seu painel do Wompi, em **Desarrolladores** ("Llaves del API" e "Secretos para integración técnica"): | Campo | Prefixo em produção | | - | - | | **Llave pública** | `pub_prod_…` | | **Llave privada** | `prv_prod_…` | | **Secreto de integridad** | `prod_integrity_…` | | **Secreto de eventos** | `prod_events_…` | Os quatro precisam ser do mesmo ambiente. Com chaves de teste (`pub_test_…`, `prv_test_…`, `test_integrity_…` e `test_events_…`), a conexão mostra a etiqueta **Sandbox** e os pagamentos são simulados, sem dinheiro real. Se uma chave não funcionar, o formulário diz qual. Para atualizar a conexão, cole as quatro novamente. > [!WARNING] > > Depois de conectar, o ChatNorris mostra a **URL de eventos**. Copie-a em Wompi → **Desarrolladores** → **URL de Eventos**, no mesmo ambiente das suas chaves, para que os pagamentos sejam confirmados mesmo que o visitante feche a aba do pagamento. O Wompi aceita uma única URL de eventos por ambiente, então substitua a que você tiver configurada ali: se outro sistema a usava (por exemplo, a sua loja on-line), ele deixa de receber esses avisos. Se você escolher **Wompi** como gateway na Ação: * Os itens precisam estar em **pesos colombianos (COP)**, com valores inteiros e de pelo menos **1.500 COP**. O carrinho com vários itens funciona igual ao dos demais provedores. * O visitante paga na página do Wompi com cartão, **Nequi**, **Daviplata**, **PSE**, **Transferencia Bancolombia** ou **SU+ Pay**, de acordo com os meios que você tiver habilitados na sua conta do Wompi. * O link expira em 30 minutos; se vencer, o visitante pode pedir um novo. ## Configurar a Ação Conectar o provedor ainda não ativa nada. Para que o agente cobre: **1. Crie a Ação Pagamento** Acesse `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **Pagamento**. **2. Escolha o gateway de pagamento** O campo **Gateway de pagamento** decide com qual provedor conectado o link é gerado. Alterá-lo não apaga o catálogo de itens nem as conexões: só decide qual é usado. **3. Configure o catálogo de itens** Em **Catálogo de itens**, adicione cada item cobrável com **Adicionar item**: nome, descrição (opcional), valor e moeda. A moeda é por item; o campo **Moeda** da Ação só define a moeda padrão dos itens novos. O agente **só** pode cobrar os valores exatos configurados aqui. **4. Personalize a mensagem de sucesso e a página de retorno** A **Mensagem após o pagamento** é enviada no chat quando o provedor confirma a cobrança. A **Página de retorno (opcional)** é para onde o visitante volta depois de pagar; se ficar vazia, ele vê a tela de sucesso do próprio provedor. **5. Ative a Ação e salve** Com **Ação habilitada** ativa, clique em **Salvar**. Enquanto ela estiver desabilitada, o agente nunca oferece nem gera links de pagamento. Em **Quando usar esta ação**, você pode ajustar as instruções que o agente segue, turno a turno, para decidir se é o caso de gerar um link de pagamento. Com **Restaurar texto padrão**, você volta ao texto original. > [!WARNING] > > Recomendamos usar **Claude Sonnet ou um modelo superior** como principal em agentes com esta ação (`Configurações → IA`). Criar um link de pagamento é uma cobrança real. Em testes, modelos mais econômicos (por exemplo, Haiku) às vezes confirmam um pagamento ou inventam um número de comprovante sem ter gerado nenhum checkout, mesmo com instruções explícitas para não fazer isso. O formulário da Ação mostra esse aviso com um link para a configuração de IA. > [!NOTE] > > O agente sempre pede uma confirmação explícita do visitante antes de gerar o link de pagamento: isso não pode ser desativado. Veja quais respostas contam como confirmação em [Ações do agente](https://docs.chatnorris.ai/pt/guias/acciones.md#confirmações-do-visitante). > > As cobranças são processadas na sua própria conta do SumUp, Mercado Pago, Flow ou Wompi: o ChatNorris nunca recebe o dinheiro nem vê dados de cartão. Ele só gera o link e fica sabendo da confirmação, que sempre verifica com o provedor antes de avisar o visitante. > [!NOTE] > > Um agente monta compras a partir de uma única fonte. Se ele já tiver ativo o recurso **Montar compra** de uma loja conectada (por exemplo, [Jumpseller](https://docs.chatnorris.ai/pt/guias/jumpseller.md) ou Odoo), desligue-o antes de habilitar a Ação Pagamento, e vice-versa. ### Importar itens de um CSV Se você tem muitos itens, use **Importar CSV** no catálogo. A primeira linha do arquivo deve ter os cabeçalhos; as colunas são reconhecidas em qualquer ordem: | Coluna | Alias | Obrigatória? | | - | - | - | | `name` | `nombre` | Sim | | `amount` | `monto`, `precio` | Sim (número maior que 0) | | `description` | `descripcion` | Não | | `currency` | `moneda` | Não (se faltar, usa a moeda padrão da Ação) | | `enabled` | `habilitado` | Não (se faltar, o item fica habilitado) | Antes de importar, você vê quantos itens foram detectados e quantas linhas foram omitidas: uma linha sem nome ou sem um valor válido é descartada, nunca se inventa um preço. Os itens importados são somados aos que você já tinha. O catálogo aceita até 50 itens. ### Carrinho: vários itens em uma mesma cobrança O visitante pode montar um carrinho com vários itens do catálogo na mesma conversa: adicionar, alterar quantidades e remover itens, inclusive várias mudanças em uma única mensagem ("adicione um de 60 e tire um de 45"). O agente mostra o carrinho com o total e, quando o visitante confirma explicitamente que quer pagar, gera **um único link de pagamento pelo total**. * Os preços sempre vêm do catálogo da Ação e são revalidados a cada turno. Se um preço mudou, o agente pede novamente a confirmação do novo total. * Um carrinho nunca mistura moedas. * Se, na mesma mensagem em que pede para pagar, o visitante alterar o carrinho, o agente não gera o link: primeiro pede que ele confirme o novo total. * Quando o pagamento é confirmado, o carrinho é fechado. Se o visitante pedir de novo o link do mesmo carrinho, o agente reutiliza o que continua válido. * No Playground, nunca é criado um link de pagamento real. Cada mudança do carrinho e do pagamento fica registrada na conversa como uma [nota interna](https://docs.chatnorris.ai/pt/guias/conversaciones.md#notas-internas-do-carrinho), que só a sua equipe vê. ### Como o visitante vê, de acordo com o canal * **Widget web:** o carrinho aparece como um cartão **Seu carrinho** com cada linha (quantidade × item e subtotal), o **Total** e um botão **Pagar** com o valor, que abre a página de pagamento. Se o carrinho mudar, só o cartão mais recente mantém o botão. * **Telegram e WhatsApp:** o link de pagamento chega como um botão **Pagar** abaixo da mensagem, em vez da URL colada no fim do texto. Se o envio com botão falhar, o agente manda a mesma mensagem com o link no texto. * **Demais canais:** o link vai no texto da mensagem. ### Depois do pagamento * **Conversa resolvida:** se uma conversa com um pagamento confirmado for encerrada por inatividade e o visitante não tiver voltado a escrever depois de pagar, ela passa para **Resolvida**. A mudança é aplicada uma vez por dia, então ela pode aparecer como encerrada durante algumas horas. * **Onde ver os pagamentos:** em Detalhes da conversa aparece a seção **Pagamentos** (só se a conversa tiver pagamentos confirmados). Em Leads, você tem a coluna **Pagamento**, o filtro **Com pagamento** e a seção **Pagamentos** no painel de cada lead. Veja [Conversas](https://docs.chatnorris.ai/pt/guias/conversaciones.md) e [Leads](https://docs.chatnorris.ai/pt/guias/leads.md). ## Desconectar Em `Agentes → [seu agente] → Integrações → [provedor]`, clique em **Desconectar** (também está no menu **···** da linha). A Ação Pagamento que usa essa conexão é desabilitada, mas mantém a sua configuração, e o catálogo de itens não é apagado. A chave é apagada do ChatNorris. Para voltar a cobrar, conecte o provedor novamente e reative a Ação. Se você só quiser interromper as cobranças por um tempo, desligue a chave **Ativa** da integração: as credenciais são mantidas, e a Ação não pode gerar links até que você a reative. Excluir a Ação Pagamento não apaga a conexão nem o histórico de cobranças já realizadas. ## Perguntas frequentes > [accordion] O ChatNorris recebe o dinheiro das cobranças? > > Não. As cobranças são processadas na sua própria conta do SumUp, Mercado Pago, Flow ou Wompi. O ChatNorris não recebe o dinheiro nem vê dados de cartão: ele só gera o link de pagamento e fica sabendo da confirmação. > [accordion] Como o link de pagamento chega no WhatsApp e no Telegram? > > Quando o agente gera um link de pagamento do carrinho, no WhatsApp e no Telegram ele o envia como um **botão** para pagar, em vez de uma URL no fim do texto. Se o envio com botão falhar, a mensagem é enviada com o link. > [accordion] Posso conectar vários provedores no mesmo agente? > > Sim. Você pode conectar mais de um em **Integrações**; o campo **Gateway de pagamento** da Ação decide com qual o link é gerado. Cada provedor aceita uma única conexão por agente. > [accordion] Não consigo ativar a Ação com Flow ou Wompi > > Verifique os itens habilitados do catálogo: com Flow, eles precisam estar em CLP, com valores inteiros e de pelo menos 350 CLP; com Wompi, em COP, com valores inteiros e de pelo menos 1.500 COP. Corrija ou desabilite os que não cumprirem essas regras. > [accordion] O visitante pagou com Wompi e o chat não confirmou > > Verifique se você colou a **URL de eventos** da conexão em Wompi → **Desarrolladores** → **URL de Eventos**, no mesmo ambiente das suas chaves. Sem ela, o pagamento não é confirmado se o visitante fechar a aba do pagamento. > [accordion] Posso testar sem cobrar dinheiro real? > > No Playground, nunca é criado um link de pagamento real. Com Flow e Wompi, você também pode conectar chaves de sandbox: a conexão mostra a etiqueta **Sandbox** e os pagamentos são de teste. > [accordion] Conectar um provedor de pagamento consome créditos? > > Não. Conectar e testar a integração não tem custo em créditos. Veja [Modelos de IA e créditos](https://docs.chatnorris.ai/pt/guias/modelos-ia-creditos.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.