Valida mi integración headless / Secure Fields de Yuno Web SDK siguiendo este archivo.Funciona como un
CLAUDE.md, un AGENTS.md o un prompt pegado, con cualquier agente de programación. Audita el Yuno Web SDK v1
(línea 1.11) usado sin la interfaz de checkout de Yuno: pago e inscripción headless, la división en dos tarjetas y Secure Fields
(iframes pan, expiration, cvv) con ciclo de vida, precarga de fraude y CSP. Informa los problemas con archivo y línea,
solo lee el código y no cambia nada a menos que lo pidas. Los flujos con interfaz de usuario corresponden al archivo hermano web-sdk-v1-checkout-flows.md.
Cómo usarlo
Primero detecta cuál de los cinco contratos usa el repositorio, luego ejecuta las verificaciones transversales (1 a 4) más los grupos que apliquen, y marca los demás como N/A:grep -rnE "apiClientPayment|apiClientEnroll|generateToken|generateTokenWithInformation|generateHeadlessToken|getThreeDSecureChallenge|getContinuePaymentAction|continueEnrollment|executeFraudCheck|\.secureFields\(|unmountSync|generateVaultedToken|generateVaultedTokenWithInformation|payment_method: *\[|\.initialize\(|loadScript|sdk-web\.y\.uno" --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=.git --exclude-dir=build .
Ejecuta el validador hermano para cualquier llamada a
startCheckout o mount*. El código del servidor (sesiones, Create Payment) está
dentro del alcance cuando está en el repositorio. No des por aprobada una verificación porque el código “se vea bien”: cita la línea.
Los flujos que se validan
Una instancia por página:const yuno = await Yuno.initialize(PUBLIC_API_KEY). Las sesiones vienen de tu servidor.
Verificaciones
Severidad: (B) bloquea o corrompe silenciosamente un pago, (H) incidente probable, (M) comportamiento degradado o higiene de seguridad, (L) higiene. Informa PASS / FAIL / N/A para cada una. Los errores de validación se lanzan como<key>=<value> is not valid; cítalos exactamente cuando expliques un FAIL.
Transversales
- Un solo
Yuno.initialize por página, con await, instancia conservada (H1, H)
Yuno.initialize por página, con await, instancia conservada (H1, H)- Revisa
Yuno.initialize(yloadScript(en cuerpos de componentes, efectos sin protección, controladores de clic, funciones auxiliares por intento y sinawait. - FAIL en: más de una ruta de llamada por carga de página; sin
await; la instancia no se conserva en el ámbito del módulo, el contexto o una ref. - Por qué: sin
await,yunoes una Promise y la primera llamada lanzaTypeError: yuno.secureFields is not a function(oapiClientPayment); cadainitializereemplaza el cliente de API global, así que las llamadas del lado del host (fraude, 3DS, headless) de clientes anteriores cambian a la clave más reciente. Las llamadas de tarjeta de Secure Fields conservan su propio cliente.
- Solo la clave de API pública llega al navegador (H2, B)
- Busca en el código del cliente
private-secret-key,PRIVATE_SECRET_KEY, secretos enNEXT_PUBLIC_*,VITE_*,REACT_APP_*, o un secreto pasado aYuno.initialize(. - FAIL en: cualquier coincidencia en código accesible desde el navegador.
- Por qué: el secreto autoriza Create Payment y los reembolsos; cualquiera que lea el bundle puede mover dinero.
- La CSP y la red permiten los hosts de Yuno (H3, H)
- Revisa
Content-Security-Policy(meta, servidor,next.config.js, nginx) y las listas de permitidos de bloqueadores de anuncios o WAF. - FAIL en:
frame-src(odefault-src) sinhttps://sdk-web-card.<env>.y.unoyhttps://sdk-3ds.<env>.y.uno;connect-srcsin el host de la API (api.y.uno,api-sandbox.y.uno) ywss://<env>.y.uno;script-srcsinhttps://sdk-web.y.unoy su host de chunks cargados bajo demanda; reglas que bloquean*.y.uno. Los proveedores de fraude cargan sus propios scripts y frames, por lo que también se necesitan los hosts de los proveedores de la cuenta. - Por qué: si el mediador no puede conectarse, el
render()de un campo nunca se resuelve (un defecto del SDK, así querender().catchno muestra nada; agrega tu propio timeout en la interfaz) mientras quegenerateTokense rechaza tras 30 s conbridge: child did not connect within 30000ms; un frame de 3DS bloqueado parece un desafío colgado. Verifica el bloqueo en tiempo de ejecución. - La documentación de Yuno no publica una lista de permitidos de CSP; esta lista proviene del código del SDK. UE, MENA, marca blanca: verifica en tiempo de ejecución.
apiUrl / assetUrl de marca blanca solo detrás de un proxy completo (H4, M)
apiUrl / assetUrl de marca blanca solo detrás de un proxy completo (H4, M)- Busca
apiUrl:oassetUrl:en las opciones deYuno.initialize(. - FAIL en: configurado sin un proxy que reenvíe cada ruta de Yuno, incluidas
/v<card-version>/pages/*y el host de 3DS;apiUrlapuntando a un host que no es el proxy propio del comercio. - Por qué: los iframes de tarjeta servidos desde
*.y.unorechazan unapiUrlajeno (registrado comoAPI_URL_REJECTED) y usan la API de Yuno de todos modos; un proxy incompleto deja campos o iconos en blanco.
Pago headless
apiClientPayment usa await y solo se llaman métodos reales (H5, B)
apiClientPayment usa await y solo se llaman métodos reales (H5, B)- Revisa
.apiClientPayment(sinawait;apiClientEnrollment,getPaymentMethods,api.continuePayment,api.generateHeadlessTokensinaccount_id. - FAIL en: el cliente usado sin await, o un método que no existe. El cliente headless tiene exactamente
generateToken,getThreeDSecureChallenge,getContinuePaymentActionygenerateHeadlessToken. - Por qué:
api.generateTokenesundefineden una Promise y lanzaTypeError: ... is not a function.
country_code es snake_case, ISO en mayúsculas, tomado del enum (H6, B)
country_code es snake_case, ISO en mayúsculas, tomado del enum (H6, B)- Revisa las claves de los argumentos de
apiClientPayment({yapiClientEnroll({. - FAIL en:
countryCode(camelCase) aquí;'co'en minúsculas; un nombre de país; un valor fuera deCountryCode. - Por qué: lanza
country_code=undefined is not validocountry_code=co is not valid; no es posible obtener un token.
- La recolección de fraude comienza cuando se renderiza el formulario, no al hacer clic en Pagar (H7, H)
- Busca
apiClientPayment(ygenerateToken(en el mismo controlador de envío, sin unexecuteFraudCheck(anterior y sin unapiClientPayment({ checkout_session })anterior. - FAIL en: ni
executeFraudCheck({ checkoutSession })niapiClientPayment({ checkout_session })se ejecutan antes de el controlador de envío. Un cliente sincheckout_sessiondespués deexecuteFraudCheckes correcto (resultado en caché). - Por qué: el token espera una recolección en curso hasta el timeout de fraude de la cuenta (3 s por defecto); cuando la recolección comienza al hacer clic y tarda más, el token no tiene huella digital del dispositivo y el proveedor puede rechazar.
executeFraudCheck usa argumentos en camelCase (H8, H)
executeFraudCheck usa argumentos en camelCase (H8, H)- Revisa
executeFraudCheck({. FAIL con las clavescheckout_session/country_code(como muestra la documentación). - Por qué: la promesa se rechaza con
checkoutSession=undefined is not valid, así que la precarga que el comercio cree que está en ejecución nunca comienza.countryCodees opcional y solo lo lee el recolector de EBANX: que falte es un FAIL solo en cuentas que enrutan a EBANX.
generateToken y getThreeDSecureChallenge usan await dentro de try/catch (H9, M)
generateToken y getThreeDSecureChallenge usan await dentro de try/catch (H9, M)- Busca estas llamadas fuera de
try, solo una cadena.then().catch(), o uncatch {}vacío. - FAIL en: cualquiera de esos casos.
- Por qué: la validación de argumentos lanza de forma síncrona, así que una cadena
.catchnunca la ve y la página falla; los errores de la API llevan el texto útil enerror.response.data(por ejemploINVALID_PARAMS: holder_name value less than allowed (3 chars minimum)). Los errores de Secure Fields exponenerror.datayerror.codeen su lugar.
- Una sesión de checkout llega a
generateToken (H10, B)
generateToken (H10, B)- Busca
apiClientPayment({ country_code })ygenerateToken({ payment_method }), ambos sin sesión. - FAIL en: ninguna de las dos llamadas lleva la sesión; la sesión del token difiere de la enviada a Create Payment.
- Por qué:
generateTokense rechaza concheckout session is required.
payment_method.type es un Payment.Type en mayúsculas (H11, B)
payment_method.type es un Payment.Type en mayúsculas (H11, B)- FAIL con
type:dentro depayment_methodestablecido como'card','credit_card','CREDIT_CARD'o vacío. - Por qué: lanza
type=card is not valid(división:payment_method[0].type=CARDS is not valid), también en la inscripción.
- Sin
device_fingerprint / third_party_session_id solo de la documentación (H12, H)
device_fingerprint / third_party_session_id solo de la documentación (H12, H)- Busca
device_fingerprint:othird_party_session_id:dentro depayment_method. - FAIL en: presentes sin las formas
device_fingerprints(arreglo de{ provider_id, id }) othird_party_data(arreglo de{ provider_id, session_id }). - Por qué: el SDK nunca lee esos dos nombres, así que el valor se descarta (una huella digital perdida hizo que Mercado Pago rechazara todos los pagos de un comercio).
- PAN sin procesar: número completo sin enmascarar, validado por ti, nunca registrado en logs (H13, H)
- Revisa qué alimenta
card.detail.number:maskedPan,lastFour, caracteres*o viñetas, espacios o guiones; sin verificación de Luhn ni de longitud;console.log, analítica, Sentry o logs del servidor del argumento de la llamada. - Por qué (FAIL en cualquiera): headless pasa el número tal como lo recibe, sin verificación de Luhn ni de longitud según la marca, así que un PAN enmascarado o
mal formado es rechazado por el proveedor (
CardNumber: Invalid parameter size); registrar en logs escribe datos de tarjeta en ellos. - Espacios en el PAN o un año de 2 dígitos como cadena: no confirmado en el código, verifica en tiempo de ejecución. La documentación indica SAQ A solo para Full, Lite y Secure Fields; con Headless el PAN pasa por tu página (infórmalo como información).
- Create Payment: solo token,
callback_url absoluto, misma sesión (H14, B)
callback_url absoluto, misma sesión (H14, B)- Lee el código del servidor que construye el cuerpo de Create Payment (también para Secure Fields).
- FAIL en:
vaulted_tokenjunto atoken;callback_urlausente, nulo, relativo o sinhttps://;checkout.sessiondistinta de la sesión del token; tu propiocheckout_session_iden un create de flujo DIRECT. - Por qué:
vaulted_tokensobrescribe todo el método de pago, incluida la huella digital; uncallback_urlsin protocolo rompió la página de 3DS, y uno nulo dejó el desafío en blanco (hallazgos de incidentes, no del código del SDK: verifica en tiempo de ejecución).
- Desafío 3DS: protege
url, mantenla intacta, verifica el origen (H15, B)
url, mantenla intacta, verifica el origen (H15, B)- Revisa
getThreeDSecureChallenge(, el código que establece elsrcdel iframe yaddEventListener('message'. - FAIL en: (a) sin verificación de
url === nullni del literal'work in progress'; (b) la URL analizada y reconstruida, perdiendosession,challenge-urloaccess-token; (c) faltaembedded=truepara el uso en iframe; (d) un listener que acepta cualquier origen o compara conincludes('sdk-3ds')en una configuración de marca blanca, en lugar de verificardata.origin === 'CHALLENGE'ydata.statusdesde el origen de 3DS; (e) un argumento de tipo objeto ({ checkoutSession }) en lugar de la cadena; (f) una página contenedora en un origen distinto de aquel desde el que se creó la sesión. - Por qué:
{ url: null }es la respuesta normal cuando no hay desafío, así quenull&embedded=truemuestra una página de error; el desafío publica su resultado solo en el origen firmado en su tokensession(cómo se deriva: verifica en tiempo de ejecución).
- Sin
yuno.continuePayment() sin argumentos en headless (H16, M)
yuno.continuePayment() sin argumentos en headless (H16, M)- Busca
yuno.continuePayment(en un repositorio que usaapiClientPaymenty nunca llama astartCheckoutni asecureFields. - FAIL en: llamado sin
{ checkoutSession }. Por qué: headless nunca establece el estado del SDK, así que una llamada sin argumentos se resuelvenully no muestra nada; con una sesión renderiza la interfaz de Yuno. Usa en su lugar las llamadas del cliente headless.
- El resultado del pago proviene del webhook o de Retrieve Payment (H17, H)
- Busca el cumplimiento del pedido condicionado solo a
paymentResult,yunoPaymentResult, el eventomessagedel iframe o la página de destino de la redirección. - FAIL en: el estado del pedido establecido solo desde el navegador.
- Por qué: un 3DS con redirección navega fuera antes de que se ejecute cualquier callback en la página, y una señal del cliente puede falsificarse.
- Sin lógica sobre
card_data.fingerprint del token (H18, L)
card_data.fingerprint del token (H18, L)- Busca
.card_data.fingerprinto.fingerprinten la respuesta del token usada para deduplicar o evaluar riesgo. - Por qué: es nulo para una tarjeta nueva, no guardada en el vault, y se establece en la respuesta del pago (regla del backend: verifica en tiempo de ejecución).
Inscripción headless
customer_session nueva, cliente con await, verificación de estado (H19, H)
customer_session nueva, cliente con await, verificación de estado (H19, H)- Revisa
apiClientEnroll(,continueEnrollment(y el código del servidor que crea las sesiones de cliente. - FAIL en: una
customer_sessionreutilizada entre inscripciones;apiClientEnrollsinawait; éxito asumido sinstatus === 'ENROLLED';ENROLL_IN_PROCESSoPENDINGtratados como fallo; sin sesión en ninguna de las dos llamadas (lanzacustomer_session is required). - Por qué:
DECLINED,REJECTED,ERRORno son una tarjeta inscrita;ENROLL_IN_PROCESSyPENDINGse resuelven por webhook, así que tratarlos como fallo descarta una tarjeta que se inscribe más tarde. Una sesión reutilizada que falla en la llamada al vault: verifica en tiempo de ejecución.
Secure Fields
- Una instancia de
secureFields por formulario, conservada en una ref, usada para los campos y el token (H20, B)
secureFields por formulario, conservada en una ref, usada para los campos y el token (H20, B)- Busca
.secureFields(en el cuerpo de un componente, una función de renderizado,onSubmito un efecto sin resultado almacenado; dos sitios de llamada; sinuseRefni variable de módulo. - FAIL en:
yuno.secureFields()que pueda ejecutarse dos veces por montaje;generateTokenen otra instancia distinta de la que creó los campos. - Por qué: cada instancia tiene su propio mediador oculto y su propio mapa de campos, así que un token de la segunda instancia envía una tarjeta vacía que la API rechaza (verifica la respuesta en tiempo de ejecución); además se apropia del hook de reintento y del listener de sesión.
- Cada campo se crea una vez, se renderiza en su propio elemento visible existente,
render con await (H21, B)
render con await (H21, B)- Revisa
.create({ name:repetido para un mismo nombre;.render('#...')apuntando a un elemento que el framework crea después o vuelve a crear;rendersinawait/ catch; nombres distintos depan,expiration,cvv,cardPin,cardLoadPreview; un contenedor para dos campos; un contenedor (o ancestro) condisplay:noneo recortado poroverflow:hidden. - FAIL en: cualquiera de estos casos, pero informa
cardPinycardLoadPreview(compatibles, no documentados) como información. No hay campo para el nombre del titular; el nombre va encardHolderName(verificación 23). - Por qué:
renderse rechaza conElement #pan doesn't exist in the DOM(un rechazo no controlado si no usa await); un nombre desconocido falla conbridge: url is required; el iframe establece su propia altura en píxeles a partir del hijo, así que un contenedor de altura cero está bien, pero uno oculto o que recorta no muestra nada. Un segundocreatecon el mismo nombre que deje el iframe anterior en el DOM es lectura de código: verifica en tiempo de ejecución.
Re-renderizado y ciclo de vida del framework (Secure Fields)
- Un montaje por componente, limpieza al desmontar, seguridad ante StrictMode y remontaje (H22, H)
- React:
initializeuna sola vez (promesa a nivel de módulo o ref protegida);secureFields()y la secuenciacreate/renderen un solo efecto con una proteccióncancelleddespués de cadaawait; una instancia de campo por nombre de campo; dependencias limitadas a[yuno, checkoutSession, countryCode], callbacks leídos desde una ref; la limpieza establececancelled = truey llama aawait sf.unmountSync()sin argumentos. StrictMode ejecuta el efecto dos veces en desarrollo, así que el primer montaje debe desmontarse por completo. Nunca crees campos durante el renderizado ni enonChange. - Re-renderizado: llama a
f.render(selector)de nuevo sobre el mismo campo (reemplaza su iframe); después desf.unmountSync()la instancia está muerta, así que crea un nuevoyuno.secureFields(). - Next.js: el componente es
'use client'o se carga condynamic(..., { ssr: false }); sinloadScriptniinitializeen código del servidor (document is not defined). Vue / Angular / SPA (guía, no está en la documentación de Yuno): crea enonMounted/ngAfterViewInit,unmountSync()enonBeforeUnmount/ngOnDestroyo al salir de la ruta. - FAIL en: sin limpieza; limpieza que solo llama a
field.unmountSync()por campo; unrenderedFlagen lugar de limpieza (la demo de React de Yuno hace esto; no lo copies); dependencias que cambian en cada renderizado; sin proteccióncancelled; callbacks que capturan estado obsoleto;createsobre una instancia muerta; un cambio de ruta que deja montado el formulario anterior. - Por qué: un primer montaje filtrado agrega un segundo conjunto de iframes y de mediador (formularios en competencia tras la navegación en la SPA perdieron
la entrada y las cuotas);
render()espera al mediador, así que una limpieza anterior puede dejar un iframe atrás; las llamadas después desf.unmountSync()se rechazan conbridge closed. QueunmountSyncpor campo deje vivo el mediador es lectura de código: verifica en tiempo de ejecución contando los iframes endocument.bodydespués de desmontar.
Secure Fields (continuación)
generateToken después de renderizar, con cardHolderName, sin checkoutSession, estado del formulario verificado (H23, B)
generateToken después de renderizar, con cardHolderName, sin checkoutSession, estado del formulario verificado (H23, B)- Revisa
.generateToken(/.generateTokenWithInformation(en la instancia de Secure Fields. - FAIL en: sin
cardHolderName; una clavecheckoutSessioncuando el reintento de pago está activo para la cuenta (o un valor que pueda diferir de la sesión actual de la instancia); sin verificar que los tres campos se renderizaron y son válidos (indicadores deonChangeoawait field.validate()); una llamada desde otra instancia (verificación 20). - Por qué: no hay validación local (la verificación de Luhn solo registra), así que un campo vacío se envía como
''y la API responde 400, por ejemploINVALID_PARAMS: holder_name value less than allowed (3 chars minimum); uncheckoutSessionpasado prevalece sobre la sesión clonada de reintento. Sin reintento, la documentación lo permite engenerateToken.
- Funciones auxiliares de campo solo después de
render, protegidas tras desmontar (H24, M)
render, protegidas tras desmontar (H24, M)- FAIL en
.focus(,.blur(,.validate(,.setError(,.clearError(,.resetFields(,.setCardType(sin protección: antes de queawait render()se resuelva, en la limpieza tras desmontar, o sobre ungetElement()posiblementeundefined. - Por qué: antes de que el campo llegara al mediador, este indexa su mapa sin verificar nulos y se rechaza con
Cannot read properties of undefined (reading 'validateElement')(misma familia que el fallo declearValueElement); después de desmontar un campo o todo, la llamada se rechaza conbridge closed.
- La limpieza usa
secureFields.unmountSync(), no unmountSdk (H25, M)
secureFields.unmountSync(), no unmountSdk (H25, M)- FAIL en
unmountSdk(como única limpieza de Secure Fields, incluso después de un pago que no necesita más acciones. - Por qué:
unmountSdksolo desmonta la raíz de React del SDK (como uncontinuePaymentrenderizado), nunca los iframes ni el mediador de Secure Fields, que permanecen en la página después del pago y pueden capturar un segundo envío.
- Conexión del reintento de pago cuando el indicador de reintento está activo (H26, H)
- Revisa el manejo después de Create Payment,
continuePayment(yupdateCheckoutSession(. - FAIL en: un resultado de tarjeta
DECLINED/ERRORque no es seguido poryuno.continuePayment(); el campopandestruido antes del reintento;checkoutSessionpasado a la llamada del token. - Por qué: el formulario queda abierto sin un siguiente paso, o el reintento se ejecuta sobre una sesión obsoleta; el reintento lee el campo llamado
pan. El reintento es un indicador del servidor por organización (si el sandbox lo tiene: verifica en tiempo de ejecución).
- Los estilos y las opciones respetan el iframe (H27, L)
- Revisa
options.styles,designType,validateOnBlur,validationTypey las lecturas de datos deonChange. - FAIL en:
designTypefuera defloat-label,float-label-static,label-placeholder; CSS de la página que se espera que llegue al interior del iframe; lectura de datos deonChangesin?..validateOnBluraún funciona (se trata comoon_blur): infórmalo como información, ya que la página de documentación de pagos lo marca como obsoleto en favor devalidationType. - Por qué: se lanza
designType=<value> is not valid;styleses una cadena de CSS inyectada solo en el iframe; da estilo al contenedor mediante sus clasesfocus,hover,error(el SDK establecefont-size:0,margin:-1px).
- Inscripción con Secure Fields: solo
customerSession, cardHolderName pasado (H28, H)
customerSession, cardHolderName pasado (H28, H)- Revisa
secureFields({concustomerSessionygenerateVaultedToken(. - FAIL en: tanto
checkoutSessioncomocustomerSession(el SDK se ejecuta en modo de pago); ninguna sesión de cliente (uncustomerSessionpasado agenerateVaultedTokenes una alternativa aceptada); sincardHolderName. - Por qué:
secureFields()no valida nada, así que una sesión faltante falla solo más tarde dentro de los iframes.
División en dos tarjetas (headless)
- Token compuesto: forma, totales y orden (H29, B)
- Revisa
generateToken({ ... payment_method: [. - FAIL en: menos de dos elementos; un elemento sin
cardnivaulted_token;amount.valueausente, cero o una cadena ("60");amount.currencyvacío; una moneda distinta detotal.currency; importes que no suman exactamente; untypedesconocido. Informa la ausencia detotaly un tercer elemento como advertencias: la documentación exigetotaly exactamente dos elementos, el SDK no. - Por qué: el SDK lanza antes de cualquier solicitud:
payment_method must have at least two items; use an object for one payment method,payment_method[1] needs card or vaulted_token,payment_method[0].amount.value=0 is not valid,payment_method[0].amount.currency= is not valid,payment_method[0].type=CARDS is not valid,payment_method[1].amount.currency=EUR does not match total.currency=USD,payment_method amounts add up to 60 + 30 but total.value=100,payment_method must be an object or an array of payment methods,total.currency=<v> is not valid,total.value=<v> is not valid.totales opcional en el SDK y en el core; la documentación dice quePOST /v2/paymentsrechaza un pago sin él: verifica en tiempo de ejecución, igual que con un tercer elemento. Losdevice_fingerprintsythird_party_datapor elemento son descartados hoy por la ruta de token v2, así que los tokens de división no llevan datos de fraude del comercio.
- Token compuesto canjeado en v2, desafíos ejecutados uno por uno (H30, B)
- Lee el código del servidor que recibe el token compuesto y el bucle alrededor de
getThreeDSecureChallenge. - FAIL en: el token enviado a
/v1/payments; sincallback_url; el siguiente desafío solicitado antes de que la transacciónTHREE_D_SECUREde la tarjeta anterior saliera dePENDING(webhook oGET /v2/payments/{id}) o antes de su mensajeCHALLENGE; un bucle de cantidad fija en lugar de detenerse enurl === null; la otra tarjeta ofrecida después destatus === 'ERROR';card_dataleído del resultado compuesto. - Por qué: una llamada temprana devuelve la misma tarjeta otra vez (la primera tarjeta sigue esperando), y después de
ERRORel SDK aún entrega la siguiente tarjeta, así que detenerse es tu responsabilidad. La documentación dice que el token funciona solo enPOST /v2/paymentsy que la otra tarjeta se revierte tras un fallo: verifica en tiempo de ejecución. La división debe ser habilitada en la cuenta por Yuno.
- La versión del SDK admite la división y las correcciones referenciadas aquí (H31, M)
- Lee
@yuno-payments/sdk-webenpackage.jsony en el lockfile, y las URL de scripts (sdk-web.y.uno/v1.xx/main.js,loadScript). - FAIL en: división usada en una línea anterior a 1.11.43; un parche anterior fijado donde llegó una corrección referenciada (por ejemplo
la protección
clearValueElementde Secure Fields). - Por qué: en 1.11.42 y anteriores, el arreglo pasa por el validador de tarjeta única y lanza
type=undefined is not validantes de cualquier solicitud. La URLv1.11ya sirve 1.11.43 o posterior.
Formato del informe
Diagnósticos que debes capturar
- La versión del SDK (URL del script o
@yuno-payments/sdk-web) y la versión de sdk-web-card delsrcdel iframe (sdk-web-card.<env>.y.uno/v<version>/pages/...); la versión de la tarjeta sigue almain.jscargado. - El id de la sesión de checkout (sesión de cliente para la inscripción) y la hora UTC.
- Errores de la consola del navegador, especialmente
bridge: child did not connect within 30000ms,bridge closed,Element #<id> doesn't exist in the DOMy cualquier<key>=<value> is not valid. - Informes de violación de CSP, solicitudes
*.y.unobloqueadas, unrender()de campo que nunca se resuelve y el conteo de iframessdk-web-carddespués de un remontaje. - La llamada que falla sin datos de tarjeta ni claves, y
error.response.dataoerror.code/error.data.
Documentación frente a código
Cuando la documentación pública y el código no coinciden, sigue el código e informa al comercio que la documentación se está corrigiendo.
Fuentes: el código fuente de Web SDK 1.11.47 (bundle
v1.11 servido 1.11.45), el formulario de tarjeta 1.93.0,
@yuno-payments/sdk-web-types 5.8.1 y la documentación pública de Yuno. Investigación 2026-10-29.