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

# Proceso de migración de network tokens

> Explica los pasos y requisitos para migrar network tokens de un proveedor al vault de Yuno.

La migración de Network Tokens es el proceso de transferir `network_tokens` de un proveedor existente al vault seguro de Yuno. Durante este proceso, se genera un nuevo token por cada `network_token`, lo que garantiza continuidad y seguridad en el procesamiento de pagos. El proceso de migración de `network_token` consta de tres pasos principales:

1. El comercio solicita el proceso de migración de `network_token` a su procesador de pagos actual.
2. Yuno y el proveedor de pagos colaboran para importar de forma segura todos los datos de `network_token` al vault de Yuno.
3. El comercio usa la API de migración de tokens de Yuno para mapear los `network_tokens` del proveedor de pagos a los `network_vaulted_tokens` de Yuno.

> [!NOTE]
>
> **Primer paso**
>
> Para iniciar el proceso de migración de `network_token`, contacta a tu asesor comercial en Yuno para evaluar la viabilidad y el cronograma del procedimiento.

## Importar network tokens desde una cuenta de gateway (pasos 1 y 2)

Importar datos de `network_token` desde una cuenta de gateway implica manejar información sensible, por lo que se deben seguir protocolos de seguridad estrictos. Para importar datos de `network_token` a Yuno desde un gateway existente, completa los siguientes pasos:

1. **Coordina con el gateway actual**: Contacta a tu vault de terceros o gateway actual y solicita una exportación de los datos del método de pago. Asegúrate de seguir los protocolos que te indiquen.
2. **Completa la solicitud formal**: Envía una solicitud formal a Yuno, asegurándote de que todos los detalles y procesos requeridos estén documentados. El tiempo de respuesta y los procedimientos del gateway determinarán el proceso de transferencia de datos.

> [!WARNING]
>
> **Tus responsabilidades al migrar tokens**
>
> Eres responsable de gestionar la comunicación con tu proveedor de gateway durante todo el proceso de migración. El equipo de Yuno brindará soporte y colaborará directamente con el vault o gateway de terceros para facilitar el proceso de importación. Además, la información de suscripción del cliente, incluidos los montos, las fechas, etc., debe obtenerse directamente de la entidad que exporta, ya que Yuno no extraerá estos datos de los archivos cifrados.

> [!NOTE]
>
> **Seguridad de la transferencia de datos**
>
> Todos los datos durante el proceso de migración se cifran con claves PGP y se transfieren mediante SFTP (Secure File Transfer Protocol).

## Requisitos del lado del cliente (paso 3)

Para completar con éxito el proceso de migración de network tokens, es esencial cumplir los requisitos del lado del cliente descritos en el paso 3. Esto implica proporcionar los datos de usuario necesarios, incluidos los compradores y sus métodos de pago existentes.

Puedes ejecutar el proceso de migración de tokens con la API de Yuno, diseñada específicamente para comercios. Como comercio, usarás esta API para:

1. **Agregar clientes**: Registrar clientes en el sistema de Yuno.
2. **Inscribir métodos de pago**: Registrar los métodos de pago obtenidos de los procesadores de pago para cada cliente en el sistema de Yuno.

Para ver una guía detallada sobre cómo realizar la migración de tokens mediante la API, haz clic en el botón de abajo:

> [card] [Migración de tokens mediante API](https://docs.y.uno/es/docs/security-and-compliance/data-migration-processes/via-api.md)

## Requisitos para el gateway y el proveedor de pagos

Para continuar con el proceso de migración, deberás proporcionar lo siguiente:

* Una clave SSH pública (puedes proporcionar una para producción y otra para pruebas). Puedes usar el siguiente comando para generarla: `ssh-keygen -t rsa -b 4096 -C your_email@example.com`
* Las IP de salida que se usarán durante la migración.
* Un archivo de plantilla con los datos que se van a migrar para entender su estructura. Debe incluir los siguientes datos obligatorios:
  * **Cardholder name**: El nombre completo del titular de la tarjeta tal como lo almacena el proveedor actual.
  * **Expiration date**: La fecha de vencimiento del token.
  * **Network token number**: El número completo del network token que Yuno tokenizará.
  * **FPAN/Card LDF**: Los últimos cuatro dígitos del FPAN asociado a la tarjeta vinculada al network token.
  * **Network token transaction ID**: Identificador único asignado por la red de tarjetas a una transacción específica realizada con un network token.
  * **Parent payment method type**: El instrumento de financiamiento subyacente del que se origina un network token (como Apple Pay, Google Pay).
  * **Provider network token**: Identificador único asignado a cada network token por el proveedor actual, que el cliente usa para referenciar ese network token durante las transacciones.

> [!WARNING]
>
> **Aviso importante**
>
> En caso de migrar varios tipos de método de pago principal, es obligatorio enviar sus `network_tokens` correspondientes en archivos distintos.

### Clave pública PGP

Usa nuestra clave pública para cifrar los archivos sensibles para PCI que envíes a Yuno. Yuno usa la misma clave pública para cada gateway y proveedor de pagos, y la publica en esta página para que puedas obtenerla desde el sitio oficial de Yuno.

Antes de cifrar un archivo, confirma que el fingerprint de la clave descargada coincida con el fingerprint de la siguiente tabla:

```bash theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
gpg --show-keys --with-fingerprint generic-pgp-keys_public_key_production.asc
```

| Propiedad | Valor |
| - | - |
| Email | [security-migrations@y.uno](mailto:security-migrations@y.uno) |
| Comentario | Para cifrar datos sensibles. Entorno: producción |
| Creada | 22 Nov 2024 |
| Vence | 22 Nov 2026 |
| ID de clave | 73D3D88A |
| Longitud | 4096 |
| Algoritmo | RSA |
| Fingerprint | 5160 7134 4C00 D270 93FB C450 19ED AACD 73D3 D88A |

> [card] [Clave PGP pública](https://yuno-public-keys.prod.y.uno/generic-pgp-keys_public_key_production.asc)

***

> [accordion] Clave de producción
>
> ```
> -----BEGIN PGP PUBLIC KEY BLOCK-----
>
> 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
> sNugHSYrj1RUuA==
> =ik2s
> -----END PGP PUBLIC KEY BLOCK-----
>
> ```


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