Loja
Pagamentos
Conecte Mercado Pago, AbacatePay ou Stripe, escolha quem processa Pix e cartão e faça um pagamento de teste antes de vender.
Conecte Mercado Pago, AbacatePay ou Stripe, escolha quem processa Pix e cartão e faça um pagamento de teste antes de vender.
Em Loja → Pagamentos você conecta onde a loja recebe e escolhe quem processa cada forma de pagamento. O dinheiro de cada compra cai direto na conta da cidade no provedor, sem passar pelo FiveDash. Esta página é para quem cuida do financeiro da loja.
| Ação | Nível |
|---|---|
| Provedores e cobranças | Ver |
| Conectar provedores, chaves e formas de pagamento | Configurar |
O Pagamento de teste precisa de Configurar em Pagamentos ou em Visão geral. O botão Verificar conexões funciona com Ver. O perfil Financeiro vê esta página sem poder mudar as chaves.
| Provedor | Formas de pagamento | Credencial | Começa com |
|---|---|---|---|
| Mercado Pago | Pix e cartão | Access Token | APP_USR- (produção) ou TEST- (teste) |
| AbacatePay | Pix | Chave de API | abc_prod_ (produção) ou abc_dev_ (teste) |
| Stripe | Cartão, Pix e mais | Chave restrita | rk_live_ (ou sk_live_); rk_test_ / sk_test_ para teste |
| Provedor | Como o comprador paga |
|---|---|
| Mercado Pago | Pix e cartão numa conta só. O cartão abre a página do Mercado Pago. |
| AbacatePay | Pix com QR Code direto na loja, sem sair do checkout. |
| Stripe | Cartões do mundo todo, e Pix quando estiver ligado na sua conta Stripe. O checkout mostra as formas ligadas na Stripe em Configurações → Formas de pagamento. |
No Mercado Pago Developers, crie uma aplicação do tipo Pagamentos online. O botão Abrir Mercado Pago Developers no formulário leva até lá.
Em Credenciais de produção, copie o Access Token (começa com APP_USR-).
Para receber por Pix, a conta precisa ter uma chave Pix cadastrada.
Nas mensagens desta página, o nome do provedor aparece como Mercado Pago; na tela, aparece o provedor que você está usando.
Vá em Loja → Pagamentos. Em Provedores, clique em Conectar no cartão do provedor. (Na configuração inicial da loja, este é o passo Receba os pagamentos.)
Em Onde você quer receber?, confira o provedor e cole a credencial no campo (Access Token, Chave de API ou Chave restrita). Use Mostrar chave para conferir o que colou.
Em Usar Mercado Pago para, ligue Pix, Cartão de crédito ou os dois (só as formas que o provedor aceita aparecem). Deixe pelo menos uma ligada.
Clique em Conectar Mercado Pago. O FiveDash confere a chave com o provedor (Verificando chave…) e mostra Conta conectada.
Ao conectar, o FiveDash também cadastra sozinho o Aviso de pagamento na sua conta do provedor (o webhook). Você não precisa criar nada lá.
| Mensagem | O que fazer |
|---|---|
| Isso não parece um Access Token. Ele começa com APP_USR- ou TEST-. | Copie o Access Token inteiro de novo. |
| Isso não parece uma chave da AbacatePay. Ela começa com abc_prod_ ou abc_dev_. | Copie a chave da AbacatePay de novo. |
| Isso não parece uma chave da Stripe. Ela começa com rk_live_ (ou sk_live_). | Copie a chave restrita de novo. |
| Essa chave restrita não tem as permissões que a loja usa… | Na Stripe, dê escrita em Checkout Sessions e Webhook Endpoints. |
| Essa chave não tem as permissões que a loja usa… | Na AbacatePay, crie uma chave com acesso à loja, às cobranças e aos webhooks. |
| Essa credencial não tem acesso à conta… | No Mercado Pago, copie o Access Token de produção de novo. |
| Essa conta do Mercado Pago não é do Brasil. A loja recebe em reais. | Use uma conta brasileira do Mercado Pago. |
| O Mercado Pago recusou essa credencial. Copie de novo e cole aqui. | A chave está errada ou foi apagada. Gere outra. |
| Não conseguimos falar com o Mercado Pago agora… | O provedor não respondeu. Tente de novo em instantes. |
Em Formas de pagamento há um cartão para Pix e outro para Cartão de crédito. Em cada um, ligue os provedores que vão processar aquela forma.
| Forma | Como funciona | Provedores ao mesmo tempo |
|---|---|---|
| Pix | QR Code na própria loja, aprovado na hora. | 1 |
| Cartão de crédito | O comprador paga na página do provedor e volta para a loja. | Até 3 (hoje, Mercado Pago e Stripe aceitam cartão) |
Com mais de um provedor de cartão, o comprador escolhe no checkout. O primeiro já vem marcado: ele aparece como Padrão, e Tornar padrão muda isso. Quando você muda algo, aparece a barra Você tem alterações não salvas; clique em Salvar (ou Descartar).
Se você liga o Pix num provedor novo, o Pix sai do provedor anterior e passa para o novo, porque o Pix aceita só um.
| Regra | Mensagem |
|---|---|
| Pelo menos uma forma precisa ficar ligada. | Deixe pelo menos uma forma de pagamento ligada. |
| O provedor precisa estar conectado antes de ser usado. | Conecte o Mercado Pago antes de usar. |
| Um provedor com chave recusada não pode ser usado até trocar a chave. | O Mercado Pago recusou a chave salva. Troque a chave antes de usar. |
Em Provedores, cada cartão mostra o estado da conexão:
| Estado | O que quer dizer |
|---|---|
| Não conectado | Ainda não tem chave. Botão Conectar. |
| Conectado | A chave funciona. Mostra desde quando, e · não usado se nenhuma forma passa por ele. |
| Chave de teste | Os pagamentos são simulados. |
| Chave recusada | O provedor recusou a chave salva. Troque a chave para voltar a receber por ele. |
| Botão | O que faz |
|---|---|
| Conectar | Aparece quando o provedor ainda não tem chave. |
| Testar | Abre o Pagamento de teste com esse provedor (só com a chave funcionando). |
| Trocar chave | Aparece quando o provedor recusou a chave salva. Cole uma chave nova; as cobranças em aberto continuam sendo conferidas. |
| Menu ⋯ → Trocar chave e formas | Troca a chave e as formas de pagamento juntas. |
| Menu ⋯ → link do provedor | Abre o painel do provedor onde a chave é criada (por exemplo, Abrir Mercado Pago Developers). |
| Menu ⋯ → Desconectar | Apaga a chave do FiveDash e tira o aviso de pagamento da sua conta no provedor. As formas que ele processava saem do checkout na hora, e as cobranças em aberto expiram sozinhas. |
| Aviso | O que fazer |
|---|---|
| O Mercado Pago avisa o FiveDash na hora em que um pagamento é aprovado. | Tudo certo. |
| Não conseguimos cadastrar o aviso… | Confira as permissões da chave. Enquanto isso, o FiveDash confere os pagamentos sozinho. |
| A chave perdeu as permissões que a loja usa… | Crie outra chave com as mesmas permissões e clique em Trocar chave. |
| O Mercado Pago não respondeu agora… | Clique em Verificar conexões em instantes. |
| Conectado, mas nenhuma forma de pagamento passa por aqui. | Ligue uma forma para ele em Formas de pagamento, ou desconecte. |
O botão Verificar conexões, no topo, testa todas as chaves de novo. Se todas responderem, aparece Tudo certo.
O pagamento de teste cria uma cobrança de R$ 1,00 na sua conta do provedor, para ver o pagamento chegar até o FiveDash.
Em Loja → Pagamentos, clique em Testar no cartão do provedor. (Na Visão geral, o mesmo teste fica no cartão Pagamento de teste, em Configuração da loja.)
Clique em Gerar cobrança. Para Pix, aparece o QR Code do Pix com o código para Copiar. Para os outros casos, clique em Abrir pagamento no Mercado Pago.
Pague a cobrança. A tela mostra Esperando Mercado Pago confirmar o pagamento de R$ 1,00… e muda sozinha.
Quando o provedor confirmar, aparece Pagamento confirmado!. A integração está funcionando.
| Chave conectada | O que acontece |
|---|---|
| Produção | É uma cobrança de verdade, e o valor cai na sua conta do provedor (menos a taxa). |
| Teste (Mercado Pago) | Pague com um usuário de teste do Mercado Pago, não com a sua conta. |
| Teste (AbacatePay) | Use Simular pagamento para pagar o Pix sem banco. |
| Teste (Stripe) | Pague com o cartão 4242 4242 4242 4242, qualquer validade futura e qualquer CVC. |
Se a última cobrança de teste expirou, foi estornada ou não foi concluída, o diálogo avisa e mostra Gerar outra cobrança. Uma cobrança de teste em aberto, feita há menos de 10 minutos, é mostrada de novo em vez de criar outra.
O status de uma cobrança vem sempre de perguntar ao provedor. O aviso de pagamento só faz o FiveDash perguntar na hora; sem ele, o FiveDash confere as cobranças em aberto sozinho.
| Status | O que quer dizer | No pedido |
|---|---|---|
| Aguardando | A cobrança foi criada e o comprador ainda não pagou. | Aguardando pagamento |
| Pago | O provedor confirmou o pagamento. | Pago, vai para a entrega |
| Expirou | O tempo para pagar acabou (a cobrança vale 1 hora). | Expirado |
| Não concluído | O pagamento não foi concluído no provedor. | Cancelado |
| Estornado | O valor voltou para o comprador. | Reembolsado; o que a cidade ainda não entregou é cancelado |
Em Últimas cobranças aparecem as 12 cobranças mais novas, de testes e de pedidos. Cada linha mostra o provedor, o valor, o status e se é Pagamento de teste ou Pedido #número (clique no número para abrir o pedido em Loja → Pedidos). Atualizar lê a lista de novo.
| Cartão | O que mostra |
|---|---|
| Recebido · 30 dias | Pagamentos aprovados por dia, comparados aos 30 dias antes, com o ticket médio. |
| Aprovação | Quantas cobranças viraram pagamento e o que aconteceu com as outras (Pagas, Aguardando, Expiraram, Não concluídas, Estornadas), por forma de pagamento e com o tempo médio até pagar. |
| Por provedor | Cobranças e taxa de pagas de cada provedor, e quantas cobranças estão aguardando o comprador. |
Preciso cadastrar o webhook no provedor? Não. O FiveDash cadastra o aviso de pagamento sozinho ao conectar. Se o cadastro falhar, o cartão do provedor avisa, e o FiveDash continua conferindo os pagamentos sozinho.
Posso usar dois provedores ao mesmo tempo? Sim. Por exemplo, Pix pela AbacatePay e cartão pelo Mercado Pago e pela Stripe. O Pix aceita um provedor por vez; o cartão aceita mais de um, e o comprador escolhe.
Como faço um reembolso? O painel não tem botão de reembolso. Devolva o pagamento no painel do provedor; quando o provedor informar o estorno, a cobrança fica Estornado e o pedido, Reembolsado.
Troquei a chave. As cobranças antigas se perdem? Não. As cobranças em aberto continuam sendo conferidas com a chave nova.