> ## 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.

# Samsung Pay

> Integra Samsung Pay en Yuno mediante el Web SDK o mediante el plugin de VTEX.

Samsung Pay es la billetera digital de Samsung que permite a los clientes pagar con las tarjetas guardadas en sus dispositivos Samsung, y confirmar cada pago con la seguridad de nivel militar de Samsung (huella digital, PIN o escaneo de iris). Samsung Pay funciona en dispositivos Samsung Galaxy compatibles y en algunos otros teléfonos Android, y usa NFC para pagos sin contacto o MST (Magnetic Secure Transmission) en dispositivos más antiguos.

## Integración con el SDK

Samsung Pay está disponible como botón de billetera exprés en el **Web SDK** (desde el SDK 1.6). Cuando un comprador toca el botón de Samsung Pay, el SDK carga el Web Checkout SDK de Samsung, abre la hoja de pago de Samsung y envía a Yuno la credencial de pago tokenizada para su autorización.

Samsung Pay se habilita cuando tienes en el dashboard de Yuno una conexión con un proveedor de pago que lo admita y una regla de enrutamiento que lo incluya. Luego, el Web SDK lo detecta automáticamente según la configuración de tu dashboard, por lo que no se necesita ninguna configuración adicional del lado del SDK para mostrar el botón.

### Integración con el Web SDK

El Web SDK carga el Web Checkout SDK de Samsung y muestra el botón exprés con la marca. Para montar el botón en tu propio contenedor, usa [`mountExternalButtons`](https://docs.y.uno/docs/sdks/resources/references/web#mount-external-buttons) *(Web SDK 1.10.0+)*:

```javascript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
await yuno.mountExternalButtons([
  { paymentMethodType: 'SAMSUNG_PAY', elementSelector: '#samsung-pay' },
])
```

> [!NOTE]
>
> **Localización al portugués (Web SDK 1.10.9+)**
> Para el portugués de Brasil (`pt` / `pt-BR`), el Web SDK entrega automáticamente un recurso del botón de Samsung Pay localizado, para que los compradores vean el texto de la marca en portugués.

Samsung Pay admite planes de cuotas mediante el endpoint [Create Installments Plan](https://docs.y.uno/reference/installments/create-installments-plan.md) con `payment_method_type: SAMSUNG_PAY`. Los planes se limitan estrictamente al método de pago Samsung Pay: un plan creado para Samsung Pay solo se aplica cuando se selecciona Samsung Pay.

> [!NOTE]
>
> Las guías de integración para el **Android SDK** y la **Direct API** están en evaluación y se agregarán aquí cuando estén disponibles.

## VTEX

Si usas el plugin de VTEX, puedes ofrecer Samsung Pay mediante la **Wallet enhanced experience**. Esto brinda a los compradores un botón de Samsung Pay simplificado en el checkout de VTEX, con la hoja de confirmación nativa de Samsung Pay.

**1. Habilita Samsung Pay en tu tienda VTEX**

Sigue la [guía de Wallet enhanced experience](https://docs.y.uno/es/docs/plugins/vtex/apple-pay-google-pay-enhanced-experience.md) para configurar el snippet. Agrega `'Samsung Pay'` al arreglo `paymentMethods` junto con las demás billeteras.

**2. Configura las cuotas de Samsung Pay (opcional)**

Samsung Pay admite planes de cuotas en VTEX. Crea los planes desde el dashboard de Yuno con **Payment method type** configurado como **Samsung Pay**. La [sección de cuotas de Samsung Pay](https://docs.y.uno/es/docs/plugins/vtex/apple-pay-google-pay-enhanced-experience.md#samsung-pay-installments) de la guía de VTEX explica las pantallas de creación de planes, las reglas de elegibilidad y la salvedad sobre cómo VTEX muestra los pedidos (VTEX muestra los pedidos en cuotas como un único pago completo en el resumen del pedido).


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