pk_test_ por pk_live_, percorra esta checklist.
Verificação funcional
1
SDK carrega sem erros
Sem erros no console; o botão renderiza dentro do container.
2
Multicaixa Express → onApprove
Pagamento confirmado dispara
onApprove e redireciona para /sucesso.3
Referência EMIS → onPending
onPending recebe os dados da referência (data.payment?.data?.paymentReference e entity.number); a página /pendente mostra-os ao cliente.4
Cancelar → onCancel
Fechar o popup sem pagar dispara
onCancel → /cancelado.Verificação do webhook
Produção
Robustez
- Total recalculado no servidor em todas as ordens.
- Idempotência: localize a ordem por
externalTransactionId, deduplique porpaymentId+paymentStatus. - Tarefas pesadas (emails, ERP, faturação) fora do caminho do webhook (fila/background),
para responder
200em < 5s. - Avise o utilizador para permitir popups do seu site.
- Polling de fallback na página
/pendente(a cada 5–10s) caso o webhook atrase.