SmartForm
Entenda o SmartForm como opção intermediária entre controle de experiência e redução do esforço para lidar com dados de pagamento.
O SmartForm é um formulário de pagamento incorporado ao site do estabelecimento. O e-commerce mantém a experiência de checkout e integra a etapa de pagamento sem desenvolver os próprios campos de cartão.
Escolha o modelo de integração
| Modelo | O que a equipe desenvolve | Experiência do comprador |
|---|---|---|
| API direta | Interface de pagamento e fluxo no site ou aplicativo. | A etapa de pagamento é criada pelo e-commerce. |
| SmartForm | Integração do formulário incorporado e do checkout ao redor dele. | O formulário aparece dentro da jornada do site. |
| Checkout ou Link de Pagamento | A integração com a página de pagamento disponibilizada pelo Gateway. | O comprador segue para uma página de pagamento dedicada. |
O SmartForm costuma fazer sentido quando o e-commerce já controla carrinho, frete e identificação do comprador, mas prefere integrar um formulário de pagamento especializado em vez de construir os campos de cartão.
Como a integração se encaixa no checkout
A aplicação cria a Venda pela API antes de exibir o formulário. A renderização apresenta essa Venda ao comprador; não cria uma segunda Venda. Depois da tentativa, a aplicação acompanha o resultado da Venda e da Transação pelo fluxo de confirmação do Gateway.
- O comprador revisa o carrinho.
- O e-commerce apresenta o checkout.
- O servidor cria a Venda pela API.
- O site exibe o SmartForm.
- O comprador tenta pagar.
- O e-commerce confirma o resultado no Gateway.
Uma mensagem de sucesso ou o retorno do comprador ao site informa o resultado visual daquela etapa. Não confirma, por si só, o resultado financeiro. O e-commerce deve atualizar o pedido após consultar o estado da Venda/Transação ou receber a notificação configurada.
Decisões antes da implementação
Antes de escolher o SmartForm, defina quanta personalização o checkout exige, quais métodos de pagamento estão disponíveis para a modalidade contratada, quais navegadores e dispositivos precisam ser atendidos e como o pedido será atualizado após a tentativa de pagamento.
O SmartForm usa o SDK original da PayZen para renderizar os campos de pagamento. A integração permite personalizar a camada HTML/CSS, escolher modos de apresentação e adaptar o checkout a layouts responsivos. A disponibilidade dos meios de pagamento depende do contrato e das condições de dispositivo e navegador.
Próximas etapas
- Iniciar uma Venda com SmartForm
- Exibir o formulário
- Personalização visual
- Modos de exibição
- Responsividade e acessibilidade
- Meios de pagamento e wallets
- Tokenização
- 3D Secure, parcelamento e captura manual
- Resultado, redirecionamento e comprovante
- Segurança, chaves, token e webhooks
- Erros e solução de problemas
Updated 12 days ago

