As respostas dos dispositivos móveis aos comandos do smart tap são mensagens de status específicas do aplicativo. As mensagens de status geralmente têm quatro dígitos, sendo 9 o primeiro. O primeiro byte indica a ação do terminal desejada e o segundo contém mais detalhes.
Um dispositivo móvel pode retornar um valor para o segundo byte que não esteja presente nessa lista. Não é necessário que o terminal interprete o valor do segundo byte. Para o primeiro byte, os dispositivos móveis podem retornar apenas mensagens de status listadas neste guia.
Nesta documentação, x como parte de uma mensagem de status indica que o valor retornado é variável. Por exemplo, 90xx mensagens incluem 9001 e 9002.
90xx - Pronto, próximos passos até o terminal
A mensagem de status 90 xx indica que a solicitação foi bem-sucedida, mas pode haver mais informações anexadas. O terminal pode continuar a pagar ou continuar com mais comandos de toque inteligente, dependendo da configuração do terminal.
Comportamento esperado do terminal
Dependendo do comando e da palavra de status, o terminal envia mais comandos de toque inteligente, passa para o pagamento ou interrompe a sessão.
| SW1+2 | Significado | Escolher | Negociar | Get | Pressionar |
|---|---|---|---|---|---|
| 9000 | Sucesso | Ready | Autorização concluída | Pronto, não há mais dados | Sucesso |
| 9001 | Sucesso, sem cartões | N/A | N/A | A resposta contém apenas um registro do cliente ou nada | N/A |
| 9002 | Sucesso, autenticação pré-assinada | N/A | Autorização concluída, mas a autenticação não foi ativada | N/A | N/A |
91xx - Pronto, mas não está pronto para pagamento
A mensagem de status 91 xx indica que não houve erros, mas o terminal não pode fazer o pagamento imediatamente. Sabemos que o pagamento não foi concluído ou que o terminal precisa realizar mais ações.
Comportamento esperado do terminal
Não continue para fazer pagamentos. Solicite mais comandos de toque inteligente ou pare, dependendo da palavra de status.
| SW1+2 | Significado |
|---|---|
| 9100 | Mais dados disponíveis (somente resposta). |
| 9101 | O pagamento não está pronto. |
| 9102 | Sucesso, nenhum cartão de pagamento e pagamento ainda não estão prontos. |
92xx - Possível falha temporária
A mensagem de status 92xx indica que o comando falhou, mas uma nova tentativa imediata pode ser bem-sucedida. Na prática, elas são raras, mas serão possíveis se houver uma exceção ou outro erro no app que não sabíamos como recuperar.
Esses códigos não significam que uma nova tentativa será bem-sucedida. O terminal deve tentar novamente apenas algumas vezes antes de desistir. Em geral, o terminal faz uma nova tentativa antes de fazer o pagamento.
Esses códigos podem ocorrer em resposta a qualquer comando do smart tap.
Comportamento esperado do terminal
Pelo menos uma nova tentativa é necessária. Se as tentativas falharem, interrompa o smart tap. O terminal pode continuar a solicitar pagamento.
| SW1+2 | Significado |
|---|---|
| 9200 | Falha temporária temporária. |
| 9201 | Exceção de criptografia. |
| 9202 | Tempo limite atingido. |
| 9203 | Erro de execução. |
93xx - Ação do cliente necessária
A mensagem de status 93xx indica que o comando falhou, e a ação do cliente precisa ser concluída. O terminal não pode prosseguir para solicitar o pagamento com o mesmo toque, porque um toque inteligente subsequente pode ser bem-sucedido após a ação do usuário.
Comportamento esperado do terminal
Pare a sessão. Não continue com o smart tap ou o pagamento.
| SW1+2 | Significado |
|---|---|
| 9300 | Dispositivo móvel bloqueado. |
| 9301 | Nenhum cartão de pagamento é diferente de 0x9101, e o terminal deve tratar isso como uma falha e reiniciar o toque. |
| 9302 | O cliente está precisando selecionar um cartão. Reinicie o processo no próximo toque. |
94xx - Dados de terminal desconhecidos
A mensagem de status 94xx significa UNKNOWN TERMINAL DATA. Acreditamos que o terminal nos enviou algo errado. O terminal não deve repetir a solicitação, a menos que você acredite que pode ser um problema temporário. O terminal pode prosseguir para a etapa de pagamento.
Comportamento esperado do terminal
A nova tentativa é opcional e a critério do terminal. O dispositivo móvel não espera uma nova tentativa. O terminal pode encerrar a sessão do smart tap. O terminal pode continuar solicitando o pagamento.
| SW1+2 | Significado |
|---|---|
| 9400 | Comando desconhecido. |
| 9401 | Registro NDEF desconhecido. |
| 9402 | Falha na análise. |
| 9403 | Parâmetros de criptografia inválidos. |
| 9404 | Solicitar mais dados não aplicáveis. |
| 9405 | Não há mais dados disponíveis. |
| 9406 | Excesso de solicitação. |
| 9407 | Nenhum ID do comerciante (ID do coletor) definido. |
| 9408 | URI de pushback inválido. |
95xx - Erro permanente
A mensagem de status 95xx significa PERMANENT ERROR. O smart tap não vai
ser bem-sucedido. O terminal pode prosseguir para a etapa de pagamento.
Comportamento esperado do terminal
O terminal pode encerrar a sessão do smart tap. O terminal pode continuar solicitando o pagamento. É aceitável, mas não obrigatório, continuar acessando get data depois de um código de status 9500 para receber um código exclusivo de smart tap (STUID).
| SW1+2 | Significado |
|---|---|
| 9500 | Não é possível autenticar (somente negotiate). |
| 9501 | Não autenticado (somente push data). |
| 9502 | Versões incompatíveis. |
Outro
Comportamento esperado do terminal
Parar sessão do smart tap. O terminal pode continuar solicitando o pagamento.
| SW1+2 | Significado |
|---|---|
| 6,82 | Arquivo não encontrado, retornado se select OSE ou smart tap falhar. |