Pular para o conteúdo principal

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-Key persistida 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. Respeite Retry-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 é R0,40porentradaPixeR 0,40 por entrada Pix e 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 responde 503 refund_unavailable antes de reservar saldo. A simulação de sandbox não comprova uma devolução bancária real.