Preparar produção

Habilitação da conta

Verifique o e-mail da conta. Não é necessário CNPJ nem KYC para criar cobranças ou depósitos; o provedor da implantação precisa estar configurado e habilitado para cobrança real. Sem isso, não é possível emitir uma chave de produção utilizável e a criação de cobrança pode responder provider_unavailable.

A SimPay é o provedor real escolhido. O adaptador permanece bloqueado até a entrega das credenciais, chave HMAC, conta de homologação e validação contratual. Confirme a habilitação operacional antes de prometer recebimentos aos clientes.

Chaves e webhooks

Crie uma chave mp_live_ com somente os escopos necessários. Use expiração e, quando fizer sentido, uma lista de IPs. Guarde o token e o segredo whsec_ no servidor, separados do sandbox.

Cadastre uma URL HTTPS pública de produção. Valide a assinatura sobre o corpo bruto, imponha janela de timestamp e deduplique os eventos pelo id.

Rotina de operação

Teste criação, pagamento, falha, devolução e timeout no sandbox. Defina reconciliação periódica pelo id da cobrança e uma rotina para consultar entregas de webhook com falha.

Registre requestId de erros sem registrar tokens completos. Prepare atendimento para pagamentos pendentes, devoluções e indisponibilidade do provedor.

Antes da primeira venda

Verifique a conta e as taxas comerciais acordadas, confira as credenciais do provedor, confirme que o webhook de produção recebe o evento assinado e faça uma transação real de baixo valor somente quando o ambiente estiver habilitado. Sandbox não substitui essa validação.