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

# Inscribe tarjetas con enlaces de pago

> Genera un enlace de pago para que los clientes actualicen una tarjeta vencida o rechazada y se vuelvan a inscribir automáticamente

Yuno ofrece a los comercios la posibilidad de gestionar pagos vencidos o rechazados mediante enlaces de pago seguros. Cuando una tarjeta de crédito vence o se reporta como robada o perdida, puedes generar un enlace de pago para compartirlo con los clientes por email o mensaje de texto, de modo que puedan actualizar fácilmente su información de pago.

Esta función está pensada para los comercios que operan su propio motor de suscripciones y necesitan actualizar los datos de la tarjeta de crédito para seguir procesando pagos con un nuevo `vaulted_token` para sus clientes.

## Cómo funciona

### Recepción del enlace de pago

Cuando los usuarios necesitan actualizar su información de pago, reciben un enlace de pago seguro. Este enlace les permite completar cualquier pago pendiente con una tarjeta de crédito o débito. Para crear el enlace de pago para la inscripción, asegúrate de incluir los siguientes campos:

* `customer_payer.id`: el ID del [cliente generado](https://docs.y.uno/reference/customers/create-customer.md) previamente
* `one_time_use`: configúralo en `true` para asegurar que el enlace de pago solo pueda usarse una vez
* `vault_on_success`: configúralo en `true` para inscribir la tarjeta de crédito después de un pago exitoso

### Inscripción automática

Una vez que el pago se completa correctamente mediante el enlace, Yuno genera automáticamente un nuevo `vaulted_token` para el cliente.

### Continúa cobrando

Después de obtener el `vaulted_token`, puedes continuar con tu calendario de suscripciones. Usa el endpoint [Get payment methods](https://docs.y.uno/reference/payment-methods-direct-workflow/retrieve-enrolled-payment-methods-api.md) para acceder a los métodos de pago del cliente.

Para más información sobre cómo crear y gestionar enlaces de pago, consulta la [referencia de la API de enlaces de pago](https://docs.y.uno/reference/payment-links/create-payment-link.md).


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