> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mingopay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Checklist de produção

> Revise conta, credenciais, webhooks e operação antes da primeira venda real.

## 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 é R$ 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.