> ## Documentation Index > Fetch the complete documentation index at: https://docs.delfinance.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Split para marketplaces > Veja como um marketplace usa o split por cobrança para repassar a parte de cada vendedor e como acompanhar recebimentos e repasses. > [!WARNING] > > **Parte deste guia usa funcionalidades em beta.** As consultas de recebimentos, repasses e valor a receber estão em beta, e o contrato pode mudar antes da versão final. Veja [Acompanhar repasses](https://docs.delfinance.com.br/guias/split-pagamentos/acompanhar-repasses.md). Este guia mostra, de ponta a ponta, como um marketplace usa o Split de Pagamentos da Delfinance: o comprador paga o pedido inteiro, a Delfinance repassa automaticamente a parte de cada vendedor e a parte do marketplace fica na conta dele. Depois, a plataforma consulta os recebimentos e oferece a cada vendedor uma visão do que ele já recebeu e do que tem a receber. ## Quem participa | Papel | Quem é | No Split de Pagamentos | | - | - | - | | **Gestor do marketplace** | A empresa dona do marketplace, titular de uma conta Delfinance | Titular da **conta de recebimento** | | **Plataforma** | O sistema do marketplace, integrado à API da Delfinance | Cria as cobranças e consulta os repasses | | **Cliente final** | Quem compra no marketplace | O pagador do Pix | | **Vendedor** | Quem vende o produto pelo marketplace | O **beneficiário** | | **Conta do vendedor** | A conta bancária onde o vendedor recebe | A **conta do beneficiário**, na Delfinance ou em outro banco | Os termos em negrito seguem os [conceitos do Split de Pagamentos](https://docs.delfinance.com.br/guias/split-pagamentos/visao-geral.md#conceitos). ## Visão geral da jornada ```mermaid theme={null} sequenceDiagram participant C as Cliente final participant P as Plataforma do marketplace participant D as Delfinance participant V as Vendedor P->>P: Aplica as regras internas de comissão ao pedido P->>D: Cria o QR Code com splitPayment (uma instrução por vendedor) D-->>P: QR Code P->>C: Exibe o QR Code no checkout C->>D: Paga o Pix D->>D: Credita o valor integral na conta de recebimento D->>D: Repassa a parte de cada vendedor D-->>P: Webhooks do recebimento e dos repasses P->>D: Lista recebimentos e repasses V->>P: Consulta o que recebeu e o que tem a receber P->>D: Lista repasses e valor a receber do vendedor ``` ## Passo a passo **1. Abra a conta de recebimento** O gestor do marketplace abre uma conta Delfinance. Essa é a **conta de recebimento**: todo pagamento dos pedidos entra nela com o valor integral, e é dela que saem os repasses para os vendedores. A plataforma usa a API key dessa conta e envia o número dela no header `x-delfinance-account-id` em todas as chamadas. **2. Defina as regras de comissão na plataforma** As regras de negócio do marketplace ficam **na sua plataforma**, não na Delfinance. Por exemplo: comissão de 10% por venda, comissão diferente por categoria, valor fixo por pedido, frete repassado integralmente ao vendedor. A cada venda, a plataforma aplica essas regras e transforma o resultado em **instruções de split**, uma por vendedor do pedido. A Delfinance só executa as instruções recebidas em cada cobrança. > [!TIP] > > A parte do marketplace não precisa de instrução: ela é o que sobra na conta de recebimento depois dos repasses. > [!NOTE] > > Você não precisa configurar o [split padrão da conta](https://docs.delfinance.com.br/guias/split-pagamentos/configurar.md). Quando a cobrança traz instruções próprias, elas substituem o split padrão para aquele pagamento. **3. Gere o QR Code do pedido com as instruções de split** No checkout, a plataforma cria um [QR Code dinâmico](https://docs.delfinance.com.br/guias/pix/receber-pix/cobranca-imediata.md) com o valor do pedido e o objeto `splitPayment`. No exemplo abaixo, um carrinho de R\$ 100,00 tem dois produtos de vendedores diferentes, com comissão de 10% para o marketplace: * Produto do vendedor A, de R\$ 60,00: o vendedor recebe R\$ 54,00 em uma conta Delfinance. * Produto da vendedora B, de R\$ 40,00: a vendedora recebe R\$ 36,00 em uma conta de outro banco. * O marketplace fica com R\$ 10,00 na conta de recebimento. ```bash cURL theme={null} curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/dynamic' \ --header 'Content-Type: application/json' \ --header 'x-delbank-api-key: {{apiKey}}' \ --header 'x-delfinance-account-id: {{contaDeRecebimento}}' \ --data '{ "correlationId": "{{idDoPedido}}", "amount": 100.00, "expiresIn": 1800, "formatResponse": "PAYLOAD_AND_QRCODE", "splitPayment": { "canChargeTariffBeforeSplit": true, "instructions": [ { "amount": 54.00, "type": "FIXED", "transferType": "INTERNAL", "beneficiary": { "bankAccountNumber": "10073" } }, { "amount": 36.00, "type": "FIXED", "transferType": "PIX_MANUAL", "beneficiary": { "bankAccountNumber": "123456", "bankAccountBranch": "0001", "participantIspb": "00000000", "bankAccountType": "CURRENT", "holderName": "Maria Souza", "holderDocument": "12345678909" } } ] } }' ``` Use o id do pedido como `correlationId`. Ele volta no webhook de recebimento e liga o pagamento ao pedido na sua plataforma. Veja todos os campos e regras de validação em [Split por cobrança (QR Code)](https://docs.delfinance.com.br/guias/split-pagamentos/split-por-cobranca.md). **4. O cliente paga e os repasses acontecem automaticamente** Quando o cliente final paga o Pix, a Delfinance credita o valor integral na conta de recebimento e, em seguida, faz um repasse para a conta de cada vendedor. A plataforma não precisa fazer nenhuma transferência. A plataforma recebe os webhooks: * `PIX_RECEIVED`, com o pagamento do pedido; * `TRANSFER_INTERNAL_DEBITED`, para cada repasse a uma conta Delfinance; * `PIX_PAYMENT_UPDATED`, para cada repasse via Pix a uma conta de outro banco. **5. Acompanhe os recebimentos do marketplace** Para a gestão do marketplace (conciliação, relatórios, painel financeiro), use [Listar recebimentos com split](https://docs.delfinance.com.br/api-reference/split-pagamentos/listar-recebimentos.md). Cada item mostra o valor integral do pagamento, a tarifa e a base de cálculo dos repasses. Para ver os repasses de um pedido específico, use [Consultar recebimento com split](https://docs.delfinance.com.br/api-reference/split-pagamentos/consultar-recebimento.md) com o `id` da transação de recebimento. Para monitorar problemas, use [Listar repasses](https://docs.delfinance.com.br/api-reference/split-pagamentos/listar-repasses.md) com `status=FAILED` e trate os repasses que falharam. **6. Mostre a cada vendedor o que ele recebeu e o que tem a receber** Para montar a área do vendedor na sua plataforma, filtre as consultas pelo documento do vendedor (`beneficiaryDocument`): * [Listar repasses](https://docs.delfinance.com.br/api-reference/split-pagamentos/listar-repasses.md): o extrato de repasses do vendedor, com o status de cada um. Cada repasse traz o objeto `order`, com o valor integral da venda, a data e a base de cálculo, para o vendedor ver quanto vendeu e quanto recebeu. * [Consultar valor a receber](https://docs.delfinance.com.br/api-reference/split-pagamentos/consultar-valor-a-receber.md): quanto o vendedor ainda tem a receber e, informando um período, quanto já recebeu. ```bash cURL theme={null} curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/payouts?beneficiaryDocument=12345678909&paymentDateFrom=2026-10-01&paymentDateTo=2026-10-31' \ --header 'x-delbank-api-key: {{apiKey}}' \ --header 'x-delfinance-account-id: {{contaDeRecebimento}}' ``` > [!NOTE] > > Nesta fase, todo repasse é executado logo após o pagamento. Por isso, o valor a receber se resume aos repasses Pix ainda em processamento. Com os repasses com data futura, previstos para uma próxima fase, o vendedor também vai ver os valores agendados. ## Tarifa e comissão Com `canChargeTariffBeforeSplit` igual a `true` (padrão), a tarifa de split é descontada do valor recebido antes do cálculo dos repasses. O efeito depende do `type` das instruções: | `type` das instruções | Quem absorve a tarifa | | - | - | | `PERCENTAGE` | Marketplace e vendedores, proporcionalmente, porque os percentuais incidem sobre o valor líquido | | `FIXED` | Só o marketplace, porque os vendedores recebem exatamente o valor informado | > [!WARNING] > > Com valores fixos, deixe margem para a tarifa. Se a soma dos repasses ultrapassar o valor líquido do pagamento, **nenhum** repasse daquele pedido é executado, e o valor integral fica na conta de recebimento. ## Boas práticas > **Guarde o documento de cada vendedor do jeito que a API usa** > > As consultas da área do vendedor filtram pelo CPF ou CNPJ do beneficiário (`beneficiaryDocument`), somente números. Use sempre o mesmo documento do vendedor nas instruções de split e nas consultas. > **Valide os dados bancários dos vendedores no cadastro** > > A Delfinance não valida os dados da conta do beneficiário na criação do QR Code. Um dado incorreto só aparece como falha no momento do repasse. Valide agência, conta, ISPB e documento quando o vendedor se cadastrar na sua plataforma. > **Prefira contas Delfinance para os vendedores** > > Repasses `INTERNAL` são instantâneos e vão direto para `PAID`. Repasses `PIX_MANUAL` dependem da confirmação do Pix pela instituição do vendedor. > **Calcule os valores na plataforma** > > Quando o pedido tem frete, desconto ou comissões diferentes por produto, calcule o valor de cada vendedor na plataforma e envie como `FIXED`. Assim o repasse corresponde exatamente ao que o seu sistema registrou. > **Trate devoluções e cancelamentos de pedido** > > Um repasse só pode ser cancelado antes de ser executado. Nesta fase, os repasses são imediatos, então, se o pedido for devolvido depois do pagamento, o acerto com o vendedor precisa ser feito pela plataforma. ## Próximos passos > **[Split por cobrança](https://docs.delfinance.com.br/guias/split-pagamentos/split-por-cobranca.md)** > > Campos, validações e cálculo das instruções de split no QR Code. > **[Acompanhar repasses](https://docs.delfinance.com.br/guias/split-pagamentos/acompanhar-repasses.md)** > > Status dos repasses, consultas e cancelamento. > **[Webhooks de Pix](https://docs.delfinance.com.br/guias/webhooks/pix.md)** > > Trate o recebimento do pedido e os repasses via Pix. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.