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

# El objeto enlace de pago

> Describe los atributos devueltos en un objeto enlace de pago, incluidos los datos del cliente y del monto

## Atributos

Este objeto representa un enlace de pago que se puede asociar con un cliente.

**id** `string`

El identificador único del enlace de pago (MAX 64; MIN 36).

Ejemplo: 8546df3a-b83e-4bb5-a4b3-57aa6385924f

**account\_id** `string`

El identificador único de la cuenta (MAX 64; MIN 36).

Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b

**description** `string`

La descripción del enlace de pago (MAX 255; MIN 3).

Ejemplo: Marketplace payment

**country** `enum`

País donde se debe procesar la transacción (MAX 2; MIN 2; [ISO 3166-1](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**status** `enum`

El estado del enlace de pago (MAX 255; MIN 3) (CREATED, USED, CANCELED, EXPIRED, ERROR).

Ejemplo: CREATED

**merchant\_order\_id** `string`

Identificación del enlace de pago (MAX 255; MIN 3).

Ejemplo: 432245

**created\_at** `timestamp`

La fecha y hora en que se creó el enlace de pago.

Ejemplo: 2022-05-09T20:46:54.786342Z

**updated\_at** `timestamp`

La fecha y hora de la última actualización del enlace de pago.

Ejemplo: 2022-05-09T20:46:54.786342Z

**capture** `boolean`

Decide si se autoriza el pago o se captura. Autorizar un pago con tarjeta permite reservar
fondos en la cuenta bancaria de un cliente. Si no se envía el campo, se tomará como true. Más adelante puedes capturar el
pago desde el dashboard de Yuno o con el [método de la API](https://docs.y.uno/es/reference/payments/capture-authorization.md) .

Ejemplo: true

**amount** `object`

Especifica el objeto del monto del pago, con el valor y la moneda.

**propiedades**

**currency** `enum`

La moneda utilizada para realizar el pago (MAX 3; MIN 3; [ISO 4217](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**value** `number`

El monto del pago (múltiplo de 0.0001).

Ejemplo: 12100.00

**customer\_payer** `object`

Especifica el objeto cliente para los enlaces de pago.

**propiedades**

**id** `string`

El identificador único del cliente en la
plataforma de Yuno (MAX 255; MIN 3).

Ejemplo: faa89e18-5a11-11ed-9b6a-0242ac120002

**customer\_id** `string`

El identificador único del cliente en el comercio externo (MAX 255; MIN 3).

Ejemplo: 23456

**first\_name** `string`

El nombre del cliente (MAX 255; MIN 3).

Ejemplo: John

**last\_name** `string`

El apellido del cliente (MAX 255; MIN 3).

Ejemplo: Doe

**gender** `enum`

El género del cliente (MAX 2; MIN 1; (M=Masculino/F=Femenino/NA=No aplica/NK=No conocido)).

Valores posibles del enum: `M`, `F`, `NA` o `NK`.

**date\_of\_birth** `string`

La fecha de nacimiento del cliente en formato YYYY-MM-DD (Longitud: 10).

Ejemplo: 1990-02-28

**email** `string`

El email del cliente (MAX 255; MIN 3).

Ejemplo: [john.doe@email.com](mailto:john.doe@email.com)

**nationality** `enum`

La nacionalidad del cliente (MAX 2; MIN 2; [ISO 3166-1](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**document** `object`

Especifica el objeto de documento del cliente, incluido su número y tipo.

**propiedades**

**document\_number** `string`

El número de documento del cliente (MAX 40; MIN 3).

Ejemplo: 1093333333

**document\_type** `enum`

El tipo de documento del cliente (MAX 6, MIN 2).

Valores posibles del enum: Consulta la [
referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**phone** `object`

Especifica el objeto de teléfono del cliente, incluido el número y el código.

**propiedades**

**number** `string`

El número de teléfono del cliente (MAX 40; MIN 3).

Ejemplo: 11992149494

**country\_code** `string`

El código de llamada del país del teléfono del cliente (MAX 3; MIN 1)

Valores posibles: Consulta la [
referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**billing\_address** `object`

Especifica el objeto de dirección de facturación del cliente.

**propiedades**

**address\_line\_1** `string`

La línea principal de la dirección de facturación del cliente (MAX 255; MIN 3).

Ejemplo: Calle 34 # 56 - 78

**address\_line\_2** `string`

La línea secundaria de la dirección de facturación del cliente (MAX 255; MIN 3).

Ejemplo: Apartamento 502, Torre I

**city** `string`

La ciudad de la dirección de facturación (MAX 255; MIN 3).

Ejemplo: Bogotá

**country** `enum`

El país de la dirección de facturación (MAX 2; MIN 2; [ISO
3166-1](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**state** `string`

El estado considerado para la dirección de facturación (MAX 255; MIN 3).

Ejemplo: Cundinamarca

**zip\_code** `string`

El código postal de la dirección de facturación (MAX 11; MIN 4).

Ejemplo: 111111

**shipping\_address** `object`

Especifica el objeto de dirección de envío del cliente.

**propiedades**

**address\_line\_1** `string`

La línea principal de la dirección de envío del cliente (MAX 255; MIN 3).

Ejemplo: Calle 34 # 56 - 78

**address\_line\_2** `string`

La línea secundaria de la dirección de envío del cliente (MAX 255; MIN 3).

Ejemplo: Apartamento 502, Torre I

**city** `string`

La ciudad considerada para la dirección de envío (MAX 255; MIN 3).

Ejemplo: Bogotá

**country** `enum`

El país de la dirección de envío (MAX 2; MIN 2; [ISO
3166-1](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**state** `string`

El estado considerado para la dirección de envío (MAX 255; MIN 3).

Ejemplo: Cundinamarca

**zip\_code** `string`

El código postal considerado para la dirección de envío (MAX 11; MIN 4).

Ejemplo: 111111

**additional\_data** `object`

Especifica el objeto additional\_data. Este objeto no es obligatorio. Sin embargo, si envías esta información,
la experiencia de pago de tu usuario mejorará.

**propiedades**

**airline** `object`

Especifica el objeto aerolínea. Los pasajeros y los boletos deben tener la misma información de orden.

**propiedades**

**pnr** `string`

Registro de nombre del pasajero (MAX 10; MIN 1).

Ejemplo: 1P-2UUGJW

**legs** `array of object`

Especifica el arreglo de objetos de tramos.

**propiedades**

**arrival\_airport** `string`

Código IATA del aeropuerto (MAX 3; MIN 3). Consulta \[[http://www.iata.org](http://www.iata.org)]\([http://www.iata.org](http://www.iata.org)) .

Ejemplo: AMS

**base\_fare** `float`

El monto de la transacción, sin impuestos ni tarifas, en la unidad más pequeña de la moneda (múltiplo de
0.0001).

Ejemplo: 23.5676

**base\_fare\_currency** `string`

La moneda utilizada para el monto de la transacción (MAX 3; MIN 3; [ISO 4217](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**carrier\_code** `string`

Código IATA de la aerolínea (MAX 2; MIN 2). Consulta \[[http://www.iata.org](http://www.iata.org)]\([http://www.iata.org](http://www.iata.org)) .

Ejemplo: KL

**carrier\_name** `string`

El nombre de la aerolínea (MAX 100; MIN 1). Opcional.

Ejemplo: KLM Royal Dutch Airlines

**departure\_airport** `string`

Código IATA (MAX 3; MIN 3). Consulta \[[http://www.iata.org](http://www.iata.org)]\([http://www.iata.org](http://www.iata.org)) .

Ejemplo: EZE

**departure\_airport\_timezone** `string`

Zona horaria del aeropuerto (MAX 6; MIN 6).

Ejemplo: -03:00

**departure\_datetime** `timestamp`

La fecha y hora de salida en hora local del aeropuerto de salida.

Ejemplo: 2022-05-09T20:46:54.786342Z

**fare\_basis\_code** `string`

El código de tarifa base proporciona información específica sobre la tarifa, además de la clase de servicio, ambos
necesarios para la reserva (MAX 15; MIN 1).

Ejemplo: HL7LNR

**fare\_class\_code** `string`

El código de clase de tarifa de la aerolínea (MAX 1; MIN 1). Los valores pueden ser una letra (A-Z), pero pueden variar
según la definición de la aerolínea.

Ejemplo: C

**flight\_number** `string`

El número de vuelo asignado por la aerolínea (MAX 5; MIN 1).

Ejemplo: 842

**stopover\_code** `string`

El código de escala (código de 1 letra que indica si el pasajero puede hacer una
escala.
Solo se permiten dos tipos de caracteres: O: Escala permitida (la letra “O”, no cero) / X: Escala
no
permitida).

Ejemplo: O

**passengers** `array of objects`

Especifica el arreglo de objetos que representa a los pasajeros asociados a los boletos.

**propiedades**

**document** `object`

Especifica el objeto de documento del pasajero.

**propiedades**

**document\_number** `string`

El número de documento del pasajero (MAX 40; MIN 3).

Ejemplo: 1093333333

**document\_type** `enum`

El tipo de documento del pasajero (MAX 6, MIN 2).

Valores posibles del enum: Consulta la [
referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**country** `enum`

País donde se emitió el documento (MAX 2; MIN 2; [ISO
3166-1](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**date\_of\_birth** `string`

La fecha de nacimiento del pasajero en formato YYYY-MM-DD (MAX 10; MIN 10).

Ejemplo: 1990-02-28

**email** `string`

El email del pasajero (MAX 255; MIN 3).

Ejemplo: [John.Doe@gmail.com](mailto:John.Doe@gmail.com)

**first\_name** `string`

El nombre del pasajero (MAX 255; MIN 3).

Ejemplo: John

**last\_name** `string`

El apellido del pasajero (MAX 255; MIN 3).

Ejemplo: Doe

**loyalty\_number** `string`

Número del programa de fidelidad del pasajero (MAX 20, MIN 1).

Ejemplo: 254587547

**loyalty\_tier** `enum`

Nivel del programa de fidelidad del pasajero (MAX 255; MIN 3).

Valores posibles del enum: Consulta el [
nivel de lealtad](https://docs.y.uno/es/reference/airline-information.md).

**middle\_name** `string`

El segundo nombre del pasajero (MAX 255; MIN 3).

Ejemplo: Charles

**nationality** `enum`

La nacionalidad del pasajero (MAX 2; MIN 2; [ISO 3166-1](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**type** `enum`

El tipo de pasajero (MAX 1; MIN 1).

Valores posibles del enum: Consulta la [lista de tipos de pasajero](https://docs.y.uno/es/reference/airline-information.md).

**tickets** `array of objects`

Especifica el arreglo de boletos asociados a los pasajeros.

**propiedades**

**ticket\_number** `string`

Número de boleto (MAX 14; MIN 1).

Ejemplo: 7411823255523

**e\_ticket** `boolean`

¿Es un boleto electrónico?

Valores posibles: `True` o `False`

**restricted** `boolean`

Indica si el boleto es reembolsable o no.

Valores posibles: `True` o `False`

**total\_fare\_amount** `float`

Monto total de la tarifa en la unidad más pequeña de la moneda (múltiplo de 0.0001).

Ejemplo: 80000

**total\_tax\_amount** `float`

Monto total de los impuestos en la unidad más pequeña de la moneda (múltiplo de 0.0001).

Ejemplo: 14800

**total\_fee\_amount** `float`

Monto total de las comisiones en la unidad más pequeña de la moneda (múltiplo de 0.0001).

Ejemplo: 25200

**issue** `object`

Especifica el objeto de emisión.

**propiedades**

**address** `string`

Dirección del agente que vendió el boleto (MAX 255; MIN 3).

Ejemplo: Apartamento 502, Torre I

**carrier\_prefix\_code** `string`

Aerolínea emisora o validadora. Es el prefijo AWB (guía aérea) de 3 dígitos IATA (MAX
3; MIN
3\).

Ejemplo: 044

**city** `string`

Nombre de la ciudad del agente que vendió el boleto (MAX 255; MIN 3).

Ejemplo: Bogotá

**country** `enum`

Código del país donde se emitió el boleto (MAX 2; MIN 2; [ISO
3166-1](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [lista de códigos de
país](https://docs.y.uno/es/reference/country-reference.md).

**date** `string`

Fecha de emisión del boleto.

Ejemplo: 1979-01-12

**travel\_agent\_code** `string`

Código del agente de viajes que emite el boleto.

Ejemplo: 10655823

**travel\_agent\_name** `string`

El nombre con el que aparece el punto de venta en la lista de agencias o el nombre de la franquicia (MAX 32;
MIN
1\).

Ejemplo: ACME Agency Inc

**order** `object`

Especifica el objeto orden.

**propiedades**

**fee\_amount** `float`

El monto de la tarifa de la orden (múltiplo de 0.0001).

Ejemplo: 1

**shipping\_amount** `float`

El monto de envío de la orden (múltiplo de 0.0001).

Ejemplo: 1

**items** `array of object`

Especifica el objeto del ítem.

**propiedades**

**id** `string`

El identificador único del ítem (MAX 255; MIN 3).

Ejemplo: 3214

**name** `string`

El nombre del ítem (MAX 255; MIN 3).

Ejemplo: iPhone 12 Pro Max

**quantity** `int`

La cantidad del ítem (MAX 999; MIN 1).

Ejemplo: 1

**unit\_amount** `float`

El monto unitario del ítem (múltiplo de 0.0001).

Ejemplo: 550

**category** `string`

La categoría del ítem (MAX 255; MIN 3).

Valores posibles: Consulta la [lista de categorías de artículos](https://docs.y.uno/es/reference/items-category-list.md).

**brand** `string`

La marca del ítem (MAX 255; MIN 3).

Ejemplo: Apple

**sku\_code** `string`

La unidad de mantenimiento de stock (SKU) del ítem (MAX 255; MIN 3).

Ejemplo: A2342

**manufacture\_part\_number** `string`

El número de parte del fabricante del ítem (MAX 255; MIN 3).

Ejemplo: 345621234

**picture\_url** `string`

La imagen del artículo (MAX 255; MIN 3).

Ejemplo: https\://www\.merchant\_url.com/items/:id

**seller\_details** `object`

Especifica el objeto de detalles del vendedor.

**propiedades**

**name** `string`

Razón social del vendedor (MAX 255; MIN 3).

Ejemplo: John Doe

**email** `string`

Email del vendedor (MAX 255; MIN 3).

Ejemplo: [john.doe@business.com](mailto:john.doe@business.com)

**reference** `string`

El código de identificación del vendedor (MAX 255; MIN 3).

Ejemplo: Seller

**website** `string`

La URL del sitio web del vendedor (MAX 255; MIN 3).

Ejemplo: [https://www.test.com/1231324](https://www.test.com/1231324)

**industry** `enum`

El sector del vendedor (MAX 255; MIN 3).

Valores posibles del enum: Consulta la [categoría de sector](https://docs.y.uno/es/reference/industry-category-list.md).

**country** `enum`

El país del vendedor (MAX 255; MIN 3).

Valores posibles del enum: Consulta la [lista de códigos de país](https://docs.y.uno/es/reference/country-reference.md).

**document** `object`

Especifica el objeto documento del vendedor.

**propiedades**

**document\_number** `string`

El número de documento del vendedor (MAX 40; MIN 3).

Ejemplo: 1093333333

**document\_type** `enum`

El tipo de documento del vendedor (MAX 6, MIN 2).

Valores posibles del enum: Consulta la [
referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**phone** `object`

Especifica el objeto número de teléfono del vendedor.

**propiedades**

**country\_code** `string`

El código de llamada del país del teléfono del vendedor (MAX 3; MIN 1). Valores posibles: Consulta la [
referencia de países](https://docs.y.uno/es/reference/country-reference.md) .

Ejemplo: 57

**number** `string`

El número de teléfono del vendedor, sin el código de país (MAX 32; MIN 1).

Ejemplo: 3132450765

**address** `object`

Especifica el objeto dirección del vendedor.

**propiedades**

**address\_line\_1** `string`

La línea principal de la dirección del vendedor (MAX 255; MIN 3).

Ejemplo: Calle 34 # 56 - 78

**address\_line\_2** `string`

La línea secundaria de la dirección de facturación del vendedor (MAX 255; MIN 3).

Ejemplo: Apartamento 502, Torre I

**city** `string`

La ciudad de la dirección del vendedor (MAX 255; MIN 3).

Ejemplo: Bogotá

**country** `enum`

El país de la dirección del vendedor (MAX 2; MIN 2, [ISO
3166-1](https://docs.y.uno/es/reference/country-reference.md) ).

Valores posibles del enum: Consulta la [lista de códigos de
país](https://docs.y.uno/es/reference/country-reference.md).

**state** `string`

El estado de la dirección del vendedor (MAX 255; MIN 3).

Ejemplo: Cundinamarca

**zip\_code** `string`

El código postal de la dirección del vendedor (MAX 11; MIN 4).

Ejemplo: 111111

**taxes** `array of objects`

Especifica el objeto de impuestos de la orden.

**propiedades**

**type** `string`

Tipo de impuesto.

Ejemplo: VAT

**tax\_base** `float`

El monto base sobre el cual se aplica el impuesto definido.

Ejemplo: 10000

**value** `float`

El monto del impuesto.

Ejemplo: 2100

**percentage** `float`

El porcentaje del impuesto.

Ejemplo: 21

**external\_invoice** `object`

La factura de Stripe que paga este enlace de pago, tal como se envió cuando se creó el enlace. La clave no aparece en los enlaces creados sin ella.

**propiedades**

**id** `string`

El identificador de la factura en Stripe (`in_...`).

Ejemplo: in\_1QwZzz

**customer\_id** `string`

El cliente de Stripe (`cus_...`) propietario de la factura. Es nulo cuando el enlace se creó sin él.

Ejemplo: cus\_RplXYZ

**one\_time\_use** `boolean`

Enlace único: para un cobro único con producto, monto e información del cliente definidos.

Enlace múltiple: para usar y compartir tantas veces como sea necesario, con monto y producto definidos.

Opciones: false permite un solo uso, true permite varios pagos.

**availability** `object`

Especifica el objeto de disponibilidad. Se refiere a la fecha de vencimiento del enlace de pago.

**propiedades**

**start\_at** `timestamp`

Inicio del período de validez del enlace de pago.

Ejemplo: 2022-05-09T20:46:54.786342Z

**finish\_at** `timestamp`

Fin del período de validez del enlace de pago.

Ejemplo: 2022-05-09T20:46:54.786342Z

**callback\_url** `string`

URL a la que se redirige a tu cliente después del pago (MAX 255; MIN 3).

Ejemplo: [https://www.your-site.com/](https://www.your-site.com/)

**redirect\_url** `string`

URL del enlace de pago (MAX 255; MIN 3).

Ejemplo: [https://checkout.y.uno/payment\_links/id](https://checkout.y.uno/payment_links/id)

**payment\_method\_types** `array of enums`

La lista de tipos de métodos de pago que los clientes pueden usar. Si no se pasa ningún valor, Yuno mostrará los
métodos de pago definidos en el dashboard.

**payment** `array of objects`

Arreglo de [objetos pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)

**metadata** `array of objects`

Especifica una lista de objetos de metadata. Puedes agregar hasta 50 objetos de metadata.

**propiedades**

**metadata object** `object`

Especifica una clave de metadata y su valor correspondiente.

**propiedades**

**key** `string`

Especifica una clave de metadata.

Ejemplo: age

**value** `string`

Especifica el valor de la clave de metadata definida.

Ejemplo: 28

**vault\_on\_success** `boolean`

Indicador para registrar la tarjeta después de un pago exitoso. Es false por defecto.

Ejemplo: false


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