Resultado, Redirecionamento e Comprovante

Depois que o comprador tenta pagar, o SmartForm pode redirecioná-lo a uma página do seu site. Esse redirecionamento faz parte da experiência do navegador: o estado financeiro da Venda deve ser conferido no servidor.

Página de sucesso

Na biblioteca PayZen, o atributo kr-post-url-success define o endereço usado após a etapa de pagamento, conforme o comportamento do SDK.

<script
  src="https://static.payzen.eu/static/js/krypton-client/V4.0/stable/kr-payment-form.min.js"
  kr-public-key="CHAVE_PUBLICA_RECEBIDA"
  kr-post-url-success="/pagamento/resultado"></script>

A página de destino pode mostrar "Estamos confirmando seu pagamento" enquanto o backend consulta o recurso da Venda ou processa o webhook.

Exibir ou ocultar o comprovante da PayZen

A documentação oficial Krypton V4.0 apresenta a configuração displayPaymentReceipt. Se desejar configurar a janela do comprovante, faça isso após carregar a biblioteca PayZen e os estilos associados, conforme a referência oficial:

<script>
  KR.setFormConfig({
    smartForm: {
      paymentMethods: {
        "ALL": { displayPaymentReceipt: true }
      }
    }
  });
</script>

Para ocultar a janela, utilize displayPaymentReceipt: false. O comportamento depende do tipo de pagamento e da versão do cliente. Essa configuração controla a apresentação do comprovante, não a confirmação financeira.

Fonte: PayZen — Hide the payment receipt window.

Como confirmar a Venda

Guarde o uuid da Venda recebido na criação.
Consulte a Venda em GET /v1/charges/{uuid} usando o servidor ou configure um webhook da Cyclopay.
Diferencie o status da Venda dos estados individuais em transactions[].
Atualize o pedido do comprador somente após uma confirmação válida para sua regra de negócio.

🚧
Não marque a Venda como paga no navegador
A chegada à URL de sucesso, a exibição de comprovante e o desaparecimento de uma mensagem de erro não são prova suficiente de pagamento aprovado.

Segurança, Chaves e Webhooks · Tratamento de Erros.