Conta e acesso
- E-mail da conta verificado.
- Autenticação em dois fatores ativa.
- Códigos de recuperação guardados com segurança. Recuperação de senha exige o link do e-mail e o segundo fator quando o 2FA está ativo; não use scripts para contornar essa confirmação.
- Organização habilitada para produção.
- Provedor financeiro configurado e homologado.
- KYC aprovado antes do primeiro saque.
Integração
- Chave
mp_live_guardada no servidor e com menor conjunto de escopos. - Segredos separados entre sandbox e produção.
Idempotency-Keypersistida por tentativa.- Timeout, backoff e reconciliação implementados.
- Nenhum token completo em logs, analytics ou alertas.
Webhooks
- Endpoint HTTPS público e separado por ambiente.
- Assinatura validada sobre o corpo bruto.
- Janela de timestamp de até cinco minutos.
- Evento deduplicado pelo
id. - Falhas visíveis e reprocessáveis no dashboard.
Proteção de tráfego
O site e a dashboard podem apresentar uma verificação de navegador ou HTTP 429 durante excesso de requisições. SDKs e webhooks devem usar os endpoints da API documentada, sem depender da automação de páginas do painel. RespeiteRetry-After e não repita operações financeiras com novas chaves idempotentes para contornar uma falha de acesso.
Tarifas e valores líquidos
Confira a tarifa da organização antes de operar: o padrão é R 0,45 por saída Pix, com o custo do provedor já incluído. Subcontas seguem a mesma tarifa da organização. Na cobrança,feeCents é a tarifa total, providerFeeCents é o custo do provedor e platformFeeCents é a diferença; netCents é o valor após a tarifa total. Não desconte o custo do provedor outra vez.
Liberação financeira
Faça uma transação real de baixo valor somente depois que o provedor estiver habilitado. Confira cobrança, taxa, saldo, evento assinado, reconciliação e atendimento antes de aumentar o volume. A configuração de repasse só deve ser considerada homologada após um saque real de baixo valor, com KYC aprovado, titular validado, taxa conferida e confirmação do banco. Credencial configurada não comprova essa etapa. Devoluções também dependem de suporte do provedor. A integração atual do provedor de pagamentos não oferece devolução Pix pela API MingoPay e responde503 refund_unavailable antes de reservar saldo. A simulação de sandbox não comprova uma devolução bancária real.