API de Pagamentos com Split Automático para Marketplaces

Quando um cliente paga R$ 100,00 por um serviço na sua plataforma e você repassa R$ 80,00 ao prestador retendo R$ 20,00 de comissão (take-rate), existem dois caminhos:

• Sem Split (Incorreto): Os R$ 100,00 transitam pela conta da sua empresa. A Receita Federal interpreta os R$ 100,00 como faturamento bruto do marketplace, gerando bitributação sobre o dinheiro do parceiro.
• Com o Split da Brief App (Correto): O pagamento é fragmentado na origem no gateway. Sua empresa fatura apenas a comissão de intermediação (R$ 20,00) e o parceiro recebe diretamente o valor líquido com nota fiscal avulsa ou MEI.

A Brief App suporta Asaas, Mercado Pago e PagBank com roteamento dinâmico. Se um gateway apresentar instabilidade ou rejeição, o sistema pode direcionar o tráfego sem que seu código precise alterar uma única linha:

• Chaves no Vault: Suas credenciais bancárias e tokens de produção ficam protegidos no HashiCorp Vault.
• Webhooks Seguros (HMAC): Todos os avisos de confirmação de pagamento passam por validação criptográfica (HMAC-SHA256 em Hex ou Base64) antes de atualizar o saldo do prestador.
• Idempotência Obrigatória: Header X-Idempotency-Key previne cobrança duplicada caso o cliente clique repetidas vezes no botão de pagamento.

Para iniciar uma transação com divisão automática de repasse, chame o endpoint central de pagamentos:

POST /api/payments
Authorization: Bearer <token>
X-Idempotency-Key: 7b2e1a34-9c02-4d22-b5e1-88c9321ef102
Content-Type: application/json

{
  "valor": 120.00,
  "metodo": "Pix",
  "descricao": "Atendimento Odontológico - Dr. Carlos",
  "clienteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "parceiroId": "c83b194a-81a2-4a0b-9321-df54129031ef",
  "percentualRepasseParceiro": 80.0
}

Resposta com QR Code PIX e dados de Split:

{
  "cobrancaId": "cob_920194812",
  "transactionId": "tx_asaas_88291039",
  "status": "Pendente",
  "valorTotal": 120.00,
  "pixQrCode": "00020126580014br.gov.bcb.pix...",
  "pixCopiaECola": "00020126580014br.gov.bcb.pix0136...",
  "split": {
    "valorPlataforma": 24.00,
    "valorLiquidoParceiro": 96.00,
    "status": "Pendente"
  }
}

O ciclo financeiro da Brief App contempla as situações de exceção do mundo real de uma startup:

• Bloqueio Preventivo (POST /api/payments/splits/{splitId}/bloquear): Em caso de contestação pelo cliente ou suspeita de fraude, a plataforma congela o repasse antes da liquidação bancária.
• Liquidação Manual (POST /api/payments/splits/{splitId}/liquidar): Fallback administrativo para liberar repasses retidos.
• Estorno Total ou Parcial (POST /api/payments/{cobrancaId}/refund): Desfaz a transação no gateway e atualiza o ledger financeiro automaticamente.
• Saques e Repasses via PIX (POST /api/transfers): O parceiro solicita o saque do saldo acumulado para sua chave PIX cadastrada (validada via KYC).

Nosso modelo é alinhado ao seu sucesso: cobramos uma taxa fixa de R$ 0,50 por transação liquidada mais um take-rate transparente (de 0,5% a 1,5% conforme o volume). A mensalidade do plano (Builder, Scale ou Enterprise) já cobre o banco de dados multitenant, monitoramento e failover.

Simular custos do meu marketplace