Cartões de teste do Stripe: teste pagamentos de checkout dos EUA e 3D Secure

A página de pagamento está aberta e o produto e o preço são exibidos corretamente. O que você precisa confirmar em seguida não é apenas se o botão de pagar pode ser clicado.

Quando um cartão é recusado, o que a página mostra? O comprador consegue trocar para outro cartão e continuar? Se a verificação de identidade for cancelada no meio do processo, o pedido será marcado erroneamente como pago?

Use três cartões de teste do Stripe para verificar separadamente sucesso, falha e verificação de identidade. Após cada envio, confira tanto o checkout quanto os registros do backend.

Este artigo usa como exemplo um checkout que exige um endereço de cobrança nos EUA. Ele é operado pelo navegador e não requer escrever código.

1. Abra a página de pagamento no ambiente de teste

Vá ao Dashboard do Stripe e use o seletor de conta para mudar para Sandbox, o ambiente de teste. Todas as operações de pagamento desta rodada são concluídas nesse ambiente e não movimentam fundos reais. Documentação do ambiente de teste do Stripe

Se você já tem um link de pagamento de teste, abra-o diretamente.

Se ainda não criou um, crie um novo link em Payment Links no ambiente de teste, selecione um produto e um preço de teste e abra a página de pagamento gerada. Os Payment Links podem ser criados pelo Dashboard sem construir um site. Criar um link de pagamento

Primeiro verifique três coisas:

Se o produto está correto.
Se o valor e a moeda estão corretos.
Se a página pertence ao ambiente de teste que você acabou de selecionar.

Não se apresse em digitar o número do cartão nesta etapa. Se o preço errado for selecionado ou o link errado for aberto, mesmo que os testes posteriores sejam concluídos, eles não terão verificado o fluxo que você planeja lançar.

2. Preencha um endereço de cobrança nos EUA

Para o país de cobrança, selecione United States.

Abra o gerador de endereços, selecione os Estados Unidos, defina a quantidade a gerar como 1 e clique em gerar. Copie a rua, cidade, estado e CEP para o formulário de pagamento.

Preencha cada campo da seguinte forma:

Campo do checkout	O que inserir	Exemplo
Endereço linha 1	Endereço da rua	5322 N Union Street
Endereço linha 2	Número do apartamento ou suíte; deixe em branco se não houver	Deixe em branco
Cidade	Cidade	North Walpole
Estado	O estado correspondente	New Hampshire
CEP	Código postal	03609
País	País	United States

Se o campo de estado for um menu suspenso, selecione New Hampshire; se exigir a abreviação de duas letras, insira NH.

O primeiro zero do CEP 03609 deve ser mantido. Não o trate como número e escreva 3609.

Use um endereço de e-mail de teste ao qual você tenha acesso para poder verificar notificações depois. Após preencher o endereço, mantenha este exemplo e use o mesmo endereço nas três rodadas de teste.

Assim, quando o resultado do pagamento mudar, a primeira coisa que você compara é o número do cartão e a ação de verificação. Você não precisa investigar ao mesmo tempo se a cidade, o estado ou o CEP foram alterados incorretamente.

3. Use um cartão de sucesso para verificar o fluxo completo de pagamento

Primeiro use este conjunto de informações:

Número do cartão: 4242 4242 4242 4242
Validade: 12/34
CVC: 123

A data de validade precisa estar no futuro. O mês/ano e o CVC aqui são usados para este teste; o número do cartão corresponde ao cenário de pagamento bem-sucedido do Stripe. Documentação de cartões de teste

Clique em pagar e observe se a página entra no estado de conclusão esperado.

Depois, volte ao mesmo ambiente de teste, abra os registros de pagamento e encontre a transação que você acabou de fazer. Verifique o valor, a moeda e o status do pagamento. Pagamentos de Payment Links podem ser vistos na visão geral de pagamentos do Dashboard. Ver registros de pagamento

Nesta rodada, verifique duas coisas separadamente:

Se o status do pagamento está correto e se as ações seguintes da página estão corretas.

Por exemplo, se o backend mostra um pagamento bem-sucedido, mas a página de conclusão não abre, o foco da solução deve estar na configuração da página pós-pagamento e no caminho de redirecionamento. Não digite novamente todo o número do cartão e o endereço só porque o navegador reportou um erro.

Por outro lado, o navegador mostrar "Obrigado pela sua compra" não substitui o status de pagamento no backend. A página de confirmação e o registro de pagamento precisam corresponder um ao outro.

Se o link de pagamento estiver conectado a fluxos de pedido, e-mail ou download, verifique também estas etapas:

Se o pedido aparece como pago.
Se o valor corresponde ao checkout.
Se as notificações configuradas foram enviadas.
Se o download ou a entrada de acesso configurada está disponível.

Recursos que não estão conectados não precisam ser verificados, e o sucesso do pagamento no Stripe não deve ser tratado como prova de que esses recursos estão completos.

4. Use um cartão de falha para verificar mensagens de erro e nova tentativa com cartão

Reabra o link de pagamento e inicie um novo teste.

Mantenha o endereço, o e-mail e outras condições inalterados, e altere apenas o número do cartão para:

4000 0000 0000 0002

Este cartão simula uma recusa geral de pagamento. Cartões de teste recusados

Após clicar em pagar, verifique:

Se a página mostra uma mensagem de falha clara.
Se o campo de número do cartão ainda pode ser editado.
Se a página entra incorretamente no estado de pagamento concluído.
Se o pedido associado é marcado incorretamente como pago.

A mensagem de falha não deve dizer apenas "Ocorreu um erro." O comprador deve pelo menos saber que o pagamento não foi concluído e que ainda pode continuar.

Em seguida, no checkout atual, altere o número do cartão de volta para:

4242 4242 4242 4242

Envie novamente.

Esta etapa verifica o caminho de recuperação após falha. Conseguir pagar com sucesso na primeira vez não significa que, após uma falha, o botão, o formulário e o status do pedido ainda estejam corretos.

Se continuar girando após a primeira falha, registre onde trava. Verifique primeiro a operação de nova tentativa; não altere o endereço, mude o produto e atualize todas as páginas ao mesmo tempo. Alterar várias condições de uma vez fará você perder a comparação mais valiosa.

5. Verifique os dois caminhos de verificação de identidade: concluída e cancelada

Para a terceira rodada, use um cartão de teste 3D Secure emitido nos EUA:

4000 0084 0000 0027

As regras padrão do Radar do Stripe solicitarão verificação 3D Secure para este cartão. Documentação de teste 3D Secure

O teste deve ser realizado na página de pagamento aberta pelo comprador. Criar um pagamento diretamente no Dashboard do Stripe não substitui o fluxo de verificação no navegador.

Primeiro conclua uma verificação e confira:

Se a interface de verificação consegue abrir.
Se você consegue voltar ao fluxo de pagamento após concluir a verificação.
Se o checkout e o backend mostram resultados consistentes.

Depois inicie um novo teste e cancele na interface de verificação.

Após cancelar, verifique se a página ainda mantém um ponto de entrada para continuar o pagamento e se o pedido ainda está em estado não pago. Concluir a verificação de identidade e concluir o pagamento são dois checkpoints; você não pode olhar apenas se a janela de verificação fechou.

Se a interface de verificação não aparecer, primeiro confirme que você usou o cartão de teste correspondente, abriu a página de pagamento do comprador e verifique se as regras do Radar foram modificadas. Não trate a mudança para um endereço nos EUA como forma de acionar a verificação.

6. Se travar em uma etapa, primeiro determine em qual camada está

Um erro de checkout não é necessariamente um problema de número de cartão. Divida a solução de problemas pelo local onde ocorre:

Sintoma	O que verificar primeiro	Próxima comparação
Erro no campo de endereço, não é possível enviar	País, estado, CEP e campos obrigatórios	Mantenha o número do cartão inalterado e corrija apenas o campo com erro
Cartão de falha é recusado	Se o número do cartão do cenário de falha foi usado	Troque para um cartão de sucesso e verifique se o pagamento se recupera
Cartão de sucesso também falha	Ambiente de teste, configuração da página, detalhes do erro no backend	Repita as mesmas condições com uma nova página de pagamento
Backend tem sucesso, página de conclusão dá erro	Redirecionamento pós-pagamento ou configuração da página	Verifique o registro de pagamento e a página de destino separadamente
Ainda mostra pago após cancelar a verificação	Tratamento de status no checkout e no pedido associado	Compare os dois testes: verificação concluída e verificação cancelada
Primeiro pagamento funciona, nova tentativa após falha não	Estado de recuperação do formulário e do botão	Repita a ordem "cartão de falha -> cartão de sucesso"

A tabela serve para determinar a próxima verificação; ela não significa que a causa pode ser determinada a partir de um único sintoma.

Registre a mensagem de erro original, o horário do teste e o registro de pagamento. Se a captura de tela disser apenas "Algo deu errado", será difícil depois determinar se o problema foi validação de endereço, recusa de cartão ou a página pós-pagamento.

7. Mantenha um registro de teste que possa ser revisado

Não é preciso escrever um relatório longo. Uma tabela é suficiente:

Cenário de teste	Resultado na página	Resultado no backend	Pedido associado ou resultado de entrega
Pagamento bem-sucedido	Registre o que é exibido de fato	Registre o status do pagamento	Verifique fluxos seguintes conectados
Falha no pagamento	Registre a mensagem de erro	Verifique detalhes da falha	Confirme que não foi marcado como pago
Troca de cartão após falha	Verifique se é possível enviar novamente	Verifique o novo pagamento	Verifique se o status se recupera corretamente
Concluir verificação de identidade	Verifique a página de retorno	Verifique o status final	Verifique fluxos seguintes conectados
Cancelar verificação de identidade	Verifique o ponto de entrada para continuar o pagamento	Verifique o status real	Confirme que não foi julgado erroneamente como pago

Cada vez que você modificar o checkout, o redirecionamento pós-pagamento ou o tratamento de pedidos, revise usando esta tabela.

O que realmente precisa funcionar de ponta a ponta é a cadeia completa: preencher informações, enviar pagamento, tratar falha ou verificação, confirmar o resultado do pagamento e então concluir a operação de pedido correspondente. Ver apenas um "pagamento bem-sucedido" não é suficiente para mostrar que o checkout está pronto.