Antes de trocar pk_test_ por pk_live_, percorre 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 ref e entity; a página /pendente mostra-os ao cliente.
4

Cancelar → onCancel

Fechar o popup sem pagar dispara onCancel/cancelado.

Verificação do webhook

#CenárioEsperado
1Assinatura válidaEstado da ordem muda na BD.
2Assinatura inválida401; a BD não muda.
3Webhook duplicado (mesmo externalTransactionId)200, sem reprocessar.
4Fallback paymentByExternalTransactionDevolve o mesmo estado da BD após o webhook.

Produção

  • Troca a base URL para https://api.faciconnect.com e a chave para pk_live_….
  • Confirma que HTTPS está ativo no teu domínio (a SDK e os webhooks exigem-no).
  • O webhookUrl em additionalInfo aponta para um domínio público e acessível.

Robustez

  • Total recalculado no servidor em todas as ordens.
  • Idempotência garantida por externalTransactionId.
  • Tarefas pesadas (emails, ERP, faturação) fora do caminho do webhook (fila/background), para responder 200 em < 5s.
  • Avisa o utilizador para permitir popups do teu site.
  • Polling de fallback na página /pendente (a cada 5–10s) caso o webhook atrase.

Suporte

Dúvidas ou credenciais de produção: atendimento@faci-x.ao.