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

# Split no Link de Pagamentos

> Saiba como dividir o valor de um link entre recebedores

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>;
};

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>;
};

## Como funciona o Split de pagamentos?

Ao criar um link via API de sessions ou via dashboard, a Malga possibilita que o recebimento do valor da compra seja dividido entre recebedores.

Para usar essa funcionalidade, é necessário atender aos seguintes itens:

1. Ter uma [subconta](/api-reference/merchants/criacao-de-novo-merchant-para-cobranca) com provedores que suportem split de pagamentos.
2. Defina um ou mais [**recebedores de pagamento**](/api-reference/sellers/criacao-de-um-novo-recebedor). É importante especificar quem será o responsável pelo pagamento das taxas do provedor e pelos reembolsos em caso de chargeback. Essas regras podem ser configuradas individualmente para cada recebedor via API.
   Caso nenhuma configuração seja informada, por padrão consideramos que os recebedores parceiros não são responsáveis por essas obrigações — nesse cenário, a responsabilidade pelas taxas e chargebacks será da sua empresa.

<Info title="Atenção">
  * Não é necessário criar um recebedor para sua empresa. Sempre que a divisão configurada não totalizar 100% do valor da compra, o valor remanescente será automaticamente direcionado para a sua empresa.
  * Só é possível criar links de pagamento com split para recebedores com status igual a **active** ou **parcial**
</Info>

Abaixo, você confere todos os provedores que oferecem suporte ao split e quais deles cobram taxas de processamento e chargeback, sendo configuráveis na [criação do recebedor](/api-reference/sellers/criacao-de-um-novo-recebedor).

| Provedor                                                                                                    | Taxa processingFee                            | Taxa de chargeBack                        | Taxa MDR                                  | Taxa Fee                                  |
| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ----------------------------------------- | ----------------------------------------- | ----------------------------------------- |
| <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="xmark" mode="error" />   | <CheckIcon type="xmark" mode="error" />   |
| <ProviderImage src="https://malga-docs-prod.s3.amazonaws.com/icons/pagarme.svg">Pagarme V5</ProviderImage>  | <CheckIcon type="check" mode="success" />     | <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/pagseguro.svg">PagSeguro</ProviderImage> | <CheckIcon type="xmark" mode="error" />       | <CheckIcon type="xmark" mode="error" />   | <CheckIcon type="xmark" mode="error" />   | <CheckIcon type="xmark" mode="error" />   |
| <ProviderImage src="https://malga-docs-prod.s3.amazonaws.com/icons/braspag.svg">Braspag</ProviderImage>     | <CheckIcon type="check" mode="noSupported" /> | <CheckIcon type="xmark" mode="error" />   | <CheckIcon type="check" mode="success" /> | <CheckIcon type="check" mode="success" /> |
| <ProviderImage src="https://malga-docs-prod.s3.amazonaws.com/icons/malga.svg">Malga</ProviderImage>         | <CheckIcon type="check" mode="success" />     | <CheckIcon type="check" mode="success" /> | <CheckIcon type="xmark" mode="error" />   | <CheckIcon type="xmark" mode="error" />   |

<div className="flex flex-col gap-2 justify-center items-start">
  <div className="flex items-center justify-center gap-4 table-legend">
    <CheckIcon type="check" mode="success" />

    Taxa configurável, você escolhe qual dos recebedores definidos será responsável por ela.
  </div>

  <div className="flex items-center justify-center gap-4 table-legend">
    <CheckIcon type="xmark" mode="error" />

    A taxa é fixa e não suporta a definição durante a transação, apenas diretamente com o provedor.
  </div>

  <div className="flex items-start justify-center gap-4 table-legend">
    <CheckIcon type="check" mode="noSupported" />

    A taxa é feita via tarifas (MDR e Fee), sendo necessário configurá-las no cadastro do recebedor.
  </div>
</div>

Com tudo preparado, basta definir como deseja que a divisão do recebimento aconteça, indicando as seguintes configurações:

* **Tipo de divisão:** indica sob qual valor da compra será calculado o repasse para cada um dos recebedores. Pode ser escolhido definir o valor em porcentagem (%) ou em reais (BRL).
* [**Recebedor:**](/documentations/split/seller) você deverá indicar quem vai compartilhar o valor desta compra.
* **Porcentagem ou valor do recebimento:** é o quanto cada recebedor ganhará nesta compra, podendo ser no mínimo `1%` ou `R$ 0,1`  e no máximo `100%` ou o `total dos itens do pedido em R$`.

<Note>
  **Precedência das regras de split:** se você definir regras de responsabilidade (taxas/chargeback) diretamente na criação do link (transação), elas terão prioridade sobre as regras configuradas no cadastro do recebedor. Isso garante flexibilidade para cenários específicos de venda.
</Note>

<Info>
  O split de pagamentos só funcionará caso a moeda definida na criação do link seja Real Brasileiro (BRL).
</Info>

Confira como fica a criação de uma sessão com split:

<CodeGroup>
  ```bash Request theme={null}
  curl --location 'https://api.malga.io/v1/sessions' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Api-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
     "amount": 1000,
     "name": "Marketplace Order #123",
     "merchantId": "<YOUR_MERCHANT_ID>",
     "paymentMethods": [
        {
           "paymentType": "pix",
           "expiresIn": 10000
        }
     ],
     "items": [
        {
           "name": "Serviço de Consultoria",
           "unitPrice": 1000,
           "quantity": 1,
           "tangible": false
        }
     ],
     "splitRules": [
        {
           "sellerId": "<SELLER_ID_A>",
           "percentage": 80,
           "liable": true,
           "chargeEntireFee": true
        },
        {
           "sellerId": "<SELLER_ID_B>",
           "percentage": 20,
           "liable": false,
           "chargeEntireFee": false
        }
     ]
  }'
  ```

  ```bash Response theme={null}
  {
      "id": "1a349417-5f01-45b1-8b49-977af564ff0b",
      "paymentLink": "https://link.malga.io/1a349417-5f01-45b1-8b49-977af564ff0b",
      "splitRules": [
          {
              "sellerId": "<SELLER_ID_A>",
              "percentage": 80,
              "liable": true,
              "chargeEntireFee": true
          },
          {
              "sellerId": "<SELLER_ID_B>",
              "percentage": 20,
              "liable": false,
              "chargeEntireFee": false
          }
      ],
      ...
  }
  ```
</CodeGroup>

Se desejar mais facilidade e praticidade, não deixe de usar o nosso [**dashboard**](https://dashboard.malga.io/). Por lá, basta um clique e seu link de pagamento com split estará pronto para ser compartilhado com seu cliente! Saiba mais em [Links com split via dashboard](/documentations/payment-link/create-link-using-dashboard).

<img src="https://mintcdn.com/malga/fXEgRvys0jL21ddH/assets/images/dashboard/payment-link/split-step-dashboard.gif?s=611d4baacd18da4f8266444dcc24adf9" alt="Split na dashboard" width="408" height="840" data-path="assets/images/dashboard/payment-link/split-step-dashboard.gif" />

<Info>
  Ficou com dúvida ou necessita de ajuda? Ficaremos felizes em ajudar!
  Fale conosco através do email [suporte@malga.io](mailto:suporte@malga.io).
</Info>


## Related topics

- [Abr 29, 2026 - Split no Link de Pagamento](/release-notes/2026-04-29-Release-Notes.md)
- [Mar 03, 2026 - Link com Split](/release-notes/2026-03-03-Release-Notes.md)
- [Mais releases](/release-notes/releases.md)
- [Split em sessão ou link de pagamento](/documentations/split/split-em-sessao-link.md)