Sandbox y Datos de Prueba
El paso de tarjeta en sandbox es el pipeline de producción: captura real, enmascaramiento real, verificaciones reales. No hay ningún valor reservado que dicte el desenlace de una tarjeta, así que usted lo prueba fotografiando una tarjeta.
El acceso al sandbox, las credenciales y la entrega de resultados son los de la integración de identidad — vea Sandbox y Datos de Prueba de identidad.
Qué Escanear
Una tarjeta física, sostenida frente a la cámara del teléfono. Una tarjeta mostrada en la pantalla de otro dispositivo es justamente lo que payment_card_scene_clear y payment_card_authentic existen para detectar, así que no sirve como prueba del paso de tarjeta.
Tiene dos opciones:
| Tarjeta | Úsela para |
|---|---|
| La muestra impresa de abajo | Ejecutar el flujo completo, tokenización incluida, sin una tarjeta real |
| Una tarjeta propia | Comprobar cómo leen las verificaciones una tarjeta genuina |
Un número de documento de identidad reservado del sandbox de identidad termina la sesión en su creación, así que una sesión que lo usa nunca llega al paso de tarjeta. Use una captura real de su documento de identidad cuando pruebe la tarjeta.
La Tarjeta de Muestra
Un frente y un reverso de una tarjeta inventada, mostrados pequeños a propósito: imprímala y fotografíe el papel. Una foto de una pantalla es lo que payment_card_scene_clear rechaza.
Descargue para imprimir: frente · reverso
Qué esperar de ella:
| Fila | Qué esperar |
|---|---|
payment_card_authentic | Una muestra impresa puede leerse como no genuina. Use una tarjeta propia para ver esta fila aprobada |
payment_card_name_match | Falla: la muestra lleva un nombre inventado, que no es el nombre de su documento de identidad |
payment_card_token_match | Puede aprobarse: tokenice el número tal como se leyó — vea abajo |
Coincidencia del Token en Sandbox
En el modo de tokenización, payment_card_token_match se aprueba solo cuando la tarjeta tokenizada concuerda con la fotografiada:
- Los últimos cuatro dígitos del número que tokeniza deben ser los últimos cuatro que quedan visibles en la tarjeta fotografiada. Confirme el número tal como se leyó en la pantalla de confirmación; cambiarlo por el número de otra tarjeta hace fallar la fila con
last_four_mismatch. - El nombre confirmado debe coincidir con el nombre de su documento de identidad o con el nombre leído en la tarjeta. El nombre impreso en la muestra supera esta mitad, porque coincide con la tarjeta.
La regla completa está en Verificaciones de la Tarjeta.
Las Tarjetas de Prueba del Gateway
Los números de tarjeta de prueba del gateway rigen lo que el gateway hace después con un token: aprobación, rechazo, desafío de 3D Secure. No deciden nada en el paso de tarjeta, que lee solo lo que fotografió.
La muestra imprime uno de los números de tarjeta de prueba del gateway, uno sin 3D Secure. Por eso un token de la muestra se comporta en el sandbox del gateway como esa tarjeta de prueba.
Cuando Falla una Verificación de la Tarjeta
La sesión igualmente se completa, salvo que el titular haya agotado los intentos de tarjeta:
| Qué falla | Sesión | Bloque paymentCard |
|---|---|---|
payment_card_scene_clear o payment_card_readable | El titular vuelve a tomar la tarjeta. Sin intentos de tarjeta restantes, la sesión termina failed | Ausente — no se solicitó ningún token |
payment_card_authentic o payment_card_name_match | completed, la fila se cobra contra el trustIndex | Presente en una sesión con tokenización |
payment_card_token_match | completed, la fila se cobra contra el trustIndex | Presente |
Vea Qué hace una fila que falla.
Próximos Pasos
- Verificaciones de la Tarjeta — qué decide cada fila de la tarjeta
- Flujo del Widget — la pantalla de confirmación y Escanear de nuevo
- Tokenización de Tarjetas — cómo usar el token después
