Resultados do Cartão

A etapa do cartão acrescenta ao resultado de identidade em vez de produzir um resultado próprio. A mesma sessão termina uma vez, e um único resultado traz as duas coisas: as linhas do cartão em checks e, em uma sessão de tokenização, o bloco paymentCard.

O Bloco `paymentCard`

{
  "sessionId": "9f1c8e42-7c3e-4f2b-9d7a-2b1e5c8f4a10",
  "userRef": "user-123",
  "status": "completed",
  "checks": [
    { "name": "payment_card_scene_clear", "status": "passed", "group": "payment_card", "severity": "high", "reason": null, "detail": "no screen-recapture signals" },
    { "name": "payment_card_token_match", "status": "passed", "group": "payment_card", "severity": "high", "reason": null, "detail": "the tokenized card matches the photographed card and the holder" }
  ],
  "paymentCard": {
    "token": "3b9f6c1e-8d2a-4f7b-9e5c-1a2b3c4d5e6f",
    "lastFour": "4242",
    "kind": "recurring",
    "recordedAt": "2026-07-31T14:04:41.112Z"
  },
  "provider": "inyo",
  "trustIndex": 100,
  "completedAt": "2026-07-31T14:04:57.874Z"
}

O restante do payload — document, person, as linhas de identidade, decision — está descrito em Resultados da Sessão.

Campo	Descrição
`token`	O token de cartão do gateway. Use-o com as APIs do gateway, da mesma forma que um token do próprio tokenizador do gateway
`lastFour`	Os últimos quatro dígitos do cartão tokenizado, para exibição
`kind`	`one_time` ou `recurring`, a partir de `storeLaterUse` na sessão. Valem as regras de uso único e recorrente do gateway
`recordedAt`	Quando o Inyo360 registrou o token, um timestamp ISO 8601 em UTC

Quando Ele Está Presente

O bloco está presente apenas em uma sessão criada com paymentCard.tokenize cujo titular chegou à etapa do token e entregou um token. Caso contrário a chave fica ausente, não null.

Sessão	`paymentCard`
Somente verificação (`capture` sem `tokenize`)	Ausente
Tokenização, token registrado	Presente
Tokenização, o titular nunca chegou à etapa do token — esgotou as tentativas do cartão, ou a sessão expirou	Ausente
Tokenização, e a tokenização foi desativada para o seu tenant depois que o link foi enviado	Ausente — a etapa rodou como somente verificação

Uma checagem do cartão que não passa não remove o bloco. A sessão ainda é concluída, e o status da linha diz o que falhou — veja Checagens.

Como Ele Chega até Você

O bloco vem junto com o resultado de identidade: o webhook assinado, a notificação de resultado do redirect e a leitura em GET /v1/sessions/{sessionId}. A verificação de assinatura e a ordenação estão em Recebendo Resultados.

O Que o Inyo360 Guarda Junto com o Token

O Inyo360 mantém um registro de token por sessão: o token, o seu tipo, os últimos quatro dígitos como o widget os informou, o mês de validade do cartão e o nome do titular que ele confirmou na tela de confirmação do widget. O resultado expõe apenas os quatro campos acima. O mês de validade e o nome do titular não são entregues.

lastFour é o valor que o widget informou a partir do tokenizador do gateway. O Inyo360 o checa contra os dígitos que restaram nas fotos guardadas do cartão, e o desfecho é a linha payment_card_token_match. Baseie-se nessa linha, não apenas em lastFour.

Veja Tratamento de Dados para tudo o que o Inyo360 guarda.

Próximos Passos

Checagens — as linhas do cartão em checks
Tokenizando Cartões — o token do gateway e como ele é usado