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

# Comissões de afiliados

> Inclua afiliados em pagamentos, assinaturas e links, com comissões de afiliados sobre o líquido e regras claras para as próximas faturas.

Ao criar um pagamento, uma fatura, uma assinatura, uma sessão de checkout ou um link pela API, sua organização pode incluir afiliados
com vínculo ativo e conta aprovada para receber. Cada afiliada recebe um
percentual do que sua organização receberia antes das comissões de afiliados.

Comissões de afiliados estão disponíveis no modo real e no modo teste.
Defina `affiliates` no recurso que origina a venda. O painel oferece a mesma seleção na cobrança, na assinatura e no link.

## Venda com duas afiliadas

A Escola Lumen vende um curso de R$ 200. Depois de R$ 9,98 de taxa de
processamento, a base das comissões de afiliados é R\$ 190,02. Ana recebe 30%
e Caio recebe 10%, sobre essa mesma base:

| Participante | Resultado |
| - | - |
| Ana | R\$ 57,00 |
| Caio | R\$ 19,00 |
| Escola Lumen | R\$ 114,02 |

Incluir Caio não diminui o valor de Ana. Frações de centavo são arredondadas
para baixo e permanecem com a Escola. A soma dos percentuais pode chegar a
100%; cada pagamento tem no máximo 10 recebedores, contando quem vende e as
partes que recebem as taxas.

```bash theme={"theme":"css-variables"}
curl -X POST 'https://api.chargefy.io/v1/payment-intents' \
  -H 'Authorization: Bearer {{API_KEY}}' \
  -H 'Content-Type: application/json' \
  -d '{
    "affiliates": [
      { "affiliate_fee_rate": 3000, "affiliation": "aff_R7mK2pQ9xW4nT8vL" },
      { "affiliate_fee_rate": 1000, "affiliation": "aff_QW2nSe8M5UjR3xKP" }
    ],
    "amount": 20000,
    "currency": "brl",
    "payment_method_types": ["pix"]
  }'
```

Confirme o pagamento normalmente. A resposta do pagamento mostra o combinado
em `affiliates`. Para alterar antes da confirmação, envie a lista inteira no
[update](https://docs.chargefy.io/api-reference/payment-intents/update.md); `[]` remove as comissões de afiliados daquele pagamento.

## Parcelamento e juros

Juros pagos pelo comprador não entram na base das comissões de afiliados.
Quando sua organização oferece parcelamento sem juros e assume esse custo,
a base diminui para todas as afiliadas na mesma proporção.

Por exemplo, se a organização receberia R$ 71 antes das comissões de afiliados num pagamento parcelado sem juros, Ana a 30% recebe R$ 21,30 e Caio
a 10% recebe R\$ 7,10. O recebimento acompanha as parcelas da venda; as datas
confirmadas aparecem nos lançamentos do extrato.

## Validação e conta indisponível

Na criação, um vínculo inválido, conta ainda não aprovada, afiliada repetida,
recebedores na mesma conta ou percentuais acima de 100% recusam a operação
inteira. São até 8 afiliadas em venda direta e 7 em venda com taxa de plataforma.

Se uma afiliada perder a conta ou o vínculo terminar depois da criação,
o comprador pode pagar: somente aquela comissão de afiliado não é paga,
o valor permanece com a organização que vendeu e ambas são avisadas no
painel. As demais afiliadas recebem normalmente. Um erro ao consultar os
termos não é tratado como conta indisponível.

## Extrato, dados do comprador e devoluções

Sua organização vê cada desconto no detalhe do pagamento. Ana vê um
lançamento de R\$ 57, o percentual e a organização que originou o recebimento.
Ela não recebe nome, e-mail, telefone ou documento do comprador, nem acesso
ao pagamento completo da Escola. Essa separação vale para API, exportações
e notificações automáticas.

No reembolso de metade, Ana devolve R$ 28,50 e Caio R$ 9,50. O reembolso
que completa o valor da venda fecha o restante exato de cada participante.
O custo de processamento que não for devolvido permanece com a organização
que vendeu. O extrato só confirma a devolução depois de conferir os valores de
cada participante.

As contestações seguem a responsabilidade congelada em cada cobrança:
na regra de devolução por recebedor, cada parte devolve o que recebeu.

## Chargefy for Platforms

> [!WARNING]
>
> Esta seção só se aplica a contas com o produto **Chargefy for Platforms**
> habilitado, que operam pagamentos para suas organizações filhas.

Ao criar um pagamento para sua organização filha, envie a chave da plataforma
e o cabeçalho `Organization`. Você pode incluir vínculos da organização filha
ou da organização dona da plataforma. A comissão de afiliado sai da
organização que vende; a taxa da plataforma não é reduzida.

```bash theme={"theme":"css-variables"}
curl -X POST 'https://api.chargefy.io/v1/payment-intents' \
  -H 'Authorization: Bearer {{API_KEY}}' \
  -H 'Organization: org_5Nq8rT2wX7mK4pV9' \
  -H 'Content-Type: application/json' \
  -d '{
    "affiliates": [
      { "affiliate_fee_rate": 1000, "affiliation": "aff_R7mK2pQ9xW4nT8vL" }
    ],
    "amount": 10000,
    "currency": "brl",
    "payment_method_types": ["pix"]
  }'
```

A academia Fit Centro vende R$ 100 pela GymOS. Depois da taxa de R$ 8,
a base é R$ 92. Bruno, afiliado da GymOS a 10%, recebe R$ 9,20; Carla,
afiliada da Fit Centro a 10%, também recebe R$ 9,20. A Fit Centro fica com
R$ 73,60, e a receita da GymOS mantém o mesmo valor.

## Assinaturas e links

A Escola Lumen inclui Ana a 30% ao criar uma assinatura de R\$ 200. A primeira
fatura e as mensalidades seguintes levam esse combinado até o pagamento. Uma
fatura gratuita ou de trial não gera comissão de afiliado sem uma cobrança positiva.

O link registra a seleção em cada sessão aberta. Alterar Ana de 30% para 20%
no link muda somente as próximas sessões; as assinaturas vendidas antes
continuam com 30%. Para renegociar uma assinatura específica, envie a lista
completa no [update da assinatura](https://docs.chargefy.io/api-reference/subscriptions/update.md); a
alteração vale apenas para faturas futuras.

Se a Escola encerrar a parceria com Ana, as próximas mensalidades deixam de
incluí-la, inclusive em assinaturas já existentes. Novas vendas e novas
assinaturas também não a incluem. O dinheiro e as parcelas já divididos
permanecem com os participantes originais. Encerrar a parceria não estorna
uma venda.

Use [prévia de pagamento](https://docs.chargefy.io/api-reference/payment-previews/create.md) com o mesmo
`affiliates` para conferir a comissão de afiliado estimada por método antes de vender.


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