Pagamentos
Checklist de Go-Live
Verificações obrigatórias antes de ativar a integração em produção.
Checklist de Go-Live
Revise cada item antes de ativar em produção.
Configuração
- Credenciais de produção configuradas (diferentes do staging)
-
CAKTO_BASE_URLapontando para endpoint de produção - Scripts 3DS com URL de produção (
mpi.braspag.com.br, nãompisandbox) -
bpmpi_config.Environmentretornando'PRD'em produção - Variável de ambiente única (
CAKTO_SANDBOX=false) controlando todos os endpoints - Nenhuma credencial hardcoded no código-fonte
Segurança
- Credenciais de API somente no servidor (BFF ou backend próprio)
- Header
Authorizationnunca enviado do browser diretamente à Cakto -
postbackUrlem HTTPS com certificado válido - Webhook verifica autenticidade das notificações recebidas
Fluxo de pagamento
- Script Nethone carregado no HTML (não sob demanda)
-
dftp.init()chamado no mount do checkout -
dftp.profileCompleted()chamado antes do submit - Mesmo UUID em
antifraud_profiling_attempt_reference -
docTypeem minúsculas:"cpf"ou"cnpj" -
zipcodeapenas dígitos (8 caracteres) -
countrycomo"BR"(2 letras, ISO 3166-1 Alpha-2) -
amounteunitPricecomo string decimal (ex:"149.90")
3DS (se aplicável)
- Token gerado imediatamente antes de
bpmpi_authenticate() -
threeDSecurecom chaves PascalCase (Cavv,Eci,Version) - Checkout não submetido se
onSuccessnão disparou - Tratamento de todos os callbacks de erro 3DS
- Iframe do challenge visível para o usuário (MutationObserver)
- Timeout global de 90s configurado
UX / Experiência do usuário
- Mensagens de erro genéricas para pagamentos recusados (não revelar motivo de fraude)
- Estado de loading durante o processamento
- Redirecionamento correto para
status: "paid" - Tratamento de
status: "pending"(aguardar webhook) - Scripts 3DS pré-carregados no hover do botão "Pagar" (reduz latência)
Testes finais em staging (api.scpay.com.br)
- Aprovação com cartão Visa
4111111111111111 - Recusa com cartão
4000000000000002 - Fluxo 3DS completo (onSuccess disparou)
- Webhook recebendo notificações em
postbackUrl - Reembolso testado (se aplicável)
Monitoramento
- Logs de erro configurados para falhas de pagamento
- Alerta para taxa de aprovação abaixo do esperado
- Dashboard ou relatório com métricas de conversão
Antes do go-live, comunique à equipe Cakto que você está ativando em produção. Eles podem verificar a configuração da sua conta e confirmar que a afiliação está ativa.