# Protección del pago

> En cuatro pasos, indica quién puede recibir el dinero de la tienda, cómo debe reaccionar el SDK, qué es normal en el checkout y qué campos extra vigilar.

URL: https://docs.proteside.com/es/docs/guide/settings/payment-protection

**Ajustes → Protección del pago** define cómo se comporta el SDK en el checkout de la tienda seleccionada. La pantalla
está dividida en cuatro pasos numerados:

1. **Quién puede recibir tu dinero**: los destinatarios confiables.
2. **Cómo debe reaccionar el SDK**: monitorear o bloquear.
3. **Qué es normal en tu checkout**: proveedores de pago, contenedores GTM y service workers esperados.
4. **Medios de pago detectados**: lo que el SDK ya reconoció y los campos extra para vigilar.

Los cambios llegan a las páginas por la configuración remota del SDK, sin tocar el sitio, con una excepción: el
[canal de release](#canal-de-release-del-sdk). Los detalles técnicos están en
[Configuración del SDK](https://docs.proteside.com/es/docs/integration/configuration).

## Antes de empezar
* Solo los **propietarios** y **administradores** modifican esta pantalla. Los demás roles ven todo, pero sin los
  botones de edición, y la franja de la parte superior avisa "Solo propietarios y administradores pueden modificar
  estos ajustes."
* Los **destinatarios** (paso 1) se guardan al instante.
* Los pasos 2, 3 y 4 se guardan por separado. Cada uno tiene su propio botón **Guardar esta etapa** y muestra
  **Guardado** o **Modificado · sin guardar**. Guarda un paso antes de salir de la pantalla.
* Los cambios llegan al SDK en pocos minutos. Para probar un cambio, espera algunos minutos y recarga el checkout.
  Todo cambio guardado queda registrado en el [Registro de auditoría](https://docs.proteside.com/es/docs/guide/settings/audit-log).

## Quién puede recibir tu dinero
*Imagen: Cómo funciona la verificación (1), destinatarios vistos (2), destinatarios confiables (3) y registro manual (4).*

Los destinatarios confiables son las claves y cuentas que reciben los pagos de tu tienda. El SDK verifica el
destinatario de cada Pix, boleto, QR o billetera que aparece en el checkout y alerta cuando aparece alguien fuera de la
lista.

Sin ningún destinatario registrado, el SDK registra quién aparece en el checkout, pero no alerta sobre destinatarios
desconocidos. Por eso este es el paso más importante de la pantalla.

**Cómo funciona la verificación** (1) abre un resumen de cómo se verifica el destinatario en cada tipo de código.

### Confirma los destinatarios vistos en el checkout
La lista **Destinatarios vistos en tu checkout** (2) muestra los destinatarios que el SDK encontró en el checkout y que
todavía no confirmaste. Para cada uno ves el método, el destinatario enmascarado, cuántas veces se vio y cuándo.

* Haz clic en **Es de mi tienda** para incluirlo en la lista de destinatarios confiables.
* Haz clic en **No lo reconozco** si el destinatario no es tuyo. Esto abre una alerta crítica **Destinatario no
  reconocido** en [Alertas](https://docs.proteside.com/es/docs/guide/alerts). Trátala como un incidente.

Si la lista está vacía, haz un pedido de prueba en el checkout: el destinatario aparece enseguida.

> **Pix generado por un proveedor de pago**
>
> Cuando el Pix de la tienda lo genera un proveedor (Mercado Pago, Pagar.me, PagBank y otros), la clave que usa el
> código no suele ser la que conoces. En ese caso, mejor confirma lo que aparece en **Destinatarios vistos en tu
> checkout** en lugar de registrar la clave a mano.

### Destinatarios confiables
La tabla **Destinatarios confiables** (3) lista lo que ya está aprobado, con las columnas **Método**, **Destinatario**,
**Origen** (**Registro manual** o **Visto en el checkout**), **Etiqueta**, **Agregada el** y **Activa**.

* Usa el interruptor **Activa** para desactivar un destinatario sin borrarlo.
* Para eliminarlo, haz clic en el icono del bote de basura y confirma con **Eliminar** en la misma fila, o haz clic en
  **Cancelar**.

Proteside no guarda la clave en claro. Por eso no es posible ver ni editar la clave después de guardarla. Para
cambiarla, registra la nueva y elimina la anterior.

### Registrar manualmente
Usa **Registrar manualmente** (4) cuando conoces la clave o la cuenta que recibe.

#### Elige el método
Haz clic en **Registrar manualmente** para abrir el formulario y elige el **Método**: **Pix**, **Boleto**, **Billetera
cripto**, **UPI (India)**, **PayNow (Singapur)**, **PromptPay (Tailandia)**, **DuitNow (Malasia)**, **QR Ph
(Filipinas)**, **HK FPS (Hong Kong)** o **Transferencias 3.0 (Argentina)**.

#### Ingresa la clave
El campo **Clave** muestra debajo el formato aceptado para el método elegido. Algunos ejemplos:

* **Pix:** CPF, CNPJ, correo, teléfono (`+55…`) o clave aleatoria.
* **Boleto:** pega la línea digitable de un boleto emitido por la tienda.
* **Billetera cripto:** pega la dirección de la billetera. No hace falta elegir la moneda: la pantalla muestra **Red
  detectada** con la red reconocida por el formato de la dirección.
* **UPI:** VPA con el formato `nombre@banco`.

Si quieres, completa una **Etiqueta** (hasta 80 caracteres), por ejemplo "cuenta principal".

#### Haz clic en Agregar
El destinatario se guarda al instante y aparece en la tabla con la clave enmascarada y el origen **Registro manual**.

También puedes llegar aquí con el botón **Registrar** de la pantalla [Integridad de Pagos](https://docs.proteside.com/es/docs/guide/payment-integrity).
En los métodos que aceptan registro manual, el formulario ya abre en el método correcto. En Pix, la pantalla te orienta
a confirmar lo que aparece en **Destinatarios vistos en tu checkout**. Cómo funciona la verificación en el checkout está
en [Destinatarios confiables](https://docs.proteside.com/es/docs/integration/payment-integrity#destinatarios-confiables-pix-key-pinning).

## Cómo debe reaccionar el SDK
*Imagen: Modo de protección (1), nota de las Reglas (2), opciones para el equipo técnico (3) y Guardar esta etapa (4).*

Elige una de las tarjetas (1). La tarjeta en uso muestra **Estás aquí**.

| Modo                                                 | Qué ocurre                                                                                                                                                                  |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Monitorear** (recomendado en las primeras semanas) | El SDK detecta y genera alertas, sin tocar la página.                                                                                                                       |
| **Bloquear**                                         | Además de alertar, el SDK reacciona solo y deshace la manipulación en la página, por ejemplo quitando un script desconocido inyectado o restaurando el código Pix original. |

Algunas detecciones solo generan una alerta, en los dos modos. Consulta
[Modo monitoreo y modo bloqueo](https://docs.proteside.com/es/docs/integration/configuration#modo-monitoreo-y-modo-bloqueo).

La nota debajo de las tarjetas (2) recuerda que las [Reglas](https://docs.proteside.com/es/docs/guide/rules) valen en los dos modos: un script con regla
de bloqueo se detiene incluso en **Monitorear**. El modo solo decide las reacciones automáticas del SDK ante lo que no
tiene regla. **Abrir Reglas** lleva a la pantalla de reglas.

> **Prueba antes de activar Bloquear**
>
> En el modo **Bloquear**, una regla incorrecta puede romper el checkout. Quédate algunas semanas en **Monitorear**,
> revisa las alertas y los scripts, y prueba **Bloquear** en una página de poco tráfico antes de activarlo.

### Opciones para el equipo técnico
El bloque plegado **Opciones para el equipo técnico** (3) reúne dos ajustes de integración.

#### Modo desarrollador
El **Modo desarrollador** pausa el SDK: envía solo un registro de visita y no ejecuta ninguna protección. Úsalo durante
las integraciones y las pruebas.

> **No olvides desactivarlo**
>
> Con el modo desarrollador activado, la tienda queda **sin protección** y la [Salud del SDK](https://docs.proteside.com/es/docs/guide/sdk-health)
> muestra el SDK en pausa. Las reglas de bloqueo guardadas en el snippet siguen valiendo, pero sin generar ningún evento
> en el panel.

#### Canal de release del SDK
El **Canal de release del SDK** elige qué versión del SDK carga la tienda:

* `stable` (predeterminado): versión validada.
* `latest`: la publicación más reciente, para probar novedades antes.

> **Cambiar el canal exige volver a pegar el snippet**
>
> La pantalla dice que no es necesario reinstalar. Pero el canal está escrito en la dirección del SDK dentro del
> snippet: el snippet ya publicado sigue cargando el canal anterior. Después de cambiar el canal y guardar, copia el
> snippet de nuevo en [Páginas y Dominios](https://docs.proteside.com/es/docs/guide/settings/pages#copiar-el-snippet) y publícalo.

### Guardar el paso 2
Después de elegir el modo y ajustar las opciones, haz clic en **Guardar esta etapa** (4).

## Qué es normal en tu checkout
*Imagen: Orígenes de iframe y sugerencias (1), contenedores GTM (2), service workers (3), medios detectados (4), campos extra (5) y Guardar esta etapa (6).*

En el paso 3, dile al SDK qué proveedores de pago y herramientas forman parte del checkout. Lo que aparezca fuera de
las listas se convierte en alerta. **Una lista vacía significa que no hay ninguna restricción** para ese elemento. Al
terminar, haz clic en **Guardar esta etapa** del paso 3.

### Orígenes de iframe esperados
Hosts de los iframes de pago legítimos, como el de tu proveedor de pago y el de la autenticación 3DS (1). Con la lista
completa, el SDK alerta sobre los iframes de proveedores que no están en ella dentro del checkout.

* Escribe el host (por ejemplo `checkout.psp.com`) y haz clic en **Agregar** o presiona Enter. Si pegas una URL
  completa, solo se usa el host. Usa `*.` para incluir subdominios.
* En **Sugerencias (PSPs del catálogo)**, haz clic en un proveedor para incluirlo. Las sugerencias dan prioridad a los
  proveedores del país de la tienda, definido en [Tienda](https://docs.proteside.com/es/docs/guide/settings/store#pa%C3%ADs-y-zona-horaria). Usa la búsqueda o **Ver
  todos** para encontrar otros.
* Hasta 50 hosts.

### Contenedores GTM permitidos
IDs de Google Tag Manager autorizados, con el formato `GTM-XXXXXXX` (2). Con la lista completa, los contenedores que
no están en ella se bloquean en el checkout. Hasta 20 contenedores.

> **La lista de GTM bloquea en los dos modos**
>
> La pantalla habla de bloqueo en el modo **Bloquear**, pero, con la lista completa, los contenedores que no están en
> ella también se detienen en **Monitorear**. Las etiquetas de Google Analytics 4 (`G-…`) y de Google Ads (`AW-…`)
> cargadas por JavaScript, incluso por el propio GTM, también se bloquean, y no hay forma de incluirlas en la lista.
> Antes de completarla, confirma con quien se encarga del marketing si la tienda usa esas etiquetas en el checkout.
> Recuerda también volver a pegar el snippet: guarda una copia de esta lista.

### Service workers permitidos
Está en el bloque plegado **Service workers permitidos (avanzado)** (3). Ingresa las rutas de los service workers
legítimos del sitio, como `/sw.js`. La ruta empieza con `/` y no tiene espacios. Con la lista completa, un service
worker que no está en ella genera una alerta y, en el modo **Bloquear**, se quita. Hasta 20 rutas.

## Medios de pago detectados
En el paso 4 no hay métodos para marcar: el SDK reconoce solo los medios de pago leyendo la página del checkout.

* **Medios de pago detectados** (4) muestra cada medio como **Visto en el checkout** o **Aún no visto**. Es solo de
  lectura. **Ver integridad de pago** abre [Integridad de Pagos](https://docs.proteside.com/es/docs/guide/payment-integrity).
* **Campos extra para vigilar** (5): el SDK ya reconoce solo los campos de tarjeta, Pix y datos personales. Usa
  **Selectores extra (opcional)** solo para campos de tu tienda con nombres fuera del estándar, un selector CSS por
  línea. Lo que agregues se **suma** a la detección automática; nada se desactiva. Déjalo vacío si tus campos siguen el
  estándar.

Haz clic en **Guardar esta etapa** (6) para guardar los selectores.

## Aviso de orden de instalación
El aviso de que el snippet no es el primer script del `<head>` no se configura en esta pantalla. Si tu plataforma no
permite colocar el snippet arriba de todo, usa **No avisar más en esta tienda** en la propia alerta. Consulta
[Alertas](https://docs.proteside.com/es/docs/guide/alerts#detener-el-aviso-de-orden-de-instalaci%C3%B3n).

## Próximos pasos
- [Configuración del SDK](https://docs.proteside.com/es/docs/integration/configuration): El efecto de cada ajuste en el navegador, en detalle.
- [Integridad de pagos y Pix](https://docs.proteside.com/es/docs/integration/payment-integrity): Cómo el SDK valida códigos Pix, boletos y direcciones cripto.
