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
- No Pagar.me, a conta da plataforma precisa estar com marketplace/split habilitado (pedido ao comercial do Pagar.me).
- Menu Configurações › Pagar.me (split) (aparece para quem tem a área Chaves de pagamento).
- 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.
- Chave secreta (
- Salvar e Testar conexão (lê o recebedor da plataforma).
- No Pagar.me, cadastre o webhook com a URL do webhook da tela, a
autenticação básica acima e os eventos
order.*,charge.*erecipient.*.
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)
- 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.
- Em Webhooks do aplicativo, cadastre a URL de notificações da tela
(troque
<WEBHOOK_TOKEN>pelo valor do servidor) com o evento Pagamentos. - 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.
- 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.
