Split

Pedidos com múltiplos recebedores, repartindo valor ou percentual da transação.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da Pagar.me v5 (versão clássica). Para projetos novos, explore o API Catalog.

Utilizando a funcionalidade de Split, você pode criar um pedido que terá mais de um recebedor. Tais recebedores terão acesso a parte do valor da compra. Cada pedido na Pagar.me pode ter informados os valores ou as porcentagens que serão destinados a cada um dos recebedores.

Funcionalidade exclusiva PSP

Esta funcionalidade está disponível apenas para clientes PSP.

Para dar prosseguimento a esse tipo de pedido, é necessário que dentro de payments seja indicado que está sendo feito um Split com os seguintes dados:

  • type — tipo de Split. Pode ser feita em valores (flat) ou em porcentagem (percentage)
  • amount — valor destinado a cada recebedor
  • recipient_id — identificação do recebedor

Além disso, é necessária a criação dos recebedores e de suas contas bancárias para que os valores lhes sejam destinados corretamente.

Ações relativas a Split

  1. Criar recebedor
  2. Editar recebedor
  3. Criar pedido com Split

Exemplo

Valter anunciou seu carro em um Marketplace com o valor de R$15.000,00. Felizmente, a venda foi concluída com sucesso, mas ao final da negociação, ele só recebeu R$14.850,00. Isso porque o Marketplace havia acertado, via API Pagar.me, que 1% da venda (R$150,00) deveria ser enviada para sua conta e o restante (99%) para a conta de Valter.


Jornada: Montar um marketplace
Etapa 2 de 10