vaulted_token que hace referencia a los datos de pago sin exponer información sensible. Esto habilita pagos recurrentes, suscripciones y reintentos entre proveedores, manteniendo el cumplimiento de PCI.
Vaulted TokenUn Vaulted Token se crea una vez que se inscribe un método de pago y se almacena con la información del cliente. Puedes usar el Vaulted Token creado para identificar el método de pago en pagos futuros.
Métodos de pago disponibles para la inscripción
(*) Solo SDK. Consulta la documentación del SDK para conocer los detalles de integración.
(**) Solo Web SDK. Consulta la documentación de inscripción de Lite Web para conocer los detalles de integración.
Requisitos
- Reúne tus credenciales de API desde el Yuno Dashboard:
public-api-keyprivate-secret-keyaccount_id
- Configura conexiones en tu Yuno Dashboard. Agrega un método de pago que requiera inscripción.
- Crea una ruta para el método de pago y define cómo se procesará.
- Configura el checkout builder para que tus pagos conectados estén disponibles.
Resumen de pasos
Para inscribir un método de pago en la cuenta de un cliente:- Crea un cliente
- Crea una sesión de cliente (solo para el flujo de Checkout)
- (Opcional) Obtén los métodos de pago disponibles para inscribir - Flujo de Checkout
- Inscribe el método de pago Flujo de Checkout/Flujo Direct
- Obtén los métodos de pago - Flujo Direct
Inscribir un método de pago
Paso 1: crea un cliente
Registra la información del cliente con el endpoint Create Customer. Además, proporciona elmerchant_customer_id, un identificador único del cliente usado en tu sistema.
Información complementaria del clienteLos detalles opcionales, como el teléfono, la dirección de facturación y la dirección de envío, no son necesarios para inscribir un método de pago, pero algunos proveedores los usan en las verificaciones de fraude. Si incluyes estos campos, ciertos subcampos pasan a ser obligatorios.
id que lo identifica en Yuno. Si tu cliente ya tiene un id, omite este paso.
Paso 2: crea una sesión de cliente
Crea una sesión de cliente para almacenar las preferencias de pago del cliente con el endpoint Create Customer Session. Usa elid del Paso 1 como customer_id.
La respuesta devuelve un customer_session, que usarás para inscribir el método de pago.
Paso 3: obtén los métodos de pago para inscribir
Este paso opcional muestra todos los métodos de pago disponibles que el cliente puede inscribir. Si ya sabes qué método de pago inscribir, continúa con el Paso 4. Para listar los métodos de pago disponibles, usa el endpoint Retrieve Payment Methods To Enroll. Para el flujo de Checkout, incluye elcustomer_session en la solicitud. El flujo Direct actualmente no admite obtener los métodos de pago para inscribir.
La respuesta devuelve un arreglo payment_methods con todos los métodos de pago disponibles para inscribir. Usa el campo type de esta respuesta en el siguiente paso.
Métodos de pago disponiblesSolo aparecerán en la respuesta los métodos de pago que hayas conectado, enrutado y agregado a tu checkout.
Paso 4: inscribe un método de pago
Inscribe el método de pago con uno de los siguientes endpoints:- Flujo de Checkout: pasa el
typedel método de pago al parámetropayment_method_type. Los tipos admitidos son:CARD,NU_PAY_ENROLLMENT,PAYPAL_ENROLLMENT,DAVIPLATA_ENROLLMENT,WALLET_CONNECT,YAPE_ENROLLMENT,SMART_PIX,ASTROPAY_ENROLLABLE,PIX_BIOMETRICO. - Flujo Direct: pasa el
typedel método de pago al parámetrotype. (Solo disponible para métodos de pagoCARDusados por comercios que cumplen con PCI) - Flujo de SDK: métodos de pago como
NEQUIyBANCOLOMBIA_TOKENBOXrequieren una implementación con SDK.WALLET_CONNECT(MercadoPago) admite tanto el flujo de SDK como el de Checkout.
Paso 5: obtén los métodos de pago
El cliente debe dar su autorización en la página del proveedor de pago. Obtén la URL de autorización según tu flujo:- Flujo de Checkout: la URL de inscripción aparece en la respuesta de la inscripción del Paso 4. Encuéntrala en
provider.redirect.init_url. - Flujo Direct: recibirás el estado final en el Paso 4 (solo Cards).
status sea ENROLLED.
Los instrumentos almacenados mediante billeteras no se listanLos instrumentos almacenados en el vault mediante un pago con billetera (Apple Pay / Google Pay con
vault_on_success: true) se guardan como registros ocultos: no aparecen en el listado de métodos de pago inscritos, aunque su vaulted_token es válido y se puede cobrar. Guarda ese token de la respuesta del pago y, si lo necesitas, resuélvelo individualmente con Retrieve Enrolled Payment Method by ID. Consulta Credenciales almacenadas.FingerprintCuando se inscribe una tarjeta de crédito, la respuesta incluye un campo
fingerprint que representa la tarjeta de tu cliente en toda tu organización. Si un cliente inscribe la misma tarjeta varias veces, se generan varios valores de vaulted_token, pero el fingerprint se mantiene igual, lo que te permite deduplicar de tu lado. Consulta Fingerprint de la tarjeta.El fingerprint está disponible después de la inscripción, pero puede ser null para algunos proveedores. Verifica siempre que exista antes de usarlo para deduplicar.El fingerprint también aparece en las respuestas de pago cuando una transacción usa una tarjeta de crédito inscrita.