Skip to main content
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.
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

Os termos em negrito seguem os conceitos do Split de Pagamentos.

​
Visão geral da jornada

​
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.
A parte do marketplace não precisa de instrução: ela é o que sobra na conta de recebimento depois dos repasses.
Você não precisa configurar o split padrão da conta. 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 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.
cURL
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).
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. 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 com o id da transação de recebimento.Para monitorar problemas, use Listar repasses 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: 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: quanto o vendedor ainda tem a receber e, informando um período, quanto já recebeu.
cURL
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:
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

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

Campos, validações e cálculo das instruções de split no QR Code.

Acompanhar repasses

Status dos repasses, consultas e cancelamento.

Webhooks de Pix

Trate o recebimento do pedido e os repasses via Pix.