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

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# Começando em Split de pagamentos

> Conheça os modos de uso do split de pagamentos na Malga: cobrança direta via POST /v1/charges ou regras configuradas na criação da sessão e link.

export const CheckIcon = ({mode, type, id}) => {
  const colorIcons = {
    'error': '#919191',
    'success': '#00AE42',
    'noSupported': '#919191'
  };
  const foundColor = colorIcons[mode];
  const iconType = mode === 'noSupported' ? type : `circle-${type}`;
  return <div className="check-icon" id={id}>
      <Icon icon={iconType} iconType="regular" color={foundColor} size={18} />
    </div>;
};

export const ProviderImage = ({src, backgroundColor = '#F9F9F9', children, docUrl, id}) => {
  const borderColors = {
    '#F9F9F9': '#E5E5E5',
    '#030303': '#4D4D4D'
  };
  const borderColor = borderColors[backgroundColor];
  const img = <>
    <img className="rounded-lg p-2 m-0" id={id} src={src} noZoom style={{
    background: backgroundColor,
    border: `solid 3px ${borderColor}`,
    width: "36px",
    height: "36px"
  }} />
    <p className="m-0">{children}</p>
  </>;
  if (docUrl) {
    return <a className="flex items-center gap-2 flex-row border-none" href={docUrl}>
        {img}
      </a>;
  }
  return <div className="flex items-center gap-2 flex-row" href={docUrl}>
      {img}
    </div>;
};

O **Split de Pagamentos** é um serviço que divide recebíveis de maneira automática, entre duas ou mais partes envolvidas em uma transação,
usado por marketplaces, franquias, aplicativos de delivery, entre outros tipos de negócios que têm a necessidade de
fazer a divisão de recebíveis.

## Métodos de pagamento suportados

Os métodos de pagamento suportados pelo serviço de split são:

| Provedor | Cartão | Pix | Boleto |
| - | - | - | - |
| <ProviderImage src="https://malga-docs-prod.s3.amazonaws.com/icons/braspag.svg">Braspag</ProviderImage> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="xmark" mode="error" /> | <CheckIcon type="xmark" mode="error" /> |
| <ProviderImage backgroundColor="#fff" src="https://malga-docs-prod.s3.amazonaws.com/icons/pagarme-v5.svg">Pagarme v5</ProviderImage> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |
| <ProviderImage backgroundColor="#fff" src="https://malga-docs-prod.s3.amazonaws.com/icons/pagseguro.svg">PagSeguro</ProviderImage> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="xmark" mode="error" /> | <CheckIcon type="xmark" mode="error" /> |
| <ProviderImage src="https://malga-docs-prod.s3.amazonaws.com/icons/zoop.svg">Zoop</ProviderImage> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |
| <ProviderImage src="https://malga-docs-prod.s3.amazonaws.com/icons/malga.svg">Sandbox</ProviderImage> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |

## Recebedores do Split

Os **recebedores (sellers)** precisam estar **cadastrados antes** de aparecer em `splitRules`. Na cobrança **direta** e na **criação da sessão** com split, os identificadores de seller informados devem corresponder a recebedores já existentes. O serviço de **sessions** valida essa existência ao criar a sessão; no fluxo da transação, a Malga trata o encadeamento com o provedor e o status do seller para a captura.

Para cadastro e gestão, veja [**Recebedor (seller)**](/documentations/split/seller) e a [API de sellers](/api-reference/sellers/criacao-de-um-novo-recebedor).

## Dois modos de uso do split

O split pode ser utilizado de duas formas; em ambas, cada regra referencia um `sellerId` válido.

### 1. Cobrança direta (`POST /v1/charges`)

Você envia **`splitRules` no corpo** da criação da cobrança. A Malga aplica essas regras nessa transação. Guia completo: [Cobrança com Split](/documentations/split/split).

### 2. Sessão ou link de pagamento

Você envia **`splitRules` ao criar a sessão** (`POST /v1/sessions`). As regras ficam **armazenadas na sessão**. No pagamento (`POST /v1/sessions/{id}/charge`), você **não** reenvia `splitRules`; a cobrança **herda** o split definido na sessão. Detalhes e exemplos: [Split em sessão ou link de pagamento](/documentations/split/split-em-sessao-link).

<Warning>
  Em pagamento de sessão, **não** inclua `splitRules` no corpo da requisição de cobrança. Configure o split apenas na criação da sessão.
</Warning>


## Related topics

- [Começando em meios de pagamento](/documentations/payment-methods/intro.md)
- [Começando em Painel de Dados](/documentations/dashboard/insights/intro.md)
- [Começando em SDK de Tokenização](/sdks/tokenization/v2/intro.md)
- [Split em sessão ou link de pagamento](/documentations/split/split-em-sessao-link.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.