Affiliation Name
Un nombre legible para esta integración con Yuno.- Obligatorio: Sí
Yuno Brazil
Account ID
Tu Account ID de Yuno.- Obligatorio: Sí
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Public API Key
Tu Public API Key de Yuno.- Obligatorio: Sí
dev_, staging_, sandbox_ o prod_.
Ejemplo: sandbox_pub-xxxxxxxx
Private Secret Key
Tu Private Secret Key de Yuno.- Obligatorio: Sí
xxxxxxxxxxxxxxxxxxxxxxxx
Main Account Name
La cuenta de VTEX que es dueña de los datos de los pedidos, para configuraciones con varias cuentas.- Obligatorio: No. Déjalo vacío en una tienda de una sola cuenta.
mystoreparent
Main Account App key
Application Key de la cuenta principal de VTEX.- Obligatorio: No. Solo junto con Main Account Name.
vtexappkey-mystoreparent-XXXXXX
Main Account App token
Application Token de la cuenta principal de VTEX.- Obligatorio: No. Solo junto con Main Account Name.
XXXXXXXXXXXXXXXXXXXXXXXX
Soft Descriptor
Texto personalizado que aparece en el resumen de la tarjeta del comprador.- Obligatorio: No
MYSTORE*ORDER
Create Customer
Crea un registro de cliente en Yuno para cada comprador.- Obligatorio: No
Yes
VTEX IO orderPlaced page URL
Dónde llegan los compradores después del pago.- Obligatorio: No
https://www.example.com/checkout/orderPlaced
Payment Mode
Cómo paga el comprador: dentro del checkout o en una página de redirección.- Obligatorio: No
Payment App
Transaction Identification From
Qué ID de transacción muestra el pedido.- Obligatorio: No
Yuno TID
Antifraud Providers for Split Orders
Qué proveedores antifraude reciben la sesión compartida en los pedidos divididos.- Obligatorio: No
- Valor predeterminado: los cuatro proveedores en el plugin 4.2.362 o posterior;
RISKIFIEDyCYBERSOURCEen versiones anteriores.
RISKIFIED, CYBERSOURCE, SIGNIFYD y CIELO_CYBERSOURCE_FRAUD. Si la completas, solo los proveedores que incluyas reciben la sesión.
Ejemplo: RISKIFIED,CYBERSOURCE
Vault Card for Order Modification
Permite que el plugin cobre la diferencia cuando aumenta el total de un pedido.- Obligatorio: No. Necesita Create Customer en Yes.
Yes
Enable Network Tokens
Almacena tarjetas para que las compras repetidas puedan usar un network token.- Obligatorio: No. Necesita Create Customer en Yes.
Yes
Use Corporate Buyer Data
Paga los pedidos de empresas con el nombre y el CNPJ de la empresa. Solo Brasil.- Obligatorio: No
- Valor predeterminado:
No
Yes
Headless Payment Handoff
Para marketplaces cuyo propio checkout headless crea el pago de Yuno.- Obligatorio: No
- Valor predeterminado:
No - Disponible en el plugin: 4.2.356 o posterior para tarjetas, 4.2.361 o posterior para PIX
Yes en la tienda que ejecuta el checkout headless. Todas las demás tiendas dejan No.
Store Base Path
El prefijo de la ruta URL de una tienda que no se sirve desde la raíz del dominio.- Obligatorio: No
- Disponible en el plugin: 4.2.316 o posterior
https://www.example.com/br en lugar de la raíz del dominio. Es la ruta que usa la Payment App cuando llama a las rutas de pago de tu tienda durante el checkout. Déjalo vacío cuando la tienda se sirva desde la raíz del dominio.
- Usa solo segmentos de ruta simples: letras, números,
-y_. Sin esquema, host, query string ni puntos. - Se agrega una barra inicial si falta.
- Un valor que parece un nombre de host se ignora, y la tienda se comporta como si el campo estuviera vacío.
/br o /br/store
Send Order Sequence as Merchant Reference
Envía la secuencia del pedido de VTEX como referencia del comercio del pago.- Obligatorio: No
- Valor predeterminado:
No - Disponible en el plugin: 4.2.333 o posterior para PIX, boleto y los demás métodos creados en el servidor; 4.2.355 o posterior para todos los métodos de pago
1234567890123) como referencia del comercio del pago. Un proveedor configurado con una identificación de transacción personalizada, como Mercado Pago, muestra entonces esa secuencia como referencia externa en su panel, igual que antes de migrar a Yuno.
Cuando se establece en No, o cuando la secuencia no está disponible, la referencia es el ID del pedido de VTEX.
Ejemplo: Yes
Sales Channel Domains
Asocia cada canal de ventas con el dominio de su tienda.- Obligatorio: No
- Disponible en el plugin: 4.2.333 o posterior
- Escribe pares
id=domainseparados por;. También se aceptan una,entre pares y:entre el ID y el dominio. - Se elimina el prefijo
https://y las barras finales, y los pares mal formados se omiten. - Los canales de ventas que no incluyas usan el host de la tienda del propio pedido. Las tiendas que dejan el campo vacío mantienen el comportamiento actual.
Delay To Cancel
Cuánto espera VTEX un pago pendiente, por método de pago, antes de cancelar el pedido.- Obligatorio: No
- Valor predeterminado: la ventana de cada método de pago, indicada en Cuánto espera VTEX un pago pendiente
- Disponible en el plugin: 4.2.373 o posterior; el par
Pix4.2.379 o posterior
- Escribe pares
Method=secondsseparados por;. También se aceptan una,entre pares y:entre el nombre y los segundos. Methodes el nombre del método de pago tal como aparece cuando creas una condición de pago en VTEX (por ejemploMastercard,MercadoPagoProoPagaleve Transparente), no el nombre que le das a la condición. La lista completa está en Métodos de pago que puedes definir en Delay To Cancel.- Los nombres se comparan sin distinguir mayúsculas de minúsculas, pero los acentos deben coincidir, como en
Elo Débito. Cardsse aplica a todas las marcas de tarjeta, y el par propio de una marca tiene prioridad sobreCards.- Los segundos deben ser un número entero entre
600(10 minutos) y2592000(30 días). Un par fuera de ese rango, o mal formado, se ignora y el método mantiene su valor predeterminado. - Las tarjetas y los métodos que renderiza Yuno (Apple Pay, Google Pay, Samsung Pay, Click to Pay) nunca esperan menos de una hora: un valor menor se convierte en una hora.
- Para las tarjetas, el valor también reemplaza la ventana de 3 días de un pago con tarjeta que ya existe y sigue pendiente (revisión antifraude o desafío de la tarjeta). Por lo tanto, un valor corto cancela revisiones que se habrían aprobado más tarde.
Pixdefine la ventana de PIX en el checkout con Payment App, dentro de los límites de PIX de VTEX de 15 minutos a 1 hora. De900a3600el valor se usa tal como se escribe, de600a899se convierte en 15 minutos, y por encima de3600se convierte en 1 hora. Sin un parPix, o con un valor menor que600, que se ignora como cualquier otro par, la ventana es de 1 hora.- Boleto Bancário no se puede configurar: sigue su fecha de vencimiento.
- En el handoff de pago headless, desde el plugin 4.2.376, PIX siempre espera 15 minutos, cuando vence su código QR, y las tarjetas esperan según el par
Cardso el de la marca (al menos 1 hora) o 24 horas si no hay ninguno.
Vencimiento del código QR de PIX
En el checkout con Payment App, el plugin le pide al proveedor un código QR de PIX que vence con la ventana de PIX, de modo que el código QR deja de poder pagarse cuando VTEX cancela el pedido sin pagar. Que el proveedor respete ese vencimiento determina qué debes configurar.
El checkout con redirección (Legacy) y Pagaleve Pix A Vista no usan la ventana de PIX: el código QR conserva el vencimiento de la conexión, por lo que allí se aplica la misma regla de 60 minutos.
Cuánto espera VTEX un pago pendiente
Sin el campo Delay To Cancel, cada método de pago usa la ventana de abajo en el plugin 4.2.372 o posterior. Las versiones anteriores esperaban hasta 24 horas para las billeteras, y algunas respuestas pendientes no traían ninguna ventana. El campo reemplaza la ventana de todos los métodos excepto Boleto Bancário; el parPix se aplica solo en el checkout con Payment App.
En el checkout con redirección (Legacy) los valores predeterminados son distintos: PIX, PicPay, MercadoPagoPro y Nubank esperan 1 hora, y todos los demás métodos, boleto incluido, 24 horas. Desde el plugin 4.2.376, el handoff de pago headless espera 15 minutos para PIX y 24 horas para las tarjetas.
Métodos de pago que puedes definir en Delay To Cancel
Escribe el nombre exactamente como lo muestra VTEX cuando creas la condición de pago. No importan las mayúsculas y minúsculas; los acentos y los espacios sí. Un valor menor que la espera más corta de su grupo se eleva a esa espera, y un valor dePix mayor que 1 hora se reduce a 1 hora.