> ## 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.

# Marketplace e split payment

> Como funciona a divisão automática de pagamentos entre você e a loja.gg.

A loja.gg pode operar em dois modos de pagamento. Este guia explica o modo **SPLIT**, em que a plataforma funciona como um marketplace de verdade: o pagamento do seu cliente é **dividido automaticamente** no gateway, no momento da transação.

<Tabs>
  <Tab title="DIRECT (padrão)">
    100% do valor vai para a conta da plataforma. A loja.gg é responsável por repassar o valor ao lojista posteriormente.
  </Tab>

  <Tab title="SPLIT (marketplace)">
    O gateway já divide o pagamento: sua parte cai direto na sua conta conectada, e a loja.gg fica apenas com a taxa de marketplace.
  </Tab>
</Tabs>

## Como funciona na prática

```
Cliente paga R$ 100
        │
        ▼
 Gateway (Mercado Pago / Asaas)
        │
   ┌────┴────┐
   ▼         ▼
Plataforma  Lojista
 R$ 4        R$ 96
 (4%)        (96%)
```

## Taxas por plano

A taxa de marketplace cobrada em modo SPLIT depende do plano da sua loja. A tabela abaixo é o exemplo de estrutura usado internamente (percentual sobre cada venda); confirme os valores vigentes no seu painel:

| Plano               | Taxa de marketplace (exemplo) |
| ------------------- | ----------------------------- |
| Plano de entrada    | 4%                            |
| Plano intermediário | 1%                            |
| Plano avançado      | 0,5%                          |

<Warning>
  Os nomes e percentuais exatos podem mudar; os valores acima refletem apenas a lógica de "quanto maior o plano, menor a taxa" documentada internamente. Confirme os números atuais em **Loja → Assinatura**.
</Warning>

Um admin da plataforma também pode definir uma **taxa customizada** para uma loja específica (percentual, valor fixo ou uma combinação dos dois), o que tem prioridade sobre a taxa padrão do plano.

## Conectando seu gateway (OAuth)

Para vender em modo SPLIT, você precisa conectar sua própria conta do gateway à sua loja:

<Steps>
  <Step title="Inicie a conexão">
    No painel, clique em "Conectar" no gateway desejado (Mercado Pago ou Asaas).
  </Step>

  <Step title="Autorize no gateway">
    Você é redirecionado para o site do gateway, faz login e autoriza a aplicação loja.gg.
  </Step>

  <Step title="Callback automático">
    O gateway redireciona de volta para a loja.gg, que troca o código de autorização por um token de acesso e salva as credenciais de forma criptografada.
  </Step>

  <Step title="Pronto para vender em SPLIT">
    A partir daqui, novas vendas dessa loja já saem divididas automaticamente.
  </Step>
</Steps>

<Note>
  A conexão é individual por lojista — não existe forma automatizada de conectar a conta de outra pessoa, por motivos de segurança.
</Note>

Para desconectar o gateway a qualquer momento, use o botão "Desconectar" na mesma tela — a loja volta a operar em modo DIRECT até que uma nova conexão seja feita.

## O que acontece se o gateway não estiver conectado

Se a loja estiver em modo SPLIT mas o lojista ainda não conectou o gateway, novos pedidos falham com um erro específico e o cliente não consegue finalizar a compra até que a conexão seja feita (ou a loja volte para DIRECT).

## Responsabilidade por chargeback

<Warning>
  Em modo **SPLIT**, o **lojista** assume o risco de chargeback — o gateway desconta o valor diretamente da conta dele, enquanto a plataforma mantém a taxa já recebida. Em modo **DIRECT**, a plataforma assume esse risco. Deixe isso claro nos seus termos de uso como lojista.
</Warning>

Veja também [Chargebacks e disputas](/guias-do-painel/chargebacks-e-disputas).

## Webhooks em modo SPLIT

O webhook do gateway sempre atualiza o status do pedido. A diferença é que, em modo SPLIT, ele **não** cria uma transação na [carteira](/guias-do-painel/carteira-e-saques) da loja, porque o dinheiro nunca passa pela conta da plataforma.