Primeros Pasos

La Verificación de Tarjeta de Pago es un paso del widget de identidad alojado. Después de que el cliente fotografió su documento y se tomó una selfie, el widget le pide su tarjeta de pago, frente y reverso, en la misma sesión. El resultado que usted ya recibe para la verificación de identidad lleva también las filas de la tarjeta.

Esta página supone una integración de identidad en funcionamiento. Si todavía no tiene una, comience por los Primeros Pasos de identidad.

Requisitos Previos

El paso de tarjeta habilitado para su tenant. Consulte a su contacto en Inyo. Hasta que lo esté, una sesión que pide la tarjeta se rechaza con 422.
Para el modo de tokenización, su clave pública del gateway en su tenant, con la tokenización activada. Inyo configura ambas; consulte a su contacto en Inyo.
Su integración de identidad: Autenticación, un webhookUrl o la entrega por redirección, y la verificación de firmas de Recepción de Resultados.

Dos Modos

Usted elige el modo por sesión.

Modo	Solicitud	Qué hace el titular	Qué recibe usted
Solo verificación	`"paymentCard": {"capture": true}`	Fotografía la tarjeta, frente y reverso	Filas de la tarjeta en `checks`: la tarjeta está a la vista, es legible y genuina, y su nombre coincide con el documento de identidad
Verificación y tokenización	`"paymentCard": {"capture": true, "tokenize": {}}`	Fotografía la tarjeta, luego revisa y confirma los datos leídos de ella	Las mismas filas, una más que contrasta el token con la tarjeta fotografiada, y un bloque `paymentCard` con el token del gateway

En el modo de tokenización el titular nunca escribe la tarjeta en un formulario suyo. Los datos se leen de las fotos en su dispositivo y se confirman en la propia pantalla del widget.

Paso 1: Cree una Sesión con el Paso de Tarjeta

Obtenga un token como de costumbre — vea Autenticación — y agregue paymentCard a POST /v1/sessions:

curl --request POST \
  --url https://{FQDN}/v1/sessions \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "userRef": "user-123",
  "delivery": { "mode": "webhook" },
  "paymentCard": { "capture": true, "tokenize": { "storeLaterUse": false } }
}'

La respuesta es el sessionId y el widgetUrl de siempre. Cada campo y los rechazos están en Sesiones de Tarjeta.

Envíe el widgetUrl como ya lo hace. El titular pasa por los pasos de identidad y luego por el paso de tarjeta — vea Flujo del Widget para saber qué ve.

Paso 3: Reciba el Resultado

La sesión termina una vez y se entrega una vez, por el mismo webhook o la misma redirección que cualquier sesión de identidad. En una sesión con tokenización, el resultado lleva el token:

{
  "status": "completed",
  "checks": [
    { "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": "one_time",
    "recordedAt": "2026-07-31T14:04:41.112Z"
  }
}

Lea las filas de la tarjeta antes de usar el token: una sesión con tokenización conserva su bloque paymentCard sea cual sea la conclusión de las verificaciones de la tarjeta. Vea Verificaciones de la Tarjeta y Resultados de la Tarjeta.

Paso 4: Use el Token

paymentCard.token es un token de tarjeta del gateway. Úselo con las APIs de pago del gateway exactamente como un token del propio tokenizador del gateway, bajo las mismas reglas de uso único y recurrente.

Maneje Estos Casos Antes de Salir a Producción

Caso	Qué ocurre	Vea
El titular agota los intentos de tarjeta	La sesión termina `failed`, sin bloque `paymentCard`	Verificaciones de la Tarjeta
Una verificación de la tarjeta falla después de registrado el token	La sesión se completa, el bloque está presente y la fila dice qué falló	Verificaciones de la Tarjeta
La tokenización se desactiva para su tenant después de enviado un enlace	El paso de tarjeta de ese enlace se ejecuta como solo verificación	Sesiones de Tarjeta
Una sesión sin `paymentCard`	Sin paso de tarjeta, sin filas de la tarjeta	—

Próximos Pasos

Sesiones de Tarjeta — el objeto paymentCard completo
Tratamiento de Datos — qué llega a Inyo360 y qué se conserva
Sandbox y datos de prueba — cómo probar el paso de tarjeta