Plataformas
Uma integração, muitas lojas, limites claros.
Para marketplaces, agências e plataformas de software que operam várias lojas: organizações, lojas, papéis de equipe e chaves com escopo mantêm cada cliente (tenant) separado.
Fluxo
Como funciona, passo a passo.
- Plataforma
Organização
Uma organização por empresa lojista, com equipe, cobrança e status de verificação próprios.
org_… - Lojista
Lojas
Cada loja tem sua própria identidade visual de checkout, moeda e endpoints de webhook.
store_… - Desenvolvedores
Chaves com escopo
Chaves live com escopos, restrição opcional por loja, listas de IPs permitidos e exibição única — emitidas após a aprovação.
gp_live_… - Equipe
Papéis
Proprietário, administrador, desenvolvedor, financeiro, suporte e somente leitura, aplicados em cada consulta no servidor.
RBAC - Auditores
Trilha de auditoria
Eventos de auditoria append-only para ações privilegiadas, exportáveis para revisões.
audit_events
Resultados
O que muda para a sua equipe.
Isolamento entre clientes por padrão
O tenant sempre vem do principal autenticado. O acesso entre tenants é testado para cada objeto de lojista.
Identidade visual por loja, com segurança
Nomes e logotipos das lojas vêm de configurações sanitizadas e verificadas — nunca de parâmetros de consulta ou de entradas não confiáveis.
Equipes com privilégio mínimo
O financeiro pode exportar, o suporte pode consultar e os desenvolvedores podem gerenciar chaves — sem que todos sejam proprietários.
Evidências para revisões
Os eventos de auditoria e as linhas do tempo de pagamento dão às equipes de compliance e de suporte os mesmos fatos.
Antes de integrar
O que decidir de antemão.
- Os pagamentos são custodiais: vão para as carteiras da plataforma, e cada lojista saca o próprio saldo por meio de saques aprovados. Chaves privadas nunca são solicitadas aos lojistas.
- Os pagamentos reais são ativados por organização depois que a verificação da empresa é aprovada e os requisitos de liberação da plataforma são cumpridos; planeje seu onboarding com isso em mente.
- A verificação da empresa é um processo manual até que um provedor de verificação seja integrado — mostre aos lojistas “pendente”, não “verificado”.
- Decida em quais eventos de webhook cada loja se inscreve e quem faz a rotação dos segredos de assinatura.