Qual a diferença entre o modo DIRECT e o modo SPLIT?
Qual a diferença entre o modo DIRECT e o modo SPLIT?
No DIRECT, 100% do pagamento vai para a conta da plataforma, que repassa o valor ao lojista manualmente depois. No SPLIT, o pagamento é dividido automaticamente pelo gateway no momento da compra: o lojista recebe a parte dele direto na própria conta, e a loja.gg fica só com a taxa de marketplace. Veja Marketplace e split payment.
Posso usar os dois modos ao mesmo tempo?
Posso usar os dois modos ao mesmo tempo?
O modo de pagamento é definido no nível da loja. Uma loja específica pode não ter o gateway conectado via OAuth — nesse caso, ela continua operando em DIRECT mesmo que o padrão da plataforma seja SPLIT.
Preciso de aprovação do gateway para vender em modo SPLIT?
Preciso de aprovação do gateway para vender em modo SPLIT?
Sim. Para o Mercado Pago é necessário registrar uma aplicação do tipo “Marketplace” no painel de desenvolvedores do Mercado Pago e aguardar aprovação. Para o Asaas, é preciso contatar o suporte comercial deles para habilitar o Split de Pagamentos na sua conta.
Como são calculadas as taxas de marketplace?
Como são calculadas as taxas de marketplace?
A prioridade de cálculo é: taxa customizada definida por um admin da plataforma para a sua loja (se existir) > taxa padrão do seu plano. A fórmula é
taxa_plataforma = (total × percentual / 100) + taxa_fixa e valor_lojista = total - taxa_plataforma.O que acontece se eu não conectar meu gateway e a loja estiver em modo SPLIT?
O que acontece se eu não conectar meu gateway e a loja estiver em modo SPLIT?
Novos pedidos falham com um erro informando que o lojista precisa conectar a conta do gateway primeiro. As soluções são: conectar o gateway via OAuth, ou pedir para o suporte mudar a loja temporariamente para DIRECT.
O token de conexão do gateway expira?
O token de conexão do gateway expira?
Sim, mas o sistema tenta renovar automaticamente usando o refresh token. Se a renovação falhar, o lojista recebe uma notificação e precisa reconectar via OAuth — enquanto isso, as vendas dessa loja ficam pausadas em modo SPLIT.
Posso desconectar um gateway já conectado?
Posso desconectar um gateway já conectado?
Sim, direto pelo painel, na tela de conexão do gateway. Depois de desconectado, a loja não consegue mais processar pagamentos em SPLIT com aquele gateway até reconectar (ou mudar para DIRECT).
Quem é responsável por um chargeback?
Quem é responsável por um chargeback?
Em modo SPLIT, o lojista assume o chargeback. Em modo DIRECT, a plataforma assume. Veja Chargebacks e disputas.
Cupons e promoções expiram?
Cupons e promoções expiram?
Cupons podem ter data de início e expiração configuráveis, além de um limite de resgates. Uma taxa/desconto customizado definido manualmente (como uma taxa de marketplace zerada por um admin) não expira sozinho — precisa ser removido explicitamente.
Vocês suportam PIX, cartão e boleto?
Vocês suportam PIX, cartão e boleto?
Sim, através dos gateways integrados (Mercado Pago e Asaas). Cada método pode ser habilitado ou desabilitado individualmente por gateway nas configurações de pagamento da sua loja.
Como funcionam as assinaturas (produtos recorrentes)?
Como funcionam as assinaturas (produtos recorrentes)?
Um produto pode ser configurado para cobrar em um intervalo (diário, semanal, mensal ou anual). Cada compra desse produto gera uma assinatura, cobrada automaticamente por um job que roda duas vezes ao dia. Veja Assinaturas e recorrência.
O que acontece se uma cobrança de assinatura falhar várias vezes?
O que acontece se uma cobrança de assinatura falhar várias vezes?
O sistema tenta novamente automaticamente (até um número configurável de tentativas, padrão 3). Depois de esgotadas as tentativas, a assinatura é cancelada automaticamente e uma notificação é enviada.
As credenciais de gateway conectadas via OAuth são seguras?
As credenciais de gateway conectadas via OAuth são seguras?
Sim — ficam armazenadas de forma criptografada, nunca são expostas em respostas de API, os tokens de acesso têm expiração e a conexão usa um token de estado (
state) para se proteger contra ataques CSRF.Preciso emitir nota fiscal das taxas de marketplace?
Preciso emitir nota fiscal das taxas de marketplace?
Sim, a plataforma emite nota fiscal de serviço referente às taxas de marketplace retidas. Para o enquadramento tributário do seu negócio como lojista, consulte um contador. Veja Compliance.
Como funciona a API headless de storefront?
Como funciona a API headless de storefront?
É uma API pública para quem quer montar a própria vitrine (Next.js ou qualquer outra stack) usando o catálogo, o carrinho e o checkout da loja.gg, mantendo o processamento de pagamento na loja.gg. Veja Storefront headless.
Onde posso reportar um problema ou tirar dúvidas técnicas?
Onde posso reportar um problema ou tirar dúvidas técnicas?
Pelo Discord ou WhatsApp da loja.gg (veja os cards logo abaixo), ou pelo e-mail de suporte informado no seu painel.
Ainda com dúvidas?
Discord
Comunidade e suporte da loja.gg.
Fale diretamente com o time de suporte.