Pagamentos

1.Escolher o gateway

Em Pagamentos e entregas, Pagamentos, escolha entre Mercado Pago, Asaas, PayPal, Stripe ou InfinitePay nas abas do alto. Use aquele em que você já tem conta. Cada aba tem um botão Ativar: só as formas ativadas aparecem para o cliente.

Assistir: Escolher o gateway

2.Colar as chaves

Copie as chaves do painel da sua conta (no Mercado Pago são a Public Key e o Access Token, no Asaas a Chave de API, no PayPal o Client ID e o Secret, na Stripe a Chave publicável e a Chave secreta, na InfinitePay a Chave de API e a InfiniteTag) e cole nos campos de PRODUÇÃO. Cada aba mostra, em Como conseguir suas chaves, o passo a passo e o link direto para a página certa. Nunca compartilhe a chave secreta com ninguém. Depois de salvar, o campo fica vazio de propósito: aparece "✓ Salva" com os 4 últimos dígitos, deixar em branco mantém a chave, e só marcar "Remover" apaga. No Asaas a chave só aparece uma vez, então copie na hora.

3.Testar a conexão

Clique em Testar chaves de produção (ou Testar chaves de teste, para as chaves de teste). Se aparecer verde, as chaves estão certas. Se der erro, confira se copiou a chave inteira e se ela é da conta certa (produção, não teste). Clique em Salvar para guardar. Atenção no Mercado Pago: o verde só confirma que o Access Token é válido. Para o Pix funcionar, a conta também precisa ter uma chave Pix cadastrada (app do Mercado Pago, Pix, Minhas chaves, Cadastrar chave).

Assistir: Testar a conexão

4.Modo de teste

Cada aba tem a chave Modo teste / Online. Em Modo teste ninguém é cobrado de verdade: serve só para você experimentar com cartões de teste que a própria plataforma de pagamento fornece. Em Online a cobrança é real e o dinheiro cai na sua conta. Atenção: com a loja em Modo teste, os seus clientes de verdade não conseguem pagar. Antes de divulgar a loja, desligue o Modo teste e confira que a etiqueta da aba mostra Online.

5.Conectar a Stripe

Abra a aba Stripe. Na sua conta da Stripe, entre em Desenvolvedores, Chaves da API, seção Chaves padrão. Copie a Chave publicável e a Chave secreta (em produção, clique em Revelar chave de produção) e cole nos campos de Credenciais de PRODUÇÃO. Não use as Chaves restritas. Para só experimentar, use a área restrita da Stripe (o ambiente de teste), copie as chaves de teste e cole em Credenciais de TESTE (área restrita da Stripe). Depois cole o Segredo da assinatura do aviso automático (próximo passo), ative o botão Ativar, desligue o Modo teste quando for vender de verdade e clique em Salvar. A Stripe pode deixar a conta nova em análise no começo: enquanto isso, só o modo teste funciona. Detalhe importante: a Stripe não oferece Pix para contas do Brasil. Para vender com Pix, use Mercado Pago ou Asaas.

Conta em análise na Stripe é normal no início. Você pode deixar tudo pronto em modo teste enquanto espera.

6.Conectar a InfinitePay

Abra a aba InfinitePay. No app da InfinitePay (ou em app.infinitepay.io), entre em Vendas, Checkout, aba Configurações, ligue Habilitar checkout integrado e crie a chave de API. Copie na hora, ela só aparece uma vez. Cole no campo Chave de API e, no campo InfiniteTag, o seu nome de usuário da InfinitePay sem o $ (ele aparece na aba Documentação). Ative, clique em Testar chave e salve. Na InfinitePay o cliente paga na página dela, com Pix ou cartão em até 12x, e volta pra loja depois. Você não precisa cadastrar webhook, porque cada link já leva o aviso de pagamento. Não existe modo de teste, então confira com uma compra pequena de verdade. O estorno você faz pelo app da InfinitePay.

Na InfinitePay o cliente paga fora da loja, na página dela. Para pagamento sem sair da loja, use Mercado Pago, Asaas ou Stripe.

7.Ligar o aviso automático de pagamento (webhook)

O webhook é o aviso automático que a plataforma de pagamento manda para a Vistello quando o cliente paga. Sem ele, o pedido pago fica pendente para sempre, porque a Vistello não fica sabendo do pagamento. Na aba da Stripe, copie o endereço que aparece em URL do webhook (botão Copiar). Na Stripe, entre em Workbench, Webhooks, Adicionar destino, escolha o tipo endpoint webhook, cole o que você copiou e marque os avisos: pagamento concluído (checkout.session.completed), pagamento expirado (checkout.session.expired), pagamento aprovado (payment_intent.succeeded), pagamento recusado (payment_intent.payment_failed) e reembolso (charge.refunded). Ao salvar, a Stripe mostra o Segredo da assinatura, um código que começa com whsec (clique no ícone de olho para revelar): copie e cole no campo Segredo da assinatura do webhook da aba Stripe e clique em Salvar. Faça isso uma vez para o modo teste e outra para produção, cada um com o seu código. Mercado Pago e Asaas também têm o campo URL do webhook na aba deles, com o mesmo cuidado.

8.Conferir que o pagamento chega

Com o Modo teste ligado, faça uma compra de mentira na sua loja com um cartão de teste da plataforma. Depois abra o pedido em Pedidos: se o pagamento aparece como Confirmado, o aviso automático está funcionando. Se ficar Aguardando pagamento, revise o endereço colado na Stripe, os cinco avisos marcados e o código whsec. Só depois desligue o Modo teste.

9.Se o Pix não gerar o QR Code no checkout

Quando o cliente clica em Gerar QR Code Pix e aparece "Erro ao gerar Pix" ou "Pix indisponível nesta loja", a plataforma de pagamento recusou o pedido. No Mercado Pago, confira nesta ordem. Primeiro, a chave Pix: a conta dona do Access Token precisa ter uma chave Pix cadastrada (app do Mercado Pago, Pix, Minhas chaves, Cadastrar chave). Sem ela o Mercado Pago não gera QR Code, e o botão Testar chaves continua verde porque só valida o token. Segundo, o Access Token: se foi copiado incompleto, se é de teste com a loja em Online ou se é de outra conta, o Mercado Pago recusa; cole de novo o de produção e teste. Terceiro, o CPF do cliente: se estiver inválido, o cliente vê "CPF inválido" e só precisa corrigir. Enquanto não resolve, o cliente pode tentar outra forma de pagamento da loja. Se nada disso resolver, chame o suporte com o horário da tentativa: o motivo exato devolvido pelo Mercado Pago fica registrado.

10.Mercado Pago, Asaas e PayPal em poucas linhas

Mercado Pago: cole a Public Key e o Access Token de produção (em Integrações, sua aplicação, menu lateral Credenciais de produção) e cadastre o endereço da aba em Integrações, sua aplicação, Webhooks, Configurar notificações, aba Modo de produção, campo URL de produção, deixando marcado o evento Pagamentos (legacy) e clicando em Salvar configurações; depois cole a Assinatura secreta (botão ao lado do campo) no campo da tela. Asaas: cole a Chave de API de Integrações, Chaves de API (a de teste vem do Sandbox do Asaas) e cadastre o endereço da aba em Menu do usuário, Integrações, Webhooks, Criar Webhook, com um Token de autenticação (botão Gerar token) que você repete no campo da tela. PayPal: em developer.paypal.com, Apps & Credentials, abra o seu app e cole o Client ID e o Secret (botão Show); o Webhook ID aparece depois de criar o webhook no app, em Webhooks, Add Webhook. Todos têm Modo teste (no PayPal e no Asaas chamado Sandbox) e botões para testar as chaves, e o mesmo aviso vale: em Modo teste os clientes reais não conseguem pagar.