Cobertura de tokenización de Yuno
La plataforma de tokenización de Yuno no se limita a las tarjetas. Se emiten tokens para cualquier método de pago que fluya por Yuno, incluidos:- Tarjetas de crédito y débito
- Billeteras digitales como Apple Pay, Google Pay y Click to Pay
- Transferencias bancarias y métodos de pago locales, incluidos ACH, PIX y alternativas regionales
- Métodos de pago alternativos para compra ahora, paga después, vouchers y más
Tipos de token
Yuno emite tres tipos de tokens, cada uno adecuado para un escenario de integración distinto.Token de un solo uso
Cuando usas el Yuno SDK, toda la información de pago necesaria se recopila y se almacena en un token de un solo uso asociado a una única sesión de checkout. Este token se usa una vez al crear el pago y no se puede reutilizar. Los tokens de un solo uso son la opción adecuada para:- Checkouts de invitados sin método de pago almacenado
- Transacciones de un solo uso en las que no se requiere almacenar en el vault
Almacenar en el vault si el pago es exitosoEstablece
vault_on_success: true en la solicitud del token, o payment_method.vault_on_success: true en el pago, para inscribir y almacenar automáticamente el método de pago en el vault si el pago es exitoso. Esto convierte un token de un solo uso en un token almacenado persistente sin un paso de inscripción por separado.Token almacenado
Un token almacenado se crea cuando un método de pago se inscribe y se guarda de forma segura en el vault centralizado de Yuno junto con la información del cliente. Puedes usar el token almacenado para autorizar pagos futuros sin que el cliente tenga que volver a ingresar sus datos. Los tokens almacenados son la opción adecuada para:- Clientes recurrentes con métodos de pago guardados
- Suscripciones y facturación recurrente
- Flujos de checkout con un solo clic
Token de red
Un token de red es una representación digitalizada del número de cuenta principal (PAN) de una tarjeta. Lo emiten directamente las redes de tarjetas, como Visa, Mastercard o American Express. Cuando la tokenización de red está habilitada, Yuno aprovisiona y gestiona automáticamente tokens de red para todas las tarjetas inscritas. Estos tokens reemplazan los datos reales de la tarjeta durante la autorización. Los tokens de red son la opción adecuada para:- Transacciones recurrentes de alto valor en las que importa maximizar las tasas de autorización
- Escenarios que requieren mayor protección contra el fraude a nivel de la red
Más informaciónPara una descripción completa de los tokens de red, sus estados del ciclo de vida y las opciones de integración, consulta Tokens de red.
Token del proveedor
Algunos métodos de pago se autorizan en el proveedor, como una autorización de Pix Automático con EBANX. El proveedor identifica esa autorización con su propia referencia, el token del proveedor. Yuno lo almacena dentro del método de pago guardado del cliente en el vault, por lo que tu integración nunca lo maneja: cobras con elvaulted_token y Yuno envía el token del proveedor junto con el pago. Solo el proveedor que lo emitió puede usarlo, por lo que debes enrutar a ese proveedor los pagos hechos con ese vaulted_token; Yuno lo envía al proveedor que seleccione tu enrutamiento.
Guardar un método de pago al pagar
Para Pix con EBANX, la autorización se crea durante el primer pago: envíapayment_method.vault_on_success: true en ese pago. Yuno almacena el token del proveedor y guarda el método de pago para el cliente:
- Primer pago (iniciado por el cliente): crea el pago con el cliente (
customer_payer.id),payment_method.vault_on_success: truey un bloquesubscriptionque describa la autorización. El cliente la aprueba fuera de tu página. - El token almacenado: el método de pago guardado aparece en Consultar métodos de pago inscritos en cuanto se crea el pago, y su token está en
transactions[].payment_method.vaulted_tokenen Consultar pago una vez que el pago llega aSUCCEEDED. No está en la respuesta de creación. Cóbralo solo después de que el cliente lo apruebe: antes de eso, los cobros se rechazan. - Pagos posteriores (iniciados por el comercio): envía
payment_method.vaulted_token. Yuno cobra la autorización almacenada sin una nueva aprobación del cliente. - Checkout: los clientes recurrentes ven el Pix guardado en el checkout del SDK y pueden pagar con un solo clic, cuando creas la sesión de checkout con su
customer_id.
type: "CARD", provider_data.token_source: "PROVIDER_TOKEN", el proveedor en provider_data.id, la conexión en provider_data.connection_id y la referencia del proveedor en provider_data.payment_method_token. Yuno devuelve un vaulted_token que usas de la misma forma.
Para un ejemplo completo, consulta Pix con almacenamiento en el vault si el pago es exitoso.
Comparación de tokens
Capacidades adicionales de tokenización
Huella digital de tarjeta
Cada tarjeta inscrita a través de Yuno recibe unfingerprint, un identificador criptográfico estable derivado del PAN. Las huellas digitales se mantienen constantes entre varias inscripciones de la misma tarjeta. Esto te permite detectar duplicados y deduplicar tu vault sin acceder nunca a números de tarjeta en bruto ni almacenarlos. Consulta Huella digital de tarjeta.