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

# Configurações de pagamento

> Conecte gateways de pagamento e escolha os métodos aceitos na sua loja.

Em **Loja → Configurações → Pagamentos** você conecta os gateways que vai usar e ativa os métodos de pagamento oferecidos no checkout.

## Gateways suportados

<CardGroup cols={2}>
  <Card title="Mercado Pago" icon="credit-card">
    PIX, cartão de crédito e (no modo marketplace) split automático via conta Mercado Pago do lojista.
  </Card>

  <Card title="Asaas" icon="banknote">
    PIX, boleto, cartão de crédito e split de pagamentos.
  </Card>
</CardGroup>

## Métodos de pagamento

<Tabs>
  <Tab title="PIX">
    Pagamento instantâneo com QR Code. A confirmação chega via webhook, geralmente em segundos.
  </Tab>

  <Tab title="Cartão de crédito">
    Processamento em tempo real, com confirmação imediata do pedido.
  </Tab>

  <Tab title="Boleto">
    Vencimento configurável (padrão de alguns dias), com código de barras e PDF gerados automaticamente. Confirmação também via webhook, podendo levar até alguns dias úteis.
  </Tab>
</Tabs>

<Note>
  Cada gateway precisa ser habilitado individualmente por método — ou seja, é possível, por exemplo, aceitar PIX pelo Mercado Pago e boleto pelo Asaas na mesma loja.
</Note>

## Como aparece para o cliente no checkout

Quando mais de um gateway está conectado e ativo, o checkout exibe os gateways como **abas**, e o cliente escolhe qual usar. Dentro de cada aba, o cliente escolhe o método (cartão, PIX ou boleto) — apenas os métodos habilitados para aquele gateway aparecem.

## Taxas por gateway e método

O painel exibe, na própria tela de configuração de pagamentos, quais são as taxas cobradas por cada gateway em cada método — para que você saiba exatamente o custo de cada venda antes de ativar um método.

<Warning>
  As taxas de gateway (cobradas pelo Mercado Pago/Asaas) são diferentes da **taxa de marketplace da loja.gg**, que é a taxa que a plataforma retém quando o pagamento é processado em modo split. Veja [Marketplace e split payment](/guias-do-painel/marketplace-split-payment) para entender a diferença.
</Warning>

## Modo de operação: DIRECT vs. SPLIT

| Aspecto                   | DIRECT                               | SPLIT (marketplace)                        |
| ------------------------- | ------------------------------------ | ------------------------------------------ |
| Para onde vai o pagamento | 100% para a conta da plataforma      | Dividido automaticamente no gateway        |
| Repasse ao lojista        | Manual, feito pela plataforma depois | Automático, direto na conta do lojista     |
| Configuração necessária   | Nenhuma                              | Lojista precisa conectar a conta via OAuth |
| Risco de chargeback       | Assumido pela plataforma             | Assumido pelo lojista                      |

## Testando pagamentos

Use o ambiente de sandbox de cada gateway antes de ir para produção. Cartões de teste comuns:

| Bandeira   | Número                | CVV   | Resultado |
| ---------- | --------------------- | ----- | --------- |
| Visa       | `4242 4242 4242 4242` | `123` | Aprovado  |
| Mastercard | `5555 5555 5555 4444` | `123` | Aprovado  |
| Visa       | `4000 0000 0000 0002` | `123` | Recusado  |

No sandbox, PIX e boleto podem ser marcados como pagos manualmente pelo painel do próprio gateway.
