> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loja.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Perguntas frequentes

> Dúvidas comuns sobre pagamentos, split, taxas, assinaturas e segurança na loja.gg.

<AccordionGroup>
  <Accordion title="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](/guias-do-painel/marketplace-split-payment).
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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`.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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).
  </Accordion>

  <Accordion title="Quem é responsável por um chargeback?">
    Em modo SPLIT, o lojista assume o chargeback. Em modo DIRECT, a plataforma assume. Veja [Chargebacks e disputas](/guias-do-painel/chargebacks-e-disputas).
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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](/guias-do-painel/configuracoes-de-pagamento) da sua loja.
  </Accordion>

  <Accordion title="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](/guias-do-painel/assinaturas).
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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](/guias-do-painel/compliance).
  </Accordion>

  <Accordion title="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](/api-reference/storefront-headless).
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Ainda com dúvidas?

<CardGroup cols={2}>
  <Card title="Discord" icon="discord" href="https://discord.gg/Y5W68B4WYu">
    Comunidade e suporte da loja.gg.
  </Card>

  <Card title="WhatsApp" icon="whatsapp" href="https://wa.me/message/4ZP52GIH2J5LG1">
    Fale diretamente com o time de suporte.
  </Card>
</CardGroup>