> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Preguntas frecuentes

> Respuestas a las preguntas más frecuentes sobre la integración de Yuno con VTEX.

> [accordion] ¿Cómo gestiona Yuno los pagos de Pix vencidos?
>
> Yuno rastrea automáticamente el vencimiento de cada pago de Pix según la configuración de tu integración. Antes de que un pago de Pix venza, Yuno verifica de forma proactiva si se completó. Si el comprador no paga a tiempo, Yuno notifica a VTEX, que cancela el pedido automáticamente.

> [accordion] ¿Cómo se gestionan las tarjetas guardadas y Click to Pay?
>
> Los flujos de tarjetas guardadas y Click to Pay dependen de que se cree un registro de cliente en Yuno. Para habilitarlos, configura el campo **Create Customer** en **Yes** en la configuración de tu proveedor de Yuno. Con esta opción habilitada, el plugin crea o actualiza un registro de cliente de Yuno en cada pago.

> [accordion] ¿Yuno admite las suscripciones de VTEX (pagos recurrentes)?
>
> Sí. Los pedidos creados con la función de [suscripciones](https://help.vtex.com/docs/tutorials/how-subscriptions-work) de VTEX se admiten de forma nativa. La primera compra se procesa como cualquier otro pago con tarjeta. Las renovaciones automáticas que siguen se cobran aunque el comprador no esté presente y no se ingrese ningún código de seguridad (CVV). Yuno las procesa como pagos de credenciales almacenadas iniciados por el comercio (MIT), una clasificación que permite que los cobros recurrentes se completen en lugar de ser rechazados.
>
> No hay nada adicional que configurar en Yuno: siempre que hayas configurado las suscripciones en VTEX, la integración las gestiona automáticamente y tu checkout habitual no se ve afectado. Las suscripciones aplican solo a pagos con tarjeta.

> [accordion] ¿Cómo cambio entre sandbox y producción?
>
> El entorno se determina por el prefijo de tu **Public API Key** de Yuno:
>
> * Los prefijos `dev_*`, `staging_*` y `sandbox_*` se conectan a entornos de prueba.
> * Los prefijos `prod_*` se conectan a producción.
>
> Para cambiar a producción, simplemente reemplaza tus claves de API en el dashboard de VTEX por tus credenciales de producción del dashboard de Yuno.

> [accordion] ¿Cómo puedo personalizar lo que aparece en los estados de cuenta de tarjeta de mis compradores?
>
> Usa el campo **Soft Descriptor** en la configuración de tu proveedor de Yuno. El texto que ingreses se envía al adquirente y se muestra en el estado de cuenta de tarjeta del comprador. Recomendamos usar el nombre de tu tienda para ayudar a los compradores a identificar la compra y reducir los contracargos.

> [accordion] Mi negocio opera varias cuentas de VTEX. ¿Necesito una integración de Yuno independiente para cada una?
>
> No necesariamente. Si tus cuentas de VTEX comparten las mismas credenciales de Yuno (por ejemplo, un modelo de franquicia), puedes usar los campos **Main Account** en la configuración del proveedor para compartir los datos de catálogo y pedidos. Si cada cuenta usa sus propias credenciales, debes configurarlas de forma independiente.

> [accordion] Tengo varias cuentas de Yuno bajo una sola tienda de VTEX. ¿Puedo usarlas todas?
>
> Sí. Puedes conectar una sola cuenta de VTEX a varias integraciones de Yuno. Configura Yuno como proveedor una vez por cada integración con un **Affiliation Name** distinto y luego selecciona la afiliación correcta al activar cada método de pago.

> [accordion] ¿Cómo se gestionan los pedidos con artículos de varios vendedores?
>
> Cuando el carrito de un comprador contiene productos de distintos vendedores o franquicias, VTEX divide la compra en varios subpedidos y cobra cada uno de forma independiente. Yuno procesa cada subpedido para que se pague el pedido completo, no solo la primera parte, y comparte una única sesión de antifraude entre todos ellos. Puedes controlar qué proveedores de antifraude reciben esa sesión compartida con el campo **Antifraud Providers for Split Orders**. Consulta [Advanced Features](https://docs.y.uno/es/docs/plugins/vtex/advanced-features.md#split-orders-multiple-sellers) para más detalles.

> [accordion] ¿Puedo cambiar el total de un pedido después del checkout?
>
> Sí. VTEX te permite modificar un pedido después de realizado, lo cual es útil cuando el monto final se conoce más tarde, como en los productos vendidos por peso. Si el total final es igual o menor, Yuno captura solo el monto final. Si es mayor, Yuno cobra la diferencia automáticamente a la tarjeta usada en el pedido original, sin que el comprador tenga que volver a ingresarla.
>
> Los cobros automáticos por totales **mayores** aplican a **tarjetas de crédito** y deben habilitarse con anticipación: configura **Vault Card for Order Modification** y **Create Customer** en **Yes** en la configuración de tu proveedor antes de que se realicen los pedidos. Consulta [Advanced Features](https://docs.y.uno/es/docs/plugins/vtex/advanced-features.md#order-modifications-changed-order-totals) para ver la configuración completa.

> [accordion] ¿Se pueden procesar las compras repetidas con network tokens?
>
> Sí. Configura **Enable Network Tokens** y **Create Customer** en **Yes** en la configuración de tu proveedor, y pide a tu KAM de Yuno o a soporte que activen los network tokens en las rutas que usa tu tienda: los campos de VTEX no tienen efecto hasta que se complete esa activación. La primera compra con una tarjeta se procesa con el número de la tarjeta; las compras posteriores de la misma tarjeta por el mismo cliente se procesan con un network token, lo que mejora las tasas de aprobación, por lo que el beneficio crece gradualmente a medida que los clientes regresan. Si la referencia de la tarjeta almacenada no está disponible, el pago continúa como hasta ahora. Almacenar una tarjeta para network tokens no permite cobros adicionales cuando aumenta el total del pedido; estos siguen controlados por **Vault Card for Order Modification**. Consulta [Network tokens](https://docs.y.uno/es/docs/plugins/vtex/advanced-features.md#network-tokens-repeat-card-purchases) para ver los requisitos previos y las consideraciones para varias cuentas.

> [accordion] ¿Las compras corporativas (CNPJ) en Brasil se pueden pagar a nombre de la empresa en lugar del comprador?
>
> Sí. Configura **Use Corporate Buyer Data** en **Yes** en la configuración de tu proveedor (plugin 4.2.350 o posterior). Cuando un comprador realiza el checkout como empresa con una dirección de facturación en Brasil, el boleto y todos los demás métodos de pago se emiten a nombre de la razón social y el CNPJ de la empresa en lugar del nombre personal y el CPF del comprador; las compras individuales no cambian. Consulta [Corporate purchases](https://docs.y.uno/es/docs/plugins/vtex/advanced-features.md#corporate-purchases-brazil) para ver los detalles y las limitaciones.

> [accordion] ¿Dónde puedo investigar un pedido específico?
>
> Abre el pedido en tu **dashboard de Yuno** para ver el ciclo de vida completo de cada intento de pago, incluidas las respuestas y los errores de los proveedores. Cruza el ID de pedido de VTEX con el ID de pago de Yuno para seguir la transacción de extremo a extremo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.