vaulted_token; Yuno reemplaza esas referencias por los datos reales de la tarjeta dentro de su entorno seguro y reenvía la solicitud al destino. El número de tarjeta sin procesar nunca pasa por tu infraestructura, por lo que tu alcance de PCI no cambia.
RequisitosEl PCI Proxy funciona con tarjetas que ya almacenaste en Yuno. Las tarjetas se almacenan cuando un cliente guarda un método de pago durante el checkout, o cuando inscribes una mediante el endpoint Enroll Payment Method.
Cómo funciona
- Tu servidor envía una solicitud HTTPS a
https://api.y.uno/v1/pci-proxy/forward, autenticada con tus credenciales estándar de la API de Yuno. - Colocas la URL completa del destino (incluidos su ruta y su query) en el encabezado
yuno-proxy-destination-urly haces referencia a los datos de la tarjeta en el cuerpo o en los encabezados de la solicitud mediante expresiones como{{vaulted_token.<TOKEN>.number}}. - Dentro del entorno PCI de Yuno, el proxy resuelve cada expresión con los datos reales de la tarjeta y luego reenvía tu solicitud (con el mismo método, los mismos encabezados y el mismo cuerpo) al destino mediante TLS.
- La respuesta del destino te llega junto con encabezados de diagnóstico que indican lo que hizo el proxy.
Datos de tarjeta en las respuestas
Si un destino devuelve en su respuesta un número de tarjeta completo, entregártelo volvería a incluir tus sistemas en el alcance de PCI. Para evitarlo, el proxy analiza cada respuesta en busca de números de tarjeta: el que acaba de inyectar y cualquier otro número de tarjeta válido. De forma predeterminada, el proxy los oculta y deja solo los últimos cuatro dígitos, e informa cuántos fueron en el encabezado de respuestayuno-proxy-response-redactions; un valor distinto de cero indica que tu destino devuelve datos de tarjeta que no deberías recibir. Yuno puede configurarse opcionalmente, como ajuste de todo el servicio y no por cuenta, para rechazar en su lugar cualquier respuesta que contenga datos de tarjeta con 502 RESPONSE_BLOCKED.
Datos de tarjeta a los que puedes hacer referencia
El
<TOKEN> debe ser un vaulted_token que pertenezca a tu organización. Un token que no existe o que pertenece a otra organización se rechaza con EXPRESSION_RESOLUTION_FAILED, antes de que se lea cualquier dato de tarjeta. Un campo cuyos datos no están disponibles falla del mismo modo; por ejemplo, un campo network_token_* cuando la tarjeta no tiene network token, o network_transaction_id cuando la tarjeta no tiene NTID. Todos los campos pueden combinarse en la misma solicitud.
No son tokens de proveedor ni criptogramasEstas expresiones resuelven un vaulted token como los datos almacenados con él: la tarjeta (PAN, vencimiento, nombre del titular), su network token (DPAN y su vencimiento) y su ID de transacción de red. Los tokens de proveedor no se resuelven. Los criptogramas tampoco: un criptograma se genera por transacción, por lo que, si tu destino requiere uno, obtenlo desde Generate Network Token Cryptogram justo antes del reenvío e incluye el valor directamente en el cuerpo de la solicitud. Si tu organización no tiene certificación PCI, solicítalo con
include_network_token: false: la respuesta que solo contiene el criptograma no incluye datos equivalentes al PAN, y la expresión network_token_number resuelve el DPAN en el momento del reenvío.La expresión del código de seguridad (CVV) tiene una vigencia limitada
{{vaulted_token.<TOKEN>.security_code}} se resuelve solo mientras el código de seguridad sigue disponible: de forma predeterminada, durante 3 horas después de la inscripción. Nunca se almacena: se conserva brevemente después de que tu cliente lo ingresa, y Yuno deja de entregarlo cuando se cierra esa ventana. Envíalo como card.security_code al inscribir la tarjeta y revisa card_data.security_code_expires_in en el método de pago antes de depender de él. Fuera de esa ventana, incluye el CVV directamente en el cuerpo de la solicitud tú mismo si tu destino lo requiere; el proxy lo reenvía sin almacenarlo. Ten en cuenta que transmitir un código de seguridad sin procesar mantiene esa solicitud dentro de tu alcance de PCI.Tu alcance de PCI
Cuando usas el PCI Proxy junto con los SDK de Yuno para recopilar tarjetas, los datos de tarjeta sin procesar nunca entran en tus sistemas: fluyen del cliente a Yuno y de Yuno al destino que elijas. La mayoría de los comercios que operan de este modo califican para la autoevaluación SAQ A. Consulta Cumplimiento de PCI para ver el panorama completo de cómo Yuno reduce tu alcance de PCI.Controles de seguridad
- Solo HTTPS. El proxy se conecta a los destinos mediante TLS 1.2 o superior, solo por el puerto 443. Los destinos deben ser nombres de host DNS públicos: las direcciones IP y las redes internas se rechazan.
- Aislamiento de credenciales. Tus credenciales de la API de Yuno y todos los encabezados
yuno-*se eliminan antes de reenviar la solicitud. El destino solo ve los encabezados que quieres que vea. - Sin almacenamiento ni registro. El proxy conserva los datos de tarjeta solo en memoria durante la vida útil de la solicitud. Los cuerpos de la solicitud y de la respuesta se excluyen de los registros y de las trazas.
- Rastro de auditoría completo. Cada invocación genera un registro de auditoría (quién, cuándo, destino, resultado; nunca datos de tarjeta).