Split e vendedores

O split de pagamento permite dividir o valor de uma venda entre participantes cadastrados. O comprador faz um único pagamento, e a divisão segue as regras informadas à Cyclopay.

Em um marketplace, por exemplo, a plataforma pode receber sua comissão e a loja parceira receber o restante, sem que o estabelecimento precise calcular e realizar cada repasse manualmente.

Onde o split é usado

• Marketplaces: a plataforma recebe uma comissão e a loja ou o prestador recebe sua parte.
• Plataformas de serviços: o valor é distribuído entre os participantes previstos no negócio.
• Franquias e redes: a cobrança pode ser dividida entre unidade, franqueadora e outros recebedores.

Quem participa da divisão

O recebedor principal é identificado como primary. Outros participantes são cadastrados como sellers e vinculados à regra de split.

O seller precisa estar cadastrado e com situação compatível com o recebimento. O cadastro pode passar por análise; quando previsto, mudanças de situação podem ser informadas por webhook.

Como dividir o valor

Há três tipos de divisão:

Valor fixo

Define uma quantia para determinado participante em cada operação. Por exemplo, uma taxa de serviço de R$ 10,00.

Percentual

Calcula a participação sobre o valor da venda, como uma comissão de 15%.

Valor restante

Direciona o saldo que sobra depois de aplicar as outras divisões, conforme as regras do contrato.

Exemplo de marketplace

Em uma compra de R$ 200,00, uma plataforma com comissão de 15% recebe R$ 30,00. A loja parceira fica com R$ 170,00, considerando apenas os valores deste exemplo conceitual.

flowchart TD
    A["Comprador paga R$ 200,00"]
    B["Venda processada pela Cyclopay"]
    C["Plataforma recebe R$ 30,00 (15%)"]
    D["Loja parceira recebe R$ 170,00"]

    A --> B
    B --> C
    B --> D

    classDef default fill:#1c2026,stroke:#434b57,color:#f0f2f5
    classDef receiver fill:#173d30,stroke:#36a67a,color:#d9f6e8
    class C,D receiver

Os valores são ilustrativos. A distribuição efetiva depende do contrato e da configuração dos recebedores.

Outros exemplos

O que definir antes de integrar

1. Quais participantes receberão valores.
2. Qual regra determina a participação de cada um.
3. Quem receberá o saldo restante.
4. Como cancelamentos e reembolsos serão registrados entre os participantes.
5. Como cada recebedor aparecerá na conciliação financeira.

Para quem vai integrar

Cada seller é identificado por um identificador próprio. Os tipos de divisão dos valores possiveis sãoAMOUNT, PERCENTAGE e REMAINING. Consulte a Referência da API para verificar a participação do primary, a unicidade de sellers e o tratamento do saldo.