Resultados de la Tarjeta
El paso de tarjeta se suma al resultado de identidad en lugar de producir uno propio. La misma sesión termina una vez, y un único resultado lleva ambos: las filas de la tarjeta en checks y, en una sesión con tokenización, el bloque paymentCard.
El Bloque 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"
}
El resto del payload — document, person, las filas de identidad, decision — se describe en Resultados de la Sesión.
| Campo | Descripción |
|---|---|
token | El token de tarjeta del gateway. Úselo con las APIs del gateway, del mismo modo que un token del propio tokenizador del gateway |
lastFour | Los últimos cuatro dígitos de la tarjeta tokenizada, para mostrar |
kind | one_time o recurring, según storeLaterUse en la sesión. Se aplican las reglas de uso único y recurrente del gateway |
recordedAt | Cuándo Inyo360 registró el token, como marca de tiempo ISO 8601 en UTC |
Cuándo Está Presente
El bloque está presente solo en una sesión creada con paymentCard.tokenize cuyo titular llegó al paso del token y entregó un token. En los demás casos la clave está ausente, no null.
| Sesión | paymentCard |
|---|---|
Solo verificación (capture sin tokenize) | Ausente |
| Tokenización, token registrado | Presente |
| Tokenización, el titular nunca llegó al paso del token — agotó los intentos de tarjeta, o la sesión venció | Ausente |
| Tokenización, y la tokenización se desactivó para su tenant después de enviado el enlace | Ausente — el paso se ejecutó como solo verificación |
Una verificación de la tarjeta que no se aprueba no elimina el bloque. La sesión igualmente se completa, y el status de la fila dice qué falló — vea Verificaciones de la Tarjeta.
Cómo Le Llega
El bloque viaja en el resultado de identidad: el webhook firmado, la notificación de resultado de la redirección y la lectura en GET /v1/sessions/{sessionId}. La verificación de firmas y el ordenamiento están en Recepción de Resultados.
Qué Almacena Inyo360 Junto al Token
Inyo360 conserva un registro del token por sesión: el token, su tipo, los últimos cuatro dígitos tal como los informó el widget, el mes de vencimiento de la tarjeta y el nombre del titular que este confirmó en la pantalla de confirmación del widget. El resultado expone solo los cuatro campos de arriba. El mes de vencimiento y el nombre del titular no se entregan.
lastFour es el valor que el widget informó a partir del tokenizador del gateway. Inyo360 lo compara con los dígitos que quedan visibles en las fotos almacenadas de la tarjeta, y el desenlace es la fila payment_card_token_match. Decida a partir de esa fila, no solo de lastFour.
Vea Tratamiento de Datos para todo lo que almacena Inyo360.
Próximos Pasos
- Verificaciones de la Tarjeta — las filas de la tarjeta en
checks - Tokenización de Tarjetas — el token del gateway y cómo se usa
