Pular para o conteúdo

Como receber Pix na loja do seu servidor

Chave Pix com comprovante ou cobrança com confirmação automática: como cada opção funciona, o que Mercado Pago e Efí pedem e como o MED trata devoluções.

Tanz

6 min de leitura

Para receber Pix com entrega automática, a loja precisa gerar uma cobrança Pix por um provedor de pagamento, como Mercado Pago ou Efí. O provedor avisa quando o jogador pagou, o pedido é aprovado e o comando de entrega roda no servidor sem ninguém da equipe tocar em nada.

Divulgar uma chave Pix no Discord e pedir comprovante também funciona, mas só enquanto alguém tiver tempo de conferir o extrato a cada venda. Abaixo estão as duas formas, o que cada provedor pede para configurar e o que acontece quando um jogador quer o dinheiro de volta.

Por que oferecer Pix aos jogadores

Segundo o Banco Central, no Pix "os recursos são transferidos entre contas em poucos segundos, a qualquer hora ou dia". O pagamento pode sair de conta corrente, poupança ou conta pré-paga, então o jogador não precisa de cartão de crédito para comprar um VIP.

Para quem paga, o BC informa que o Pix é gratuito para pessoa física.

Um detalhe pesa nas compras feitas à noite. A mesma página do BC informa: "Após as 20h, o limite é de R$1.000 para pessoa física." O limite e o horário mudam se o cliente pedir e o banco aprovar. Se a sua loja vende pacotes acima disso, um jogador pode ter o Pix recusado pelo próprio banco à noite, sem relação com a loja.

As duas formas de receber Pix numa loja

Chave Pix e comprovanteCobrança Pix pelo provedor
Como o jogador pagaCopia a sua chave e digita o valorLê o QR code ou usa o Pix copia e cola, com valor já preenchido
Quem confirma o pagamentoAlguém da equipe, olhando o extratoO provedor, sozinho
Quando a entrega aconteceQuando alguém aprovarLogo depois da confirmação
Risco de comprovante falsoExisteNão depende de comprovante

Chave Pix e comprovante no Discord

É o jeito mais rápido de começar: você publica a chave, o jogador paga e manda o print num ticket. O problema aparece no volume. Cada venda exige abrir o app do banco, achar o valor certo, conferir o nome e só então aplicar o VIP.

Um comprovante é uma imagem, e imagem se edita. A única confirmação de verdade é o dinheiro no seu extrato. Quando a equipe está dormindo ou num fim de semana sem staff, o jogador paga e fica esperando, e é desse atraso que nascem os tickets de "paguei e não recebi".

Se você quer manter esse modelo dentro de uma loja, a Gamecart tem um gateway Manual para pagamentos fora da plataforma: o jogador vê as instruções que você escreveu, e o pedido fica pendente até alguém abrir Sales > Orders e clicar em Approve. A entrega só começa depois dessa aprovação (documentação de gateways).

Cobrança Pix com confirmação automática

Aqui a loja pede ao provedor uma cobrança com valor fechado para aquele pedido. O provedor devolve o QR code e o código copia e cola, e depois informa quando a cobrança foi paga. Ninguém da equipe precisa conferir nada, e a entrega não espera alguém acordar.

Na Gamecart, o dinheiro cai direto na sua conta do provedor.

Como funciona uma compra com Pix

  1. O jogador escolhe o produto, informa o nick e seleciona Pix no checkout.
  2. Uma página mostra o QR code e o código copia e cola.
  3. Ele paga pelo app do banco.
  4. O provedor confirma o pagamento e o pedido passa para aprovado.
  5. O servidor recebe o comando do produto, por exemplo lp user {identifier} parent addtemp vip 30d, com {identifier} trocado pelo nick informado.

Na Gamecart, os comandos marcados como On Purchase entram na fila depois que o pagamento é aprovado. O passo 5 depende de o servidor estar conectado à loja. O guia de VIP automático no Minecraft mostra essa parte.

Enquanto o Pix não é pago

Até a confirmação, o pedido fica pendente e nenhum comando é enviado. Se o jogador pagar e fechar a página, a confirmação chega do mesmo jeito, porque ela vem do provedor.

Toda cobrança Pix tem prazo de validade, definido quando ela é criada. A documentação do Mercado Pago diz que a data de vencimento define "a validade do código de pagamento" enviado ao comprador. Depois que o prazo vence, aquele código não serve mais, e o jogador precisa de uma cobrança nova.

Mercado Pago ou Efí: o que cada um pede

Na Gamecart, o gateway Pix aceita os dois provedores. Você adiciona em Settings > Gateways, clica em Add gateway, escolhe Pix e define o Provider.

Mercado PagoEfí
CredencialAccess token de uma aplicação no Mercado Pago DevelopersClient ID e Client secret de uma aplicação com a API Pix ativada
Arquivo extraNenhumCertificado .p12 do mesmo ambiente das credenciais
Chave PixA conta precisa poder receber PixUma chave Pix da própria conta Efí
TesteToken de teste com Sandbox mode ligadoCredenciais de homologação com Sandbox mode ligado

O Mercado Pago é o mais simples de ligar: um token e pronto. A Efí dá mais trabalho na primeira vez, porque a API Pix dela usa certificado. As credenciais, o certificado e o modo sandbox têm que ser do mesmo ambiente: segundo a documentação da Efí na Gamecart, um secret de produção com certificado de homologação falha na autenticação. A aplicação da Efí precisa dos escopos cob.write, cob.read e payloadlocation.read, em produção e em homologação. Sem o último, o QR code não carrega.

Mais três pontos da configuração:

  • O gateway Mercado Pago (Checkout Pro) é separado do gateway Pix. Para receber Pix pelo Mercado Pago, configure o gateway Pix com o provedor Mercado Pago.
  • Todo gateway novo começa desligado. O jogador só vê o Pix no checkout depois que você liga a chave na lista.
  • Não dá para trocar de provedor enquanto houver um pedido Pix pendente no provedor atual.

Nota

Pix só funciona em lojas que vendem em real (BRL). A moeda é escolhida na criação da loja e não muda depois, então decida isso antes de cadastrar os produtos. O guia de como criar uma loja para seu servidor passa por essa escolha.

Taxas: onde conferir

Os provedores cobram pelo recebimento, e as tarifas mudam. Consulte o valor atual no site de cada um antes de escolher. A tabela de tarifas da Efí separa o Pix recebido por chave ou QR code estático do Pix recebido por QR code dinâmico via API, que é o tipo usado numa loja com confirmação automática. É essa linha que vale para a comparação.

No Mercado Pago, confira as tarifas de Pix no site ou na sua conta, para o tipo de conta que você usa.

A Gamecart não cobra comissão sobre as vendas. Você paga o plano da loja e as tarifas do provedor.

Reembolso, golpe e MED

Pix não tem chargeback como o do cartão de crédito, em que o comprador contesta a compra na operadora. Para devolver o dinheiro de uma venda, quem devolve é você, pela conta do provedor onde o Pix caiu. A API Pix da Efí, por exemplo, registra esse tipo de operação como "Devolução solicitada pelo usuário recebedor do pagamento original".

O caso em que o dinheiro pode sair sem você pedir é o MED, o Mecanismo Especial de Devolução. Pela página de segurança no Pix do Banco Central, o MED é "uma ferramenta exclusiva do Pix para ajudar vítimas de fraude a tentar recuperar valores enviados indevidamente". Funciona assim:

  • a vítima pede a devolução no app do banco, em até 80 dias depois da transação;
  • os recursos na conta de quem recebeu são bloqueados temporariamente;
  • as instituições analisam o caso e, se a fraude for confirmada, o valor pode voltar integral ou parcialmente, conforme o saldo disponível.

A mesma página lista casos em que o MED não se aplica, e o primeiro é este: "Desacordos comerciais: quando há disputa, ou desacordos, sobre o produto ou serviço recebido." Arrependimento ou discussão sobre o que o VIP entrega cai nessa categoria. Já um pagamento feito com a conta bancária invadida de outra pessoa pode acabar num bloqueio na sua conta do provedor.

Por isso, guarde o histórico de cada pedido (nick, data, valor e entrega). Para contestações no cartão, veja o post sobre chargeback no servidor.

Teste antes de abrir para os jogadores

Comece com Sandbox mode ligado e as credenciais de teste do provedor. Depois de trocar para produção, faça uma compra real com valor baixo antes de divulgar.

Dica

Crie um produto de teste barato com um comando inofensivo, como say Pix de teste para {identifier}, compre com a sua própria conta e confira duas coisas: o pedido aprovado em Sales > Orders e o comando como Executed em Integrations > Commands. Depois, remova o produto de teste.

Fontes

  1. https://www.bcb.gov.br/estabilidadefinanceira/pix-sobre
  2. https://www.bcb.gov.br/estabilidadefinanceira/pix-seguranca
  3. https://www.mercadopago.com.br/developers/pt/docs/checkout-api-payments/integration-configuration/integrate-pix
  4. https://sejaefi.com.br/tarifas
  5. https://dev.efipay.com.br/docs/api-pix/gestao-de-pix

Compartilhar

Sobre o autor

Tanz

Fundador da Gamecart, a plataforma de lojas para servidores de Minecraft, Hytale, FiveM e outros jogos.

Abra a loja do seu servidor

Crie uma loja grátis na Gamecart, conecte seu servidor e entregue as compras automaticamente.

Criar loja grátis

Tutorial

Como entregar VIP automático no Minecraft

Plugin ou RCON, comandos do LuckPerms para VIP temporário e permanente, nick do jogador, entrega offline e o que testar antes de vender o primeiro VIP.

Monetização

Como montar e precificar os VIPs do servidor

Um método para definir os VIPs do servidor: partir dos custos, escolher o que cada nível entrega, decidir entre mensal e permanente e testar o preço.