Sandbox e Dados de Teste
A etapa do cartão em sandbox é o pipeline de produção: captura real, mascaramento real, checagens reais. Não há valor reservado que dite o desfecho de um cartão, então você a testa fotografando um cartão.
O acesso ao sandbox, as credenciais e a entrega de resultados são os da integração de identidade — veja o Sandbox e Dados de Teste de identidade.
O Que Escanear
Um cartão físico, segurado diante da câmera do celular. Um cartão exibido na tela de outro dispositivo é exatamente o que payment_card_scene_clear e payment_card_authentic existem para detectar, então não serve como teste da etapa do cartão.
Você tem duas opções:
| Cartão | Use-o para |
|---|---|
| O cartão-modelo impresso abaixo | Rodar o fluxo inteiro, tokenização incluída, sem um cartão real |
| Um cartão seu | Conferir como as checagens leem um cartão genuíno |
Um número de documento de identidade reservado do sandbox de identidade encerra a sessão na criação, então uma sessão que usa um deles nunca chega à etapa do cartão. Use uma captura real do seu documento de identidade quando testar o cartão.
O Cartão-Modelo
A frente e o verso de um cartão inventado, exibidos pequenos de propósito: imprima-os e fotografe o papel. Uma foto de uma tela é o que payment_card_scene_clear recusa.
Baixe para imprimir: frente · verso
O que esperar dele:
| Linha | Espere |
|---|---|
payment_card_authentic | Um cartão-modelo impresso pode ser lido como não genuíno. Use um cartão seu para ver esta linha passar |
payment_card_name_match | Falha: o cartão-modelo traz um nome inventado, que não é o nome do seu documento de identidade |
payment_card_token_match | Pode passar: tokenize o número como foi lido — veja abaixo |
Correspondência do Token em Sandbox
No modo de tokenização, payment_card_token_match passa apenas quando o cartão tokenizado concorda com o fotografado:
- Os últimos quatro dígitos do número que você tokeniza devem ser os últimos quatro que ficaram visíveis no cartão fotografado. Confirme o número como foi lido na tela de confirmação; trocá-lo pelo número de outro cartão reprova a linha com
last_four_mismatch. - O nome confirmado deve corresponder ao nome do seu documento de identidade ou ao nome lido do cartão. O nome impresso no cartão-modelo atende a esta metade, porque corresponde ao cartão.
A regra completa está em Checagens.
Os Cartões de Teste do Gateway
Os números de cartão de teste do gateway determinam o que o gateway faz com um token depois: aprovação, recusa, desafio de 3D Secure. Eles não decidem nada na etapa do cartão, que lê apenas o que fotografou.
O cartão-modelo imprime um dos números de cartão de teste do gateway, um sem 3D Secure. Um token do cartão-modelo, portanto, se comporta no sandbox do gateway como esse cartão de teste.
Quando uma Checagem do Cartão Falha
A sessão ainda é concluída, a menos que o titular tenha esgotado as tentativas do cartão:
| O que falha | Sessão | Bloco paymentCard |
|---|---|---|
payment_card_scene_clear ou payment_card_readable | O titular fotografa o cartão novamente. Sem tentativas do cartão restantes, a sessão termina failed | Ausente — nenhum token foi pedido |
payment_card_authentic ou payment_card_name_match | completed, com a linha pesando contra o trustIndex | Presente em uma sessão de tokenização |
payment_card_token_match | completed, com a linha pesando contra o trustIndex | Presente |
Veja O que uma linha com falha faz.
Próximos Passos
- Checagens — o que cada linha do cartão decide
- Fluxo do Widget — a tela de confirmação e o Escanear de novo
- Tokenizando Cartões — usando o token depois