Skip to main content

​
O que são Merchants?

Os Merchants são subcontas gráficas que permitem separar o dinheiro quando você tem múltiplos clientes, mas mantendo tudo na mesma conta principal. Com os merchants, você consegue organizar melhor seus recebimentos através de wallets específicas com split nas transações.
Os merchants funcionam como “subcontas” dentro da sua conta principal, permitindo separação organizacional dos recebimentos sem criar contas bancárias separadas.

​
Conceitos Importantes

​
Merchants vs Conta Principal

  • Conta Principal: Sua conta na Pronttus onde todos os valores são centralizados
  • Merchants: Subcontas gráficas para organização interna
  • Wallets: Carteiras específicas dentro de cada merchant para controle de saldo

​
Split de Transações

Com merchants ativados, você pode configurar splits nas transações para:
  • Dividir valores entre diferentes merchants
  • Controlar percentuais ou valores fixos
  • Organizar recebimentos por cliente/projeto
Para ativar a funcionalidade de split nas transações, é necessário contatar o suporte da Pronttus.

​
Casos de Uso

​
E-commerce com Múltiplos Vendedores

Crie um merchant para cada vendedor da sua plataforma e configure splits automáticos nas vendas. Exemplo: Marketplace onde você cobra 15% de comissão
  • Vendedor recebe: 85% do valor
  • Plataforma recebe: 15% de comissão

​
Marketplace

Organize recebimentos por categoria de produto ou região usando merchants diferentes. Exemplo: Plataforma com diferentes categorias
  • Merchant “Eletrônicos”
  • Merchant “Roupas”
  • Merchant “Casa e Jardim”

​
Franquias

Separe recebimentos por unidade franqueada mantendo controle centralizado. Exemplo: Rede de restaurantes
  • Merchant “Unidade Centro”
  • Merchant “Unidade Shopping”
  • Merchant “Unidade Aeroporto”

​
Como Funciona o Split

​
Estrutura de Merchants

Conta Principal (Pronttus)
├── Merchant "Vendedor A"
│   └── Wallet Principal (Saldo: R$ 850,00)
├── Merchant "Vendedor B"
│   └── Wallet Principal (Saldo: R$ 1.200,00)
└── Merchant "Comissões"
    └── Wallet Principal (Saldo: R$ 300,00)

​
Fluxo de Split

  1. Cliente paga R$ 100,00 → Transação criada
  2. Split configurado:
    • 85% para Vendedor A (R$ 85,00)
    • 15% para Comissões (R$ 15,00)
  3. Valores distribuídos automaticamente para as wallets
  4. Saldo atualizado em cada merchant

​
Tipos de Split

​
Split Fixo (FIXED)

Divide um valor específico em centavos para uma wallet. 
{
  "amount": 1000,
  "mode": "FIXED",
  "wallet_id": "550e8400-e29b-41d4-a716-446655440000"
}

​
Split Percentual (PERCENTAGE)

Divide uma porcentagem do valor total da transação. 
{
  "amount": 15,
  "mode": "PERCENTAGE",
  "wallet_id": "660e8400-e29b-41d4-a716-446655440001"
}

​
Exemplo Prático

Para uma transação de R$ 100,00 (10000 centavos) com split: 
{
  "amount": 10000,
  "split": {
    "amount": 2000,
    "mode": "FIXED",
    "wallet_id": "wallet-vendedor-1"
  }
}
Resultado:
  • Wallet do vendedor: R$ 20,00 (fixo)
  • Wallet de comissão: R10,00(10 10,00 (10% de R 100,00)
  • Conta principal: R$ 70,00 (restante)

​
Fluxo de Trabalho

1

Criar Merchants

Crie merchants para cada cliente/vendedor que precisa de separação de recebimentos.Cada merchant terá suas próprias wallets para controle de saldo.
2

Configurar Split

Nas transações, configure o objeto split para dividir valores automaticamente. Você pode usar valores fixos ou percentuais conforme necessário.
3

Monitorar Saldos

Use o endpoint de saldo para acompanhar os valores em cada merchant. Configure webhooks para receber notificações de transações.
4

Gerenciar Saques

Quando necessário, transfira valores das wallets dos merchants para sua conta principal.Mantenha controle sobre quando e quanto sacar de cada merchant.

​
Benefícios

​
Organização Financeira

  • Separação clara de recebimentos por cliente/projeto
  • Controle granular de saldos
  • Relatórios detalhados por merchant

​
Flexibilidade

  • Splits automáticos nas transações
  • Configuração por valor fixo ou percentual
  • Múltiplos splits na mesma transação

​
Escalabilidade

  • Suporte a centenas de merchants
  • APIs otimizadas para alto volume
  • Webhooks para automação

​
Limitações e Considerações

​
Ativação Necessária

  • Funcionalidade de split precisa ser ativada pelo suporte
  • Entre em contato para habilitar em sua conta

​
Validações

  • Soma dos splits não pode exceder o valor total
  • Wallet IDs devem ser válidos e existentes
  • Valores devem estar dentro dos limites permitidos

​
Custos

  • Consulte com o suporte sobre tarifas específicas
  • Pode haver custos adicionais para funcionalidades avançadas

​
Próximos Passos

Referência da API

Veja todos os endpoints disponíveis

Exemplo Prático

Implementação completa de marketplace

Split em Cobranças

Como usar split nas transações

Webhooks

Configure notificações automáticas

​
Suporte

Precisa de ajuda para implementar merchants? Estamos aqui para ajudar:
  • E-mail: [email protected]
  • WhatsApp: +55 (11) 99999-9999
  • Horário: Segunda a Sexta, 9h às 18h (BRT)