Pular para o conteúdo

Para equipe ilarika

Recebimento online das lojas (split) e taxas da plataforma

  • Super AdminConfiguraçõesPagar.me (split)
  • Super AdminConfiguraçõesMercado Pago (split)
  • Super AdminRedeTaxas da plataforma

O iLarika fica com um percentual (padrão 1%) de cada pagamento online que o cliente faz à loja — Pix automático e cartão online, pelo cardápio, app ou WhatsApp. O dinheiro da loja vai para a conta da loja; a taxa vai direto para a conta da plataforma, dentro do próprio provedor (split). Aqui o superadmin cadastra as credenciais dos provedores e acompanha quanto a taxa rendeu. A cobrança da assinatura das lojas é outra coisa, pelo Asaas: veja Asaas: cadastrar a chave do gateway de cobrança.

Antes de começar

  • Credenciais: pedem a área Chaves de pagamento (ver e mudar para alterar). O relatório de taxas pede a área Recebimentos das lojas (Time iLarika).
  • Tudo o que é segredo (chave secreta, client secret, senha do webhook) é gravado cifrado e nunca volta para a tela (“termina em …abcd”). A troca vale em até 30 s, sem reiniciar a API.

Passo a passo — Pagar.me (split), o provedor principal

  1. No Pagar.me, a conta da plataforma precisa estar com marketplace/split habilitado (pedido ao comercial do Pagar.me).
  2. Menu Configurações › Pagar.me (split) (aparece para quem tem a área Chaves de pagamento).
  3. Preencha:
    • Chave secreta (sk_… produção, sk_test_… sandbox) e Chave pública (pk_…);
    • Recebedor da plataforma (rp_…, Dashboard › Recebedores — o recebedor padrão da conta): é para ele que vai a taxa;
    • Usuário e Senha do webhook (autenticação básica);
    • Tarifas do Pagar.me (Pix %, cartão %, tarifa fixa, observação) — só para a loja ver antes de aceitar;
    • Taxa iLarika (%) — a mesma para os dois provedores.
  4. Salvar e Testar conexão (lê o recebedor da plataforma).
  5. No Pagar.me, cadastre o webhook com a URL do webhook da tela, a autenticação básica acima e os eventos order.*, charge.* e recipient.*.

Como funciona: cada loja vira um recebedor na conta da plataforma (a loja não precisa de conta no Pagar.me). Toda cobrança leva duas regras de split em valor fixo: a taxa exata para o recebedor da plataforma (sem responder por chargeback nem tarifa) e o resto para o recebedor da loja, que paga as tarifas de processamento e responde por chargeback. O repasse à loja é diário e automático.

Passo a passo — Mercado Pago (split)

  1. No painel de desenvolvedores do Mercado Pago, com a conta da plataforma, crie um aplicativo do tipo marketplace / pagamentos online (Checkout Transparente e Checkout Pro), com o fluxo OAuth (authorization code). Em URLs de redirecionamento, cadastre a URL de redirecionamento (OAuth) da tela. Deixe o PKCE desligado.
  2. Em Webhooks do aplicativo, cadastre a URL de notificações da tela (troque <WEBHOOK_TOKEN> pelo valor do servidor) com o evento Pagamentos.
  3. Menu Configurações › Mercado Pago (split): cole o Client ID (número do aplicativo), o Client secret e o User ID da conta da plataforma.
  4. Salvar. As lojas já podem tocar em Conectar Mercado Pago.

Como funciona: a loja autoriza o aplicativo da plataforma na conta dela (OAuth); cada cobrança feita com o token da loja leva application_fee (Pix) ou marketplace_fee (link de cartão). O token da loja vale ~180 dias e é renovado sozinho 30 dias antes de vencer.

Taxas da plataforma

Menu Rede › Taxas da plataforma: por loja, mês e provedor, o número de pagamentos, o valor, a taxa cobrada, a devolvida em estornos e a líquida. Os números saem dos registros de pagamento (o que foi mandado ao provedor), nunca digitados. Escolha o período em De e Até.

Perguntas comuns

E as lojas que colavam o token do Mercado Pago? Continuam recebendo, sem a taxa, até reconectar pelo botão. O painel delas mostra o aviso para reconectar, e colar token não é mais aceito.

A taxa pode ficar abaixo de R$ 0,01? Não: todo pagamento online paga ao menos R$ 0,01.

Outro provedor no futuro? A cobrança passa por uma porta única (PaymentPort, com taxaDaPlataforma); um provedor novo é um adaptador a mais, sem mexer no cardápio nem no WhatsApp.

Se der errado

  • “Chave secreta do Pagar.me inválida” / “Recebedor da plataforma inválido”: confira o prefixo (sk_, rp_).
  • Testar conexão falha com 401: chave de outro ambiente (sandbox × produção).
  • Webhook recusado (401): usuário/senha do webhook diferentes no Pagar.me e aqui.
  • Loja diz “Ainda não disponível”: as credenciais daquele provedor não estão completas.