# Pagamentos Conecte Mercado Pago, AbacatePay ou Stripe, escolha quem processa Pix e cartão e faça um pagamento de teste antes de vender. Source: https://fivedash.fivex.gg/docs/pt/store/payments 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. ## Antes de começar * **Plano:** Pagamentos está em todos os planos com a Loja (Plus, Pro e Ultra). O FiveDash cobra uma taxa sobre as vendas pagas da loja: 3% no Plus, 1,5% no Pro e nenhuma no Ultra. A taxa do provedor é à parte e é cobrada pelo próprio provedor. * **Conta no provedor:** uma conta no Mercado Pago, na AbacatePay ou na Stripe, liberada para receber. A conta do Mercado Pago precisa ser do Brasil, porque a loja recebe em reais. | 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. ## Provedores aceitos | 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**. | > Nunca cole sua credencial em chats, tickets ou no Discord. O FiveDash guarda a chave com criptografia e ela nunca aparece de novo no painel. ## Pegar a credencial no provedor ### Mercado Pago ### Crie uma aplicação 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á. ### Copie o Access Token Em **Credenciais de produção**, copie o **Access Token** (começa com `APP_USR-`). ### Confira a chave Pix Para receber por Pix, a conta precisa ter uma **chave Pix** cadastrada. ### AbacatePay ### Crie uma chave No painel da **AbacatePay**, abra **Integrar** → **Chaves de API** e crie uma chave. O botão **Abrir painel da AbacatePay** no formulário leva até lá. ### Dê as permissões Dê acesso à **loja**, às **cobranças** e aos **webhooks**, e copie a chave (começa com `abc_prod_`). ### Teste no Dev mode (opcional) A chave `abc_dev_` serve para testar: os pagamentos são simulados. ### Stripe ### Crie uma chave restrita No Dashboard da **Stripe**, abra **Desenvolvedores** → **Chaves de API** e crie uma **chave restrita**. O botão **Abrir chaves de API da Stripe** no formulário leva até lá. ### Dê as permissões Dê **escrita** em **Checkout Sessions** e **Webhook Endpoints**, e copie a chave (começa com `rk_live_`). ### Ligue as formas de pagamento O checkout mostra as formas de pagamento ligadas na Stripe, em **Configurações** → **Formas de pagamento** (cartão, Pix e outras). ## Conectar um provedor Nas mensagens desta página, o nome do provedor aparece como Mercado Pago; na tela, aparece o provedor que você está usando. ### Abra Pagamentos 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**.) ### Cole a credencial 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. ### Escolha as formas de pagamento 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. ### Conecte 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á. > Uma chave de teste mostra **Chave de teste** no cartão: os pagamentos são simulados. Troque pela de produção antes de vender. ### Erros ao conectar | 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. | ## Escolher quem processa cada forma 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.** | ## Cartão do provedor 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. | > Não dá para desconectar o único provedor que recebe pela loja. Conecte outro provedor para Pix ou cartão antes. ### Avisos no cartão | 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**. ## Fazer um pagamento de teste 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. ### Abra o teste 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**.) ### Gere a cobrança 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 Pague a cobrança. A tela mostra **Esperando Mercado Pago confirmar o pagamento de R$ 1,00…** e muda sozinha. ### Veja a confirmação 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. ## Status das cobranças 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 | ## Últimas cobranças e números 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. | ## Perguntas frequentes **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. ## Próximos passos [Visão geral da loja](https://fivedash.fivex.gg/docs/pt/store/overview)Configuração da loja e números de vendas. [Pedidos](https://fivedash.fivex.gg/docs/pt/store/orders)Veja o que acontece depois do pagamento. [Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery)Como a compra paga chega no personagem. [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing)Taxa sobre as vendas em cada plano.