> ## 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 de pago

> Referencia de los campos del objeto de pago que se devuelven después de crear una sesión de checkout.

Este objeto representa el pago creado después de generar la sesión de checkout para un cliente. Para reembolsar un pago, consulta [Reembolsar pagos](https://docs.y.uno/es/docs/direct-integration-use-cases/refund-payments.md) y la API [Reembolsar pago](https://docs.y.uno/es/reference/payments/refund-payment.md).

> [!NOTE]
>
> **Metadatos y lógica de enrutamiento**
>
> Las reglas de enrutamiento leen los metadatos del pago, combinados con los metadatos de su cliente. Para definir la lógica de enrutamiento, establece metadatos en el pago o en el cliente. Los metadatos establecidos solo en la [sesión de checkout](https://docs.y.uno/es/reference/checkout-sessions/the-checkout-session-object.md) no llegan al enrutamiento del pago; en la sesión, solo determinan qué métodos de pago y cuotas lista la sesión.

**id** `string`

El identificador único del cliente (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 pago (MAX 255; MIN 3).

Ejemplo: Purchase on web

**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 de la transacción.

Ejemplo: SUCCEEDED

**sub\_status** `enum`

Es un complemento de la información del estado.

Ejemplo: DECLINED

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

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

Ejemplo: 0000023

**created\_at** `timestamp`

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

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

**updated\_at** `timestamp`

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

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

**idempotency\_key** `string`

opcional

La clave de idempotencia enviada al crear el pago; está presente cuando el pago se creó con una clave de idempotencia.

Ejemplo: fc0d89a1-8d18-4759-8d0a-ee1c6d0386e2

**account\_code** `string`

opcional

El código de cuenta asociado al pago (identificador de la cuenta).

Ejemplo: 26a6626c-d3ec-4caa-bf7c-a994b145dc00

**payment\_link\_code** `string`

opcional

Está presente cuando el pago se creó mediante un enlace de pago; identifica el enlace de pago utilizado.

Ejemplo: (cadena vacía cuando no proviene de un enlace de pago)

**subscription\_code** `string | null`

opcional

Está presente cuando el pago está asociado a una suscripción; el identificador de la suscripción.

Ejemplo: null

**plan\_id** `string`

opcional

El `id` del plan en el que estaba la suscripción cuando se creó este pago. Está presente solo en un pago creado con `subscription.plan_id` y en los pagos de renovación que Yuno genera para esa suscripción. Está ausente en cualquier otro pago. Consulta [Crear una suscripción a partir de un plan](https://docs.y.uno/es/docs/payment-features/subscriptions/start-with-payment.md#create-a-subscription-from-a-plan).

Ejemplo: 14898a9d-5a75-433d-ba17-f2ea5b33620c

**plan\_assigned\_at** `string`

opcional

Cuándo se asignó el plan a la suscripción, en UTC ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)). Está presente solo en los pagos que incluyen `plan_id`.

Ejemplo: 2026-09-24T22:53:42.814482Z

**simplified\_mode** `boolean`

opcional

Indica si el pago se creó en modo simplificado (por ejemplo, en ciertos flujos como suscripción o reintento).

Ejemplo: false

**amount** `object`

Especifica el objeto de 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). Con una promoción de Yuno, es el monto que enviaste, antes del descuento: Yuno cobra `value` menos `discount_amount`.

Ejemplo: 111111

**currency\_conversion** `object`

Especifica el objeto de conversión de moneda.

**propiedades**

**provider\_currency\_conversion\_id** `string`

El identificador único de la consulta de tasa de conversión del proveedor (MAX 526 ; MIN 3).

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

**cardholder\_currency** `enum`

La moneda a la que se hace la conversión (ISO 4217 MAX 3; MIN 3).

Ejemplo: USD

**cardholder\_amount** `number`

Monto del pago antes de la conversión

Ejemplo: 100

**refunded** `number`

El monto del reembolso (múltiplo de 0.0001). Con una promoción de Yuno, se calcula sobre el monto cobrado, por lo que un reembolso total equivale a `value` menos `discount_amount`.

Ejemplo: 111111

**captured** `number`

El monto capturado (múltiplo de 0.0001). Con una promoción de Yuno, se calcula sobre el monto cobrado.

Ejemplo: 111111

**authorized** `number`

El monto que aprobó el proveedor (múltiplo de 0.0001), neto de cualquier promoción de Yuno (`value` menos `discount_amount`) y aumentado por las autorizaciones incrementales aprobadas. Es igual a ese monto neto en una aprobación completa o cuando el proveedor no devuelve un monto aprobado.

Después de una aprobación parcial de un pago con tarjeta enviado con `payment_method.detail.card.partial_approval: true`, el pago conserva el estado de una aprobación completa, por lo que está aprobado parcialmente cuando `authorized` es menor que `value` menos `discount_amount` (cuando no hay promoción, menor que `value`). Las capturas y los reembolsos de ese pago se limitan a `authorized`.

No se devuelve para pagos que no fueron aprobados o que se crearon antes de que se introdujera este campo.

Ejemplo: 111111

**discount\_amount** `object`

opcional

El descuento total de la promoción de Yuno aplicada al pago: la suma de las líneas `YUNO_PROMOTION` de `additional_data.order.discounts`. Está ausente cuando no se aplicó ninguna promoción. El monto cobrado es `amount.value` menos este valor, y aparece en `transactions.amount`. Consulta [Promociones](https://docs.y.uno/es/docs/payment-features/promotions).

**propiedades**

**currency** `enum`

La moneda del descuento, la misma que `amount.currency` (MAX 3; MIN 3; [ISO 4217](https://docs.y.uno/es/reference/country-reference.md) ).

Ejemplo: USD

**value** `number`

El descuento.

Ejemplo: 25

**checkout** `object`

Especifica el objeto de checkout. Este objeto no es obligatorio para los pagos back to back. Es obligatorio cuando `WORKFLOW` se define como `CHECKOUT` o no se envía. No es obligatorio para los pagos `DIRECT`.

**propiedades**

**session** `string`

La sesión de checkout que se creó para el pago (MAX 64; MIN 36).

Ejemplo: 757eefc7-e28c-4333-9a07-3b16e610745d

**sdk\_action\_required** `boolean`

Define si el pago es asíncrono y requiere pasos adicionales a partir de una solicitud al SDK.

Ejemplo: false

**metadata** `array of objects`

Especifica una lista de pares clave-valor personalizados asociados al pago (para referencias internas, segmentación o etiquetas de flujo de trabajo). Puedes agregar hasta 120 objetos de metadatos.

**propiedades**

**metadata object** `object`

Especifica una clave de metadatos y su valor correspondiente.

Úsalo para adjuntar contexto definido por el comercio (por ejemplo: `order_id`, `customer_tier`). Evita enviar datos sensibles o personales.

**propiedades**

**key** `string`

Especifica una clave de metadatos (MAX 48).

Ejemplo: age

**value** `string`

Especifica el valor de la clave de metadatos definida (MAX 512).

Ejemplo: 28

**payment\_method** `object`

Especifica el objeto payment\_method.

**propiedades**

**vaulted\_token** `string`

El vaulted\_token representa un método de pago almacenado de forma segura, asociado a una transacción anterior. Al
usar un vaulted\_token para crear un pago, no es necesario enviar un token adicional; se puede definir como
null (MAX: 64; MIN: 36).

Este campo se devuelve en la respuesta del pago cuando `vault_on_success = true` y el estado del pago es `SUCCEEDED`, siempre que el pago haga referencia a un cliente de Yuno existente mediante `customer_payer.id`.

Ejemplo: 8604911d-5ds9-229e-8468-bd41abear14s

**type** `enum`

Tipo de método de pago. Obligatorio para el flujo de trabajo `DIRECT` o `REDIRECT`. Obligatorio al integrar billeteras, incluso al usar el SDK.

Valores posibles del enum:

Valores posibles del enum: consulta la [referencia de tipos de pago](https://docs.y.uno/es/reference/payment-type-list.md).

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

Indicador para inscribir la tarjeta después de un pago exitoso. Requiere que el pago haga referencia a un cliente de Yuno existente mediante `customer_payer.id` .

Cuando se establece en `true` y el estado del pago es `SUCCEEDED`, la respuesta del pago incluirá un `vaulted_token` que se puede usar en transacciones futuras. Sin un ID de cliente no se almacena la tarjeta y no se devuelve ningún `vaulted_token`, incluso si los datos del cliente se incluyen en línea.

Valores posibles: `True` o `False`

**token** `string`

El token de método de pago de un solo uso proporcionado por el SDK de Yuno . Si un pago se crea con un token,
no es necesario enviar también un vaulted\_token; se puede definir como null. No es necesario para los pagos back to back
(MAX: 64; MIN: 36).

Ejemplo: 5104911d-5df9-229e-8468-bd41abea1a4s

**detail** `object`

Especifica el objeto de detalle del método de pago, que proporciona los detalles de las diferentes categorías
de transacción que forman parte del objeto de método de pago.

**propiedades**

**card** `object`

Especifica los detalles del método de pago cuando se usa una tarjeta.

**propiedades**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un
monto real.

Valores posibles: `True` o `False`

**capture** `boolean`

Decide si se autoriza el pago o se captura. Autorizar un pago con tarjeta te permite
reservar fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**partial\_approval** `boolean`

Indica si el pago se envió aceptando una aprobación por menos de `amount.value`. Se aplica a compras y autorizaciones con tarjeta, no a verify. El monto aprobado está en `amount.authorized`. Sin este campo, o cuando el proveedor no admite aprobaciones parciales, el pago se procesa como un pago con tarjeta normal.

Valor predeterminado: `false`

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**first\_installments\_deferral** `integer`

Número de meses de espera para debitar la primera cuota.

Ejemplo: 1

**installments\_type** `string`

Define el tipo de cuotas.

Ejemplo: string

**installments\_amount** `integer`

El monto de la cuota incluye los intereses asociados a la cuota y la información la define el
proveedor.

Ejemplo: 3

**soft\_descriptor** `string`

El descriptor que se envía por transacción a nuestra plataforma. Se mostrará en el
extracto bancario físico del cliente (MAX 15; MIN 0).

Ejemplo: COMPANY1

**authorization\_code** `string`

El código de respuesta del adquirente.

Ejemplo: 742A64

**retrieval\_reference\_number** `string`

El identificador único que asigna un adquirente a una autorización. En el caso de Brasil, recibirás el nsu.

Ejemplo: 200000000012

**acquirer\_reference\_number** `string`

El identificador único que asigna el adquirente de la tarjeta para rastrear la transacción a través de la red de tarjetas. Se usa para la conciliación y los contracargos.

Para los proveedores que devuelven una referencia del adquirente (por ejemplo, Adyen), este campo contiene ese valor, y `retrieval_reference_number` puede estar vacío para esos proveedores.

Ejemplo: 7C9F8E2A1B3D

**par** `string`

La Referencia de cuenta de pago (PAR) de la tarjeta, tal como la devuelve el proveedor. Una PAR identifica la cuenta del titular de la tarjeta a través del número de tarjeta y sus network tokens, por lo que la misma cuenta conserva una sola PAR.

Se devuelve en pagos con tarjeta con o sin network token. Cuando el pago usa un network token, `card_data.network_token.par` lleva el mismo valor. El campo se omite cuando el proveedor no envía una PAR.

Ejemplo: V0010013019000000000000000001

**voucher** `string`

El identificador único del comprobante de pago que asigna el banco emisor en una transacción con tarjeta.
Este campo está vacío si el gateway no proporciona información sobre la transacción (MAX 255; MIN 3).

Ejemplo: 43564

**card\_data** `object`

Especifica los detalles de la tarjeta.

**propiedades**

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en la tarjeta (MAX 26; MIN 2), disponible solo para comercios
con certificación PCI.

Ejemplo: Fannie Weissnat

**country\_code** `string`

Código de país de la tarjeta del usuario (MAX 2; MIN 2).

Ejemplo: US

**expiration\_month** `integer`

Mes de vencimiento de la tarjeta (MM) (MAX 2; MIN 2).

Ejemplo: 03

**expiration\_year** `integer`

Año de vencimiento de la tarjeta (YYYY) (MAX 4; MIN 2).

Ejemplo: 2030

**iin** `string`

El número de identificación del emisor (IIN) corresponde a los primeros dígitos del número de la tarjeta de pago
emitida por una institución financiera (MAX 8; MIN 6).

Ejemplo: 41961111

**lfd** `string`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 19; MIN 8).

Ejemplo: 41961111

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: VISA

**issuer\_name** `string`

El emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: Banco Galicia

**issuer\_code** `integer`

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

**category** `string`

La categoría del emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: Gold

**type** `string`

El tipo de emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: CREDIT, DEBIT o CHARGE\_CARD

**fingerprint** `string`

Cuando un cliente inscribe una tarjeta de crédito varias veces en una o varias cuentas de Yuno, se generan varios vaulted\_tokens, pero el fingerprint te permite identificar cuándo se usa la misma tarjeta para el cliente (MAX 255; MIN 3).

Ejemplo: 55a7fe38-cdc3-45dc-8c5f-820751799c76

**three\_d\_secure** `object`

Especifica los detalles de la transacción 3DS.

**propiedades**

**three\_d\_secure\_setup\_id** `string`

ID de configuración obtenido para el flujo 3DS Direct.

Ejemplo: 24127d61-b852-42fb-acd4-1ee661645376

**version** `enum`

Se refiere a la versión del protocolo de la especificación EMV 3-D Secure utilizada. 1.0, 2.0, 2.1.0,
2.2.0, 2.2.1.

Ejemplo: 2.2.1

**electronic\_commerce\_indicator** `string`

Este campo debe completarse con el resultado del campo [ECI](https://docs.y.uno/es/reference/eci-indicators-list.md) que proporciona el servicio 3d Secure. El Electronic Commerce Indicator (ECI) informa al emisor de la tarjeta si la transacción estuvo
protegida por un protocolo de seguridad como VbV o MCSC. Visa y MasterCard exigen que todas las
transacciones 3-D Secure tengan este valor completo en la solicitud de autorización (MAX: 2, MIN: 0).

Ejemplo: 05

**cryptogram** `string`

Este campo debe completarse con el resultado del campo cryptogram que proporciona el servicio 3DSecure.
En las transacciones Visa, representa el Cardholder Authentication Verification Value
(CAVV), un valor criptográfico que genera el emisor como prueba de la autenticación del pago durante
la compra en línea para calificar a la protección contra contracargos. Las transacciones MasterCard tienen un valor similar
llamado Accountholder Authentication Value (AAV) o Universal Cardholder Authentication Field
(UCAF). Al enviar una transacción para autorización, el comercio debe incluir el CAVV o
AAV/UCAF para demostrar que el titular de la tarjeta fue autenticado. Normalmente está codificado en base64.
(MAX: 40, MIN: 0).

Ejemplo: BA0BB1Z3N5Q4kjkBU3c3ELGUsJY =

**transaction\_id** `string`

Para 3DS v1:
Es el Unique Transaction Identifier. Lo genera automáticamente el MPI. Normalmente tiene
28 bytes de longitud y está codificado en base64. Suele llamarse XID (MAX: 40, MIN: 0).
Para 3DS v2:
Identificador único universal de la transacción asignado por el DS para identificar una sola transacción. (MAX:
36, MIN:36).

Ejemplo para V1: “TjY0MjAxRjA4MD4987DUzMzYyNjU=”
Ejemplo para V2: “c4e59ceb-a382-4d6a-bc87-385d591fa09d”

**directory\_server\_transaction\_id** `string`

ID de transacción que genera el servidor de directorio de Mastercard durante la autenticación (MAX 255;
MIN 3).

Ejemplo: f38e6948-5388-41a6-bca4-b49723c19437

**network\_token** `object`

Información sobre el network token utilizado en la transacción. Si aplica.

**propiedades**

**network** `enum`

El proveedor asociado al token proporcionado. VISA, MASTERCARD, AMERICAN\_EXPRESS.

Ejemplo: MASTERCARD

**status** `enum`

Estado del token del método de pago. CREATED, ACTIVE, SUSPENDED, CANCELED.

Ejemplo: ACTIVE

**par** `string`

Referencia de la cuenta de pago.

Ejemplo: MCC123456789012

**token\_data** `object`

Detalles del token.

**propiedades**

**number** `number`

\[Obligatorio]: Número del token sin separadores (MAX 19; MIN 8), disponible solo para comercios con certificación PCI.

Ejemplo: 450799000001234

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en el Token (MAX 26; MIN 2).

Ejemplo: John Doe

**iin** `number`

El número de identificación de la institución (IIN) corresponde a los primeros dígitos del número de un network token emitido por una institución financiera (MAX 8; MIN 6).

Ejemplo: 45079900

**lfd** `number`

Últimos cuatro dígitos del network token (MAX 4; MIN 4).

Ejemplo: 1234

**expiration\_month** `number`

Mes de vencimiento del network token (MM) (MAX 2; MIN 2).

Ejemplo: 12

**expiration\_year** `number`

Año de vencimiento del network token (YYYY)  (MAX 4; MIN 2).

Ejemplo: 2027

**cryptogram** `string`

\[Obligatorio]: El criptograma único que genera el emisor para el network token en uso en la transacción.

**electronic\_commerce\_indicator** `string`

\[Obligatorio solo para ciertos proveedores]: Si Mastercard autenticó el token, el campo debe establecerse en 02. Para Visa o tokens no autenticados, no es necesario enviar el campo.

**token\_requestor\_id** `string`

\[Obligatorio solo para ciertos proveedores]: ID del solicitante del token (token requestor) del comercio

**response** `object`

Detalles de la transacción de red.

**propiedades**

**code** `number`

Código de respuesta del proveedor de servicios.

Ejemplo: succeeded

**message** `number`

Código de respuesta del proveedor de servicios.

Ejemplo: Transaction Succeeded

**stored\_credentials** `object`

Indica el tipo de procesamiento de la transacción.

**properties**

**reason** `enum`

Indica el tipo de procesamiento de la transacción. Enum: CARD\_ON\_FILE, SUBSCRIPTION, UNSCHEDULED\_CARD\_ON\_FILE

Ejemplo: SUBSCRIPTION

**usage** `enum`

Este campo te permite indicar si es la primera vez que el vaulted\_token/network\_token se usa para un pago o si ya se usó en un pago anterior. Enum: FIRST, USED

Ejemplo: USED

**subscription\_agreement\_id** `string`

Este campo te permite indicar la identificación del acuerdo con el cliente para una suscripción. Principalmente para MX (MAX 255; MIN 3).

Ejemplo: AA0001

**network\_transaction\_id** `string`

Identificador único que la red de tarjetas asigna a una transacción. Se usa para rastrear y referenciar transacciones específicas, en particular en escenarios de pagos recurrentes, y garantiza la coherencia y la trazabilidad a lo largo del ciclo de vida del pago (MAX 255; MIN 3).

Ejemplo: 583103536844189

**bnpl** `object`

Especifica los detalles del método de pago al usar Buy Now Pay Later (BNPL).

**properties**

**installments** `integer`

Las cuotas del préstamo (MAX 50; MIN 1).

Ejemplo: 10

**provider\_image** `string`

La URL del proveedor (MAX 255; MIN 3).

Ejemplo: [https://www.company.com/](https://www.company.com/)

**redirect\_url** `string`

La URL con la versión completa del ticket, por si quieres redirigir a tu cliente (MAX 255;
MIN
3\).

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**expires\_at** `timestamp`

Fecha de vencimiento de los métodos de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**name** `string`

El nombre legal del cliente (MAX 32, MIN 8).

Ejemplo: Legal name

**username** `string`

El nombre de usuario del cliente en la plataforma del proveedor (MAX 32, MIN 8).

Ejemplo: Legal\_name\_01

**tax\_id\_type** `string`

El identificador fiscal del cliente (MAX 32, MIN 8).

Ejemplo: CUIT

**tax\_id** `string`

El número de identificador fiscal del cliente (MAX 32, MIN 8).

Ejemplo: 20-34566123-7

**type** `string`

El tipo de crédito (MAX 255; MIN 3).

Ejemplo: PERSONAL/BUSINESS

**area** `string`

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

Ejemplo: OTHERS

**role** `string`

El rol del cliente en la empresa (MAX 255; MIN 3).

Ejemplo: OWNER

**bank\_transfer** `object`

Especifica los detalles del método de pago al usar transferencia bancaria.

**properties**

**provider\_image** `string`

La URL del proveedor (MAX 255; MIN 3).

Ejemplo: [https://www.company.com/](https://www.company.com/)

**account\_type** `string`

Tipo de cuenta bancaria (MAX 255; MIN 3).

Ejemplo: CHECKINGS/SAVINGS

**bank\_name** `string`

Nombre del banco asociado a la cuenta (MAX 255; MIN 3).

Ejemplo: Banco Galicia

**bank\_id** `string`

Identificador del banco seleccionado cuando el proveedor exige elegir uno (MAX 255; MIN 1). Opcional.

Ejemplo: galicia

**beneficiary\_name** `string`

El nombre del titular de la cuenta (MAX 255; MIN 3).

Ejemplo: John Doe

**bank\_account** `string`

El número de la cuenta bancaria (MAX 255; MIN 3).

Ejemplo: 54653211313333

**bank\_account\_2** `string`

El número secundario de la cuenta bancaria (MAX 255; MIN 3).

Ejemplo: 78900000000123

**beneficiary\_document\_type** `string`

Tipo de documento del titular de la cuenta (MAX 255; MIN 3).

Valores posibles: consulta la [
Referencia de países](https://docs.y.uno/es/reference/country-reference.md). Ejemplo: DNI

**beneficiary\_document** `string`

Número de documento del titular de la cuenta (MAX 255; MIN 3).

Ejemplo: 54666897

**reference** `string`

Código de referencia para el usuario (MAX 255; MIN 3).

Ejemplo: AA01234-BC

**retrieval\_reference\_number** `string`

El identificador único que un adquirente asigna a una autorización. En el caso de Brasil, recibirás el nsu.

Ejemplo: 200000000012

**acquirer\_reference\_number** `string`

El identificador único que el adquirente de la tarjeta asigna para rastrear la transacción a través de la red de tarjetas. Se usa para la conciliación y los contracargos.

Para los proveedores que devuelven una referencia del adquirente (por ejemplo, Adyen), este campo contiene ese valor, y `retrieval_reference_number` puede estar vacío para esos proveedores.

Ejemplo: 7C9F8E2A1B3D

**par** `string`

La Referencia de cuenta de pago (PAR) de la tarjeta, tal como la devuelve el proveedor. Una PAR identifica la cuenta del titular de la tarjeta a través del número de tarjeta y sus network tokens, por lo que la misma cuenta conserva una sola PAR.

Se devuelve en pagos con tarjeta con o sin network token. Cuando el pago usa un network token, `card_data.network_token.par` lleva el mismo valor. El campo se omite cuando el proveedor no envía una PAR.

Ejemplo: V0010013019000000000000000001

**payment\_instruction** `string`

Instrucciones de pago relacionadas con el pago (MAX 255; MIN 3).

Ejemplo: Go to your bank account and transfer the amount using the reference detailed
a continuación

**redirect\_url** `string`

La URL con la versión completa del ticket, por si quieres redirigir a tu cliente (MAX 255;
MIN
3\).

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**expires\_at** `timestamp`

Fecha de vencimiento de los métodos de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**wallet** `object`

Especifica los detalles del método de pago al usar una wallet.

**properties**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un
monto real.

Valores posibles: `True` o `False`

**cryptogram** `string`

Criptograma para integraciones directas con wallets de tarjetas (MAX 526; MIN 3).

**expires\_at** `timestamp`

Fecha de vencimiento de los métodos de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**capture** `boolean`

Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta te permite
reservar fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**payment\_method\_id** `string`

El método de pago del usuario utilizado en su wallet.

Ejemplo: credit\_card

**detail** `string`

El detalle del método de pago utilizado en su wallet.

Ejemplo: visa

**money\_release\_date** `date`

Fecha en la que el dinero del proveedor estará disponible para usar.

Ejemplo: 2022-05-09T00:00:00.000000Z

**sponsor\_id** `string`

Cuenta del proveedor del socio (MAX 255; MIN 3).

Ejemplo: 4562103

**authorization\_code** `string`

Código de respuesta del adquirente.

Ejemplo: 742A64

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**email** `string`

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

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

**first\_name** `string`

El nombre del cliente (MAX 32, MIN 8).

Ejemplo: John

**last\_name** `string`

El apellido del cliente (MAX 32, MIN 8).

Ejemplo: Doe

**username** `string`

El nombre de usuario del cliente en la plataforma (MAX 32, MIN 8).

Ejemplo: John\_Doe\_01

**identification\_type** `string`

El tipo de documento del cliente (MAX 32, MIN 8).

Consulta la [
Referencia de países](https://docs.y.uno/es/reference/country-reference.md). Ejemplo: DNI

**identification\_number** `string`

El número de identificación del cliente (MAX 32, MIN 8).

Ejemplo: 34566123

**fee\_details** `object`

Especifica los detalles de las comisiones.

**properties**

**amount** `float`

Monto de la transacción (múltiplo de 0.0001).

Ejemplo: 40.5

**card\_data** `object`

Especifica los detalles de la tarjeta.

**properties**

**iin** `integer`

El número de identificación del emisor (IIN) se refiere a los primeros dígitos del número de la tarjeta
de pago emitida por una institución financiera (MAX 8; MIN 6).

Ejemplo: 45079900

**lfd** `integer`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 2; MIN 1).

Ejemplo: 16

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: visa

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en ella (MAX 26; MIN 2), solo disponible para
comercios con certificación PCI.

Ejemplo: JOHN DOE

**stored\_credentials** `object`

Indica el tipo de procesamiento de la transacción. En la solicitud de creación de pago, este es el nodo que se usa para un CIT de Apple Pay o Google Pay con `vault_on_success` (`usage: FIRST`); los cobros posteriores con el `vaulted_token` resultante usan `detail.card.stored_credentials`. En la respuesta, la transacción de wallet devuelve este campo como `null` y el valor se incluye en la transacción `CARD`, en `transactions[].payment_method.detail.card.stored_credentials`. Consulta [Credenciales almacenadas](https://docs.y.uno/es/docs/payment-features/stored-credentials.md#wallet-originated-tokens-apple-pay-and-google-pay).

**properties**

**reason** `enum`

Indica el motivo para almacenar las credenciales de la transacción. Enum: CARD\_ON\_FILE, SUBSCRIPTION, UNSCHEDULED\_CARD\_ON\_FILE

Ejemplo: SUBSCRIPTION

**usage** `enum`

Este campo te permite indicar si es la primera vez que el vaulted\_token/network\_token se usa para un pago o si ya se usó en un pago anterior. Enum: FIRST, USED

Ejemplo: USED

**subscription\_agreement\_id** `string`

Este campo te permite indicar la identificación del acuerdo con el cliente para una suscripción. Principalmente para MX (MAX 255; MIN 3).

Ejemplo: AA0001

**network\_transaction\_id** `string`

Identificador único que la red de tarjetas asigna a una transacción. Se usa para rastrear y referenciar transacciones específicas, en particular en escenarios de pagos recurrentes, y garantiza la coherencia y la trazabilidad a lo largo del ciclo de vida del pago (MAX 255; MIN 3).

Ejemplo: 583103536844189

**additional\_data** `object`

Esta estructura se usa para enviar información adicional sobre la recurrencia. Es opcional y pocos proveedores la requieren (por ejemplo, Mercado Pago). Contacta a tu TAM para confirmar si es necesaria para tu integración.

**properties**

**billing\_cycles** `object`

Especifica el objeto `billing_cycles`. Define el número de cobros asociados a la suscripción. Si usas este objeto, debes ingresar datos en todos los campos.

**properties**

**current** `integer`

Ejemplo: 1

**total** `integer`

El número total de ciclos de facturación de la suscripción (MIN 1).

**frequency** `object`

Especifica el tipo de frecuencia (por ejemplo, DAY, WEEK, MONTH, YEAR) y el valor. Ingresa datos en todos los campos si usas este objeto.

**properties**

**type** `string`

Especifica el tipo de frecuencia (por ejemplo, DAY, WEEK, MONTH, YEAR).

Ejemplo: MONTH

**value** `string`

Especifica el valor de la frecuencia.

**availability** `object`

Especifica el objeto `availability`. Define un intervalo de fechas, con fecha de inicio y de fin, durante el cual la suscripción está disponible para usar.

**properties**

**start\_at** `string`

La fecha de inicio a partir de la cual el plan de suscripción estará disponible para usar. Si no se define, la suscripción está disponible desde el momento en que se crea. `start_at` pasa a ser obligatorio cuando se usa `finish_at` .

**finish\_at** `string`

La fecha de fin hasta la cual el plan de suscripción estará disponible para usar. Si no se define, la suscripción está disponible de forma indefinida. `finish_at` pasa a ser obligatorio cuando se usa `start_at` .

**ticket** `object`

Especifica los detalles del método de pago al usar ticket.

**properties**

**type** `string`

El tipo de ticket.

Ejemplo: number, barcode, custom, reference\_code, qr

**benefit\_type** `enum`

Tipo de beneficio del usuario para el método de pago ticket. JUNAEB, PRIVATE

Ejemplo: PRIVATE

**provider\_number** `integer`

El número del ticket.

Ejemplo: 13141

**provider\_barcode** `string`

El código de barras del ticket, como valor de texto. Para la imagen del código de barras, consulta `provider_logo`.

Ejemplo: 456789009878765u7654

**provider\_logo** `string`

El logo del ticket.

Ejemplo: [https://www.company.com/logo](https://www.company.com/logo)

**provider\_format** `string`

El formato del ticket.

Ejemplo: barcode, custom

**payment\_instruction** `string`

Instrucciones de pago relacionadas con el pago (MAX 255; MIN 3).

Ejemplo: Go to your closest store and pay the total amount using the reference detailed below

**redirect\_url** `string`

La URL con la versión completa del ticket.

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**expires\_at** `timestamp`

Fecha de vencimiento de los métodos de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**payment\_link** `object`

Especifica los detalles del método de pago al usar un enlace de pago.

**properties**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un
monto real.

Valores posibles: `True` o `False`

**capture** `boolean`

Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta te permite
reservar fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**expires\_at** `timestamp`

Fecha de vencimiento de los métodos de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**payment\_method\_id** `string`

El método de pago del usuario utilizado en su wallet.

Ejemplo: credit\_card

**detail** `string`

El detalle del método de pago utilizado en su wallet.

Ejemplo: visa

**money\_release\_date** `date`

Fecha en la que el dinero del proveedor estará disponible para usar.

Ejemplo: 2022-05-09T00:00:00.000000Z

**sponsor\_id** `string`

Cuenta del proveedor del socio (MAX 255; MIN 3).

Ejemplo: 4562103

**authorization\_code** `string`

Código de respuesta del adquirente.

Ejemplo: 742A64

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**email** `string`

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

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

**first\_name** `string`

El nombre del cliente (MAX 32, MIN 8).

Ejemplo: John

**last\_name** `string`

El apellido del cliente (MAX 32, MIN 8).

Ejemplo: Doe

**username** `string`

El nombre de usuario del cliente en la plataforma (MAX 32, MIN 8).

Ejemplo: John\_Doe\_01

**identification\_type** `string`

El tipo de documento del cliente (MAX 32, MIN 8).

Valores posibles: consulta la [
Referencia de países](https://docs.y.uno/es/reference/country-reference.md). Ejemplo: DNI

**identification\_number** `string`

El número de identificación del cliente (MAX 32, MIN 8).

Ejemplo: 34566123

**fee\_details** `object`

Especifica los detalles de las comisiones.

**properties**

**amount** `float`

Monto de la transacción (múltiplo de 0.0001).

Ejemplo: 40.5

**card\_data** `object`

Especifica los detalles de la tarjeta.

**properties**

**iin** `integer`

El número de identificación del emisor (IIN) corresponde a los primeros dígitos del número de la tarjeta de pago
emitida por una institución financiera (MAX 8; MIN 6).

Ejemplo: 45079900

**lfd** `integer`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 2; MIN 1).

Ejemplo: 16

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: visa

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en ella (MAX 26; MIN 2), disponible solo para comercios
con certificación PCI.

Ejemplo: John Doe

**expiration\_month** `integer`

Mes de vencimiento de la tarjeta (MM) (MAX 2; MIN 2).

Ejemplo: 03

**expiration\_year** `integer`

Año de vencimiento de la tarjeta (YYYY) (MAX 4; MIN 2).

Ejemplo: 30

**customer\_payer** `object`

Especifica el objeto de cliente para los pagos.

**properties**

**id** `string`

El identificador único del cliente (MAX 64; MIN 36). Especifica el objeto checkout. Este objeto no es
obligatorio para pagos back to back. Es obligatorio cuando `WORKFLOW` se define como `CHECKOUT` o
no se envía.

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

**merchant\_customer\_id** `string`

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

Ejemplo: 4ce6f7e1-bf2e-4e7f-bc1b-84b26082a1d3

**merchant\_customer\_created\_at** `timestamp`

Fecha de registro del cliente en la plataforma del comercio (ISO 8601 MAX 27; MIN 27).

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

**merchant\_customer\_validations** `object`

Validaciones de fraude para el cliente pagador.

**properties**

**account\_is\_verified** `boolean`

Indica si la cuenta del cliente fue validada previamente por el comercio. El valor predeterminado es true.

Valores posibles: `True` or `False`

**email\_is\_verified** `boolean`

Indica si el email del cliente fue validado previamente por el comercio. El valor predeterminado es true.

Valores posibles: `True` or `False`

**phone\_is\_verified** `boolean`

Indica si el teléfono del cliente fue validado previamente por el comercio. El valor predeterminado es true.

Valores posibles: `True` or `False`

**first\_name** `string`

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

Ejemplo: John

**last\_name** `string`

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

Ejemplo: Doe

**gender** `enum`

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

Valores posibles del enum: `M`, `F`, `NA`, or `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).

**device\_fingerprint** `string`

El fingerprint del dispositivo del cliente (MAX 4000; MIN 1). En las integraciones que usan el checkout de Yuno, el valor se
obtiene automáticamente, no envíes este campo.

Ejemplo: hi88287gbd8d7d782ge.....

**device\_fingerprints** `array of object`

Si usas una integración DIRECT y quieres admitir más de un proveedor de fraude en el flujo de pago, puedes usar este objeto para especificar la información necesaria. En las integraciones que usan el checkout de Yuno, el valor se obtiene automáticamente, no envíes este campo.

**properties**

**provider\_id** `enum`

El id del proveedor de análisis de fraude

Ejemplo: RISKIFIED

**id** `string`

El fingerprint del dispositivo asociado al proveedor

Ejemplo: hi88287gbd8d7d782ge.....

**ip\_address** `string`

La dirección IP del cliente (MAX 45; MIN 7).

Ejemplo: 192.168.123.167

**browser\_info** `object`

Especifica el objeto browser\_info.

**properties**

**accept\_header** `boolean`

El valor del encabezado accept del navegador del cliente.

Valores posibles: `True` or `False`

**accept\_browser** `string`

El valor accept browser del navegador del cliente

Valores posibles: `"True"` or `"False"`

**accept\_content** `string`

El valor accept content del navegador del cliente

Valores posibles: `"True"` or `"False"`

**platform** `enum`

La plataforma desde la cual el cliente realiza el pago.

Valores posibles del enum: `WEB`, `IOS`, `ANDROID`

**color\_depth** `float`

La profundidad de color del navegador del cliente en bits por píxel. Debe obtenerse con la
propiedad screen.colorDepth del navegador. Valores aceptados: profundidad de color de 1, 4, 8, 15, 16, 24, 30, 32 o 48 bits
(MAX
5; MIN 1).

Ejemplo: 15

**javascript\_enabled** `boolean`

Indica si Javascript está habilitado o no en el dispositivo.

Valores posibles: `True` or `False`

**java\_enabled** `boolean`

Indica si Java está habilitado o no en el dispositivo.

Valores posibles: `True` or `False`

**browser\_time\_difference** `string`

Indica la diferencia horaria del navegador

Ejemplo: -3:00

**language** `string`

El valor navigator.language del navegador del cliente (según IETF BCP 47) (MAX 5; MIN 1).

Ejemplo: es-ES

**screen\_height** `string`

La altura total de la pantalla del dispositivo del cliente en píxeles (MAX 255; MIN 3).

Ejemplo: 2048

**screen\_width** `string`

El ancho total de la pantalla del dispositivo del cliente en píxeles (MAX 255; MIN 3).

Ejemplo: 1152

**user\_agent** `string`

El valor del user agent del navegador del cliente (MAX 255; MIN 3).

Ejemplo: Mozilla/5.0 (Macintosh; Intel Mac OS X 10\_11\_2) AppleWebKit/601.3.9 (KHTML, like
Gecko)
Version/9.0.2 Safari/601.3.9

**document** `object`

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

**properties**

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

**properties**

**number** `string`

El número de teléfono del cliente (MAX 40; MIN 3). Para algunos proveedores y países, Yuno devuelve este valor enmascarado, y muestra solo los últimos cuatro dígitos (por ejemplo, `*****3456`), debido a normas locales de protección de datos. Un valor enmascarado no es un número de teléfono válido: no lo envíes de nuevo en solicitudes posteriores (reembolsos, cancelaciones o nuevos pagos).

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.

**properties**

**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 considerada para la dirección de facturación (MAX 255; MIN 3).

Ejemplo: Bogotá

**country** `enum`

El país considerado para 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 considerado para la dirección de facturación (MAX 11; MIN 4).

Ejemplo: 111111

**neighborhood** `string`

El barrio de la línea de dirección del cliente (MAX 255; MIN 2).

Ejemplo: Barrio 11

**shipping\_address** `object`

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

**properties**

**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 considerado para 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

**neighborhood** `string`

El barrio de la línea de dirección del cliente (MAX 255; MIN 2).

Ejemplo: Barrio 11

**geolocation** `object`

Geolocalización del cliente.

**properties**

**latitude** `string`

Distancia angular de un lugar de la Tierra al sur o al norte del ecuador (MIN: 1, MAX:11)

Ejemplo: −34.4905

**longitude** `string`

Medida angular de la distancia de un lugar de la Tierra al este o al oeste del observatorio de Greenwich. (MIN: 1, MAX:11)

Ejemplo: −58.5555

**shipping** `object`

La selección de envío asociada al pago. Está presente solo cuando el pago tiene una, por ejemplo, cuando el cliente elige una dirección de envío guardada y un método de entrega dentro de un widget de wallet ([Fast Checkout shipping](https://docs.y.uno/es/docs/payment-features/fast-checkout-shipping.md)). La clave se omite cuando el pago no tiene selección de envío. Se devuelve en `GET /payments/{id}` y en los webhooks de pago. En `POST /payments` está presente solo en los flujos de one-time token donde el token ya incluye la selección; en Fast Checkout la selección llega después de la creación, mediante la notificación del proveedor.

**properties**

**method** `object`

El método de entrega que el cliente seleccionó.

**properties**

**id** `string`

El identificador del método de entrega definido por el comercio. Coincide con uno de los `shipping_methods[].id` enviados en la sesión de checkout.

Ejemplo: express

**label** `string`

La etiqueta visible del método de entrega.

Ejemplo: Express shipping

**amount** `object`

El costo de entrega, ya incluido en el monto del pago.

**properties**

**currency** `string`

La moneda del costo de entrega (ISO 4217). Es igual a la moneda del pago.

**value** `number`

El costo de entrega en unidades mayores.

**address** `object`

La dirección de envío que el cliente seleccionó.

**properties**

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

La línea principal de la dirección.

Ejemplo: 221B Baker Street

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

La línea secundaria de la dirección.

**city** `string`

El nombre de la ciudad.

**state** `string`

El estado o la región.

**zip\_code** `string`

El código postal.

**country** `string`

El código de país (ISO 3166-1 alpha-2).

Ejemplo: GB

**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á.

**properties**

**airline** `object`

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

**properties**

**pnr** `string`

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

Ejemplo: 1P-2UUGJW

**type** `enum`

Tipo de viaje.

Valores posibles: `ONE_WAY`, `ROUNDTRIP`, `MULTIPLE_DESTINATIONS`

**legs** `array of objects`

Especifica el arreglo de objetos de tramos.

**properties**

**order** `integer`

Un índice correlativo (empieza en 1) que describe el orden de los tramos en la misma ruta.

Ejemplo: 2

**route\_order** `integer`

Un índice correlativo (empieza en 1) que describe el orden de las rutas según el tiempo. Por ejemplo, si una orden contiene 2 rutas: New-York→London→Paris (conexión en London), New-York→London debe tener route\_order=1, order=1; London→Paris debe tener route\_order=1, order=2; Paris→London→New-York: Paris→London debe tener route\_order=2, order=1; London→New-York debe tener route\_order=2, order=2.

Ejemplo: 1

**arrival\_airport** `string`

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

Ejemplo: AMS

**arrival\_airport\_country** `string`

País del aeropuerto de llegada (MAX 2; MIN 2; ISO 3166-1).

Ejemplo: AR

**arrival\_airport\_city** `string`

La ciudad considerada para el aeropuerto de llegada (MAX 255; MIN 3).

Ejemplo: BUE

**arrival\_airport\_timezone** `string`

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

Ejemplo: -03:00

**arrival\_datetime** `timestamp`

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

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

**base\_fare** `float`

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

Ejemplo: 23.5676

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

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

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

**carrier\_code** `string`

Código de aerolínea IATA (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\_country** `string`

País del aeropuerto de salida (MAX 2; MIN 2; ISO 3166-1).

Ejemplo: AR

**departure\_airport\_city** `string`

La ciudad del aeropuerto de salida (MAX 2; MIN 2; ISO 3166-1).

Ejemplo: AR

**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, y ambos son
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. Consulta la referencia de información de aerolíneas.

Ejemplo: Y

**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 caracteres: O: escala permitida (la letra “O”, no el 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.

**properties**

**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

**document** `object`

Especifica el objeto de documento del pasajero.

**properties**

**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).

**phone** `object`

Especifica el objeto de teléfono del pasajero.

**properties**

**country\_code** `string`

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

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

**number** `string`

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

Ejemplo: 1130292837

**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 la [
Lista de niveles de fidelidad](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.

**properties**

**ticket\_number** `string`

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

Ejemplo: 7411823255523

**e\_ticket** `boolean`

¿Es un boleto electrónico?

Valores posibles: `True` or `False`

**restricted** `boolean`

Indica si el boleto es reembolsable o no.

Valores posibles: `True` or `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.

**properties**

**address** `string`

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

Ejemplo: Apartamento 502, Torre I

**zip\_code** `string`

Código postal del agente que vendió el boleto.

Ejemplo: 1636

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

Aerolínea emisora o validadora. Es el prefijo AWB (guía aérea), código numérico IATA de 3 dígitos (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 el punto de venta aparece en la lista de agencias o el nombre de la franquicia (MAX 32;
MIN
1\).

Ejemplo: ACME Agency Inc

**booking\_system\_code** `string`

Código del sistema de reservas que emite el boleto. (MAX 255; MIN 1).

Ejemplo: TEST001

**booking\_system\_name** `string`

Nombre del sistema de reservas que emite el boleto. (MAX 255; MIN 1).

Ejemplo: Booking system

**transport** `object`

Especifica el objeto de transporte.

**properties**

**id** `string`

El id del vehículo de transporte (MAX 255; MIN 1).

Ejemplo: ASONDAKS-1234

**order** `object`

Especifica el objeto de orden.

**properties**

**shipping\_amount** `float`

El monto de envío de la orden (múltiplo de 0.0001). Este campo es solo informativo: el monto de envío ya está incluido en el monto final de la transacción y no se suma por separado.

Ejemplo: 5190

**fee\_amount** `float`

El monto de la comisión de la orden (múltiplo de 0.0001). Este campo es solo informativo: el monto de la comisión ya está incluido en el monto final de la transacción y no se suma por separado.

Ejemplo: 789.50

**tip\_amount** `float`

El monto de la propina de la orden (múltiplo de 0.0001). Este campo es solo informativo: el monto de la propina ya está incluido en el monto final de la transacción y no se suma por separado.

Ejemplo: 215.10

**sales\_channel** `string`

Id del canal de ventas del pago. (MIN:3 y MAX:255)

Ejemplo: AA01

**taxes** `array of objects`

Especifica el objeto de impuestos de la orden.

**properties**

**type** `string`

Tipo de impuesto.

Ejemplo: VAT

**tax\_base** `float`

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

Ejemplo: 10000

**value** `float`

El monto del impuesto.

Ejemplo: 2100

**percentage** `float`

El porcentaje del impuesto.

Ejemplo: 21

**items** `array of objects`

Especifica el objeto del ítem.

**properties**

**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 ítems](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

**discounts** `array of objects`

Especifica el arreglo de objetos de descuentos de la orden (hasta 10). Cuando el pago incluye una promoción de Yuno, la línea `YUNO_PROMOTION` va primero y Yuno la completa. Consulta [Promociones](https://docs.y.uno/es/docs/payment-features/promotions).

**properties**

**type** `enum`

El tipo de la línea de descuento. Valores posibles, escritos exactamente así y en mayúsculas: `MERCHANT` (un descuento que calculaste tú; el valor por defecto) y `YUNO_PROMOTION` (una promoción, enviada como cotización o como código). Cualquier otra grafía devuelve `400`. Puedes omitirlo cuando la línea incluye un `quote_id`, o un `code` y ningún `id` ni `name`: la línea se interpreta como `YUNO_PROMOTION`. En una respuesta está presente cuando el pago incluye una promoción de Yuno.

Ejemplo: MERCHANT

**quote\_id** `string`

El id de la cotización de la promoción (MAX 1000, sin espacios en blanco). Obligatorio en una línea `YUNO_PROMOTION` que no incluye `code`. No se permite junto con un `code`, ni en líneas `MERCHANT`.

**code** `string`

El código de promoción que se canjea (MIN 3; MAX 32; letras, dígitos, `-` y `_`; Yuno elimina los espacios alrededor). Envíalo en una línea `YUNO_PROMOTION` en lugar de un `quote_id`: una línea lleva uno u otro, nunca ambos. En una línea `MERCHANT` (una línea con `type: MERCHANT`, o sin `type` y con un `id` o `name`) el código se ignora sin error y no se aplica ninguna promoción. Un código en blanco o con otro formato devuelve `400 INVALID_PARAMETERS`, igual que una segunda línea `YUNO_PROMOTION` en el pago y un pago enviado con `X-Dry-Run: true` (una prueba sin efecto no admite códigos de promoción: prueba los códigos en el sandbox). Consulta [Códigos de promoción](https://docs.y.uno/es/reference/payments/create-payment.md#promotion-codes) para ver las reglas y sus mensajes. Una respuesta nunca incluye el código: Yuno lo cambia por una cotización antes de crear el pago, por lo que la respuesta de Create Payment contiene la línea `YUNO_PROMOTION` completa, con el `quote_id` de esa cotización.

Ejemplo: SUMMER10

**id** `string`

ID del descuento (MAX 255; MIN 3). Obligatorio en líneas `MERCHANT` y no permitido en líneas `YUNO_PROMOTION`, donde Yuno lo completa con el id de la promoción.

Ejemplo: 10OFF

**name** `string`

El nombre del descuento (MAX 255; MIN 3). Obligatorio en líneas `MERCHANT` y no permitido en líneas `YUNO_PROMOTION`, donde Yuno lo completa con el nombre de la promoción cuando lo tiene.

Ejemplo: Offer

**unit\_amount** `float`

El monto del descuento (múltiplo de 0.0001), en la moneda del pago. Obligatorio en líneas `MERCHANT` y no permitido en líneas `YUNO_PROMOTION`, donde Yuno lo completa con el descuento de la promoción.

Ejemplo: 100

**discount\_indicator** `enum`

Indica si se aplicó un descuento a la línea. Valores posibles: `Y` y `N`.

**discount\_rate** `number`

La tasa de descuento aplicada a la línea (múltiplo de 0.0001).

**tickets** `array of objects`

Especifica el objeto de boletos.

**properties**

**id** `string`

Id del boleto (Min: 1, max:255)

Ejemplo: 3214

**name** `string`

Nombre del boleto (Min: 1, max:255)

Ejemplo: Concert

**description** `string`

Descripción del boleto (Min: 1, max:255)

Ejemplo: Concert

**type** `enum`

Tipo de boleto

VIRTUAL / PHYSICAL

**amount** `object`

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

**properties**

**currency** `enum`

La moneda usada 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: 111111

**event** `object`

Especifica el objeto de detalles del evento.

**properties**

**id** `string`

Id del evento relacionado con el boleto

Ejemplo: AA01

**name** `string`

Nombre del evento (Min: 1, max:255)

Ejemplo: Music

**description** `string`

Descripción del evento (Min: 1, max:255)

Ejemplo: festival

**type** `enum`

Tipo de evento

PARTY, UNIVERCITY, FESTIVAL, CIRCUS, SPORTS, CINEMA, THEATER, CONCERT, OTHERS.

**date** `date`

Fecha del evento

Ejemplo: 2025-10-25

**address** `object`

Especifica el objeto de dirección del evento.

**properties**

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

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

Ejemplo: Calle 34 # 56 - 78

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

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

Ejemplo: Apartamento 502, Torre I

**city** `string`

La ciudad considerada para la dirección del evento (MAX 255; MIN 3).

Ejemplo: Bogotá

**country** `enum`

El país considerado para la dirección del evento (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 considerado para la dirección del evento (MAX 255; MIN 3).

Ejemplo: Cundinamarca

**zip\_code** `string`

El código postal considerado para la dirección del evento (MAX 11; MIN 4).

Ejemplo: 111111

**shipping** `object`

Especifica el objeto de detalles de envío.

**properties**

**type** `enum`

Tipo de envío.

Ejemplo: STANDARD

Valores posibles del enum: consulta la [Referencia de envíos](https://docs.y.uno/es/reference/shipping-reference.md).

**description** `string`

La descripción del envío (MAX 255; MIN 1).

Ejemplo: Shipping of sample shirt

**carrier** `enum`

El transportista usado para la entrega.

Ejemplo: UPS

Valores posibles del enum: consulta la [Referencia de envíos](https://docs.y.uno/es/reference/shipping-reference.md).

**deliver\_at** `timestamp`

Fecha estimada de entrega (ISO 8601 MAX 27; MIN 27).

Ejemplo: 2025-09-17T20:43:54.786342Z

**account\_funding** `object`

Especifica la estructura de fondeo de cuenta para transferencias y pagos.

**properties**

**sender** `object`

Especifica la información del remitente.

**properties**

**national\_entity** `enum`

Tipo de entidad nacional del remitente. Valores posibles:

* `INDIVIDUAL`
* `ENTITY`

**first\_name** `string`

Nombre del remitente (MAX 80).

Ejemplo: John

**last\_name** `string`

Apellido del remitente (MAX 80).

Ejemplo: Doe

**legal\_name** `string`

Razón social del destinatario. Obligatoria si `national_entity` es `ENTITY` (MAX 80).

Ejemplo: Arcos dorados S.A.

**email** `string`

Email del remitente (MAX 255; MIN 3).

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

**country** `enum`

País del remitente (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** `date`

Fecha de nacimiento del remitente en formato `YYYY-MM-DD` (MAX 10; MIN 10).

Ejemplo: 1990-02-28

**phone** `object`

Especifica el objeto de teléfono.

**properties**

**country\_code** `string`

Código de país del teléfono del remitente (MAX 3; MIN 2).

Ejemplo: 57

**number** `string`

Número de teléfono del remitente (MAX 32; MIN 1).

Ejemplo: 3132450765

**document** `object`

Especifica el objeto de documento.

**properties**

**document\_number** `string`

Documento de identidad nacional del remitente (MAX 40; MIN 3).

Ejemplo: 1093333333

**document\_type** `enum`

Tipo de documento del remitente (MAX 6; MIN 2).

Ejemplo: CC

**address** `object`

Especifica el objeto de dirección.

**properties**

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

Dirección de facturación principal (MAX 255; MIN 3).

Ejemplo: Calle 34 # 56 - 78

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

Dirección de facturación secundaria (MAX 255; MIN 3).

Ejemplo: Apartamento 502, Torre I

**city** `string`

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

Ejemplo: Bogota

**country** `enum`

País de la dirección de facturación (ISO 3166-1; MAX 2; MIN 2).

Ejemplo: CO

**state** `string`

Estado o provincia de la dirección de facturación (MAX 255; MIN 3).

Ejemplo: Cundinamarca

**zip\_code** `string`

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

Ejemplo: 111111

**recipient** `object`

Especifica la información del destinatario.

**properties**

**national\_entity** `enum`

Tipo de entidad nacional del destinatario. Valores posibles:

* `INDIVIDUAL`
* `ENTITY`

**first\_name** `string`

Nombre del remitente (MAX 80).

Ejemplo: John

**last\_name** `string`

Apellido del remitente (MAX 80).

Ejemplo: Doe

**legal\_name** `string`

Razón social del destinatario. Obligatorio si `national_entity` es `ENTITY` (MAX 80).

Ejemplo: Arcos dorados S.A.

**email** `string`

Email del destinatario (MAX 255; MIN 3).

Ejemplo: [recipient@example.com](mailto:recipient@example.com)

**country** `enum`

País del destinatario (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** `date`

Fecha de nacimiento del destinatario en formato `YYYY-MM-DD` (MAX 10; MIN 10).

Ejemplo: 1985-07-15

**phone** `object`

Especifica el objeto de teléfono.

**properties**

**country\_code** `string`

Código de país del teléfono del destinatario (MAX 3; MIN 2).

Ejemplo: 57

**number** `string`

Número de teléfono del destinatario (MAX 32; MIN 1).

Ejemplo: 3132450765

**document** `object`

Especifica el objeto de documento.

**properties**

**document\_number** `string`

Documento nacional de identidad del destinatario (MAX 40; MIN 3).

Ejemplo: 1093333333

**document\_type** `enum`

Tipo de documento del destinatario (MAX 6; MIN 2).

Ejemplo: CC

**address** `object`

Especifica el objeto de dirección.

**properties**

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

Dirección de facturación principal (MAX 255; MIN 3).

Ejemplo: Calle 34 # 56 - 78

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

Dirección de facturación secundaria (MAX 255; MIN 3).

Ejemplo: Apartamento 502, Torre I

**city** `string`

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

Ejemplo: Bogota

**country** `enum`

País de la dirección de facturación (ISO 3166-1; MAX 2; MIN 2).

Ejemplo: CO

**state** `string`

Estado o provincia de la dirección de facturación (MAX 255; MIN 3).

Ejemplo: Cundinamarca

**zip\_code** `string`

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

Ejemplo: 111111

**seller\_details** `object`

Especifica el objeto de detalles del vendedor.

**properties**

**name** `string`

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

Ejemplo: Jhon Doe

**email** `string`

Email del vendedor (MAX 255; MIN 3).

Ejemplo: [jhondoe@business.com](mailto:jhondoe@business.com)

**reference** `string`

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

Ejemplo: Seller

**website** `string`

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

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

**industry** `enum`

Industria del vendedor (MAX 255; MIN 3).

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

**merchant\_category\_code** `string`

MCC: el código de categoría del comercio (MAX 235; MIN 1).

Ejemplo: 6199

**country** `enum`

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 de documento del vendedor.

**properties**

**document\_number** `string`

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

Ejemplo: 1093333333

**document\_type** `enum`

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 de número de teléfono del vendedor.

**properties**

**country\_code** `string`

Código de 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`

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 de dirección del vendedor.

**properties**

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

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

Ejemplo: Calle 34 # 56 - 78

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

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

Ejemplo: Apartamento 502, Torre I

**city** `string`

Ciudad considerada para la dirección del vendedor (MAX 255; MIN 3).

Ejemplo: Bogotá

**country** `enum`

País considerado para 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`

Estado considerado para la dirección del vendedor (MAX 255; MIN 3).

Ejemplo: Cundinamarca

**zip\_code** `string`

Código postal considerado para la dirección del vendedor (MAX 11; MIN 4).

Ejemplo: 111111

**transportations** `array of objects`

Especifica el arreglo de objetos de transportes.

**properties**

**id** `string`

El id de la reserva de transporte (MAX 255; MIN 1).

**description** `string`

La descripción de la reserva de transporte (MAX 255; MIN 1).

**type** `string`

El tipo de reserva de transporte.

**legs** `array of objects`

Especifica el arreglo de objetos de tramos.

**properties**

**order** `integer`

Un índice correlativo (comienza en 1) que describe el orden de los tramos en la misma ruta.

**route\_order** `integer`

Un índice correlativo (comienza en 1) que describe el orden de las rutas por tiempo.

**departure\_country** `string`

País de salida (MAX 2; MIN 2; ISO 3166-1).

**departure\_city** `string`

Ciudad de salida (MAX 255; MIN 1).

**departure\_timezone** `string`

Zona horaria de salida (MAX 6; MIN 6).

**departure\_datetime** `string`

Fecha y hora de salida en la hora local del lugar de salida.

**departure\_reference** `string`

Referencia de la salida (MAX 255; MIN 1).

**arrival\_country** `string`

País de llegada (MAX 2; MIN 2; ISO 3166-1).

**arrival\_city** `string`

Ciudad de llegada (MAX 255; MIN 1).

**arrival\_timezone** `string`

Zona horaria de llegada (MAX 6; MIN 6).

**arrival\_datetime** `string`

Fecha y hora de llegada en la hora local del lugar de llegada.

**arrival\_reference** `string`

Referencia de la llegada (MAX 255; MIN 1).

**transport** `object`

Especifica el objeto de transporte.

**properties**

**id** `string`

El id del vehículo de transporte (MAX 255; MIN 1).

**type** `string`

El tipo de vehículo de transporte.

**description** `string`

La descripción del vehículo de transporte (MAX 255; MIN 1).

**transactions** `object`

Especifica los detalles de la transacción asociados a un pago. Retrieve Payment los devuelve como un arreglo, con una entrada por transacción.

**properties**

**id** `string`

El identificador único de la transacción (MAX 64; MIN 36).

Ejemplo: 7bf8f1f6-4081-41ec-a024-a927056e00ab

**type** `string`

El tipo de transacción.

Ejemplo: PURCHASE

**status** `enum`

El estado de la transacción.

Ejemplo: SUCCEEDED

**category** `string`

La categoría del método de pago usado en la transacción.

Ejemplo: CARD

**amount** `number`

El monto de la transacción. Para un pago con una promoción de Yuno, es el monto cobrado: `amount.value` menos `discount_amount`.

Ejemplo: 100

**provider\_id** `string`

El id del proveedor que procesó la transacción.

Ejemplo: DLOCAL

**simplified\_mode** `boolean`

Cuando es `true` , Yuno reintenta automáticamente las operaciones de captura o cancelación si fallan. El valor predeterminado es `false` . También puedes ver este campo en `delayed_capture_settings` o `delayed_cancel_settings` . Para consultar el calendario completo de reintentos, consulta [Reintentos de transacciones](https://docs.y.uno/es/docs/payment-features/transaction-retries.md) y [Flujo de cancelación y captura](https://docs.y.uno/es/docs/payment-features/Cancel-and-capture-flow.md) .

Ejemplo: false

**receipt** `boolean`

Indica si se solicitó o generó un recibo para el cliente en esta transacción. Cuando es `true` , puede estar disponible `receipt_url`.

Ejemplo: false

**receipt\_url** `string | null`

URL donde puedes acceder al recibo generado para esta transacción (por ejemplo, un PDF o una página alojada). `null` si aún no hay un recibo disponible. Usa el endpoint Retrieve Payment by ID y revisa este campo en el objeto `payment.transaction`.

Ejemplo: null

**receipt\_language** `string | null`

Código de idioma del recibo generado (por ejemplo, `EN` , `ES` , `PT` ). `null` si no se ha generado un recibo o no se especificó un idioma.

Ejemplo: EN

**payment\_method** `object`

Especifica los detalles del método de pago usado en la transacción.

**properties**

**vaulted\_token** `string`

El vaulted token de un payment\_method almacenado previamente. Si se crea un pago con un
vaulted\_token, no es necesario enviar también un token, y se puede definir como null (MAX: 64; MIN: 36).

Ejemplo: 8604911d-5ds9-229e-8468-bd41abear14s

**type** `string`

Tipo de método de pago. Obligatorio para el flujo `DIRECT` o `REDIRECT`. Es obligatorio al integrar billeteras, incluso al usar el SDK.

Valores posibles del enum:

Valores posibles del enum: Consulta la [referencia de tipos de pago](https://docs.y.uno/es/reference/payment-type-list.md).

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

Indicador para inscribir la tarjeta después de un pago exitoso.

Valores posibles: `True` o `False`

**token** `string`

El token del método de pago de un solo uso que proporciona el sdk de Yuno . Si se crea un pago con un
token, no es necesario enviar también un vaulted\_token, y se puede definir como null. No es necesario para
pagos back to back (MAX: 64; MIN: 36).

Ejemplo: 5104911d-5df9-229e-8468-bd41abea1a4s

**parent\_payment\_method\_type** `enum`

Cuando usas una billetera para pagos mediante una [integración directa](https://docs.y.uno/es/docs/direct-integration-use-cases/direct-flow.md) , este campo indica el proveedor del que se obtuvo la información de la tarjeta.

Ejemplo: APPLE\_PAY

**payment\_method\_detail** `object`

Especifica el objeto de detalle del método de pago, que proporciona detalles de las distintas
categorías
de transacción que forman parte del objeto del método de pago.

**properties**

**card** `object`

Especifica los detalles del método de pago cuando se usa una tarjeta.

**properties**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un
monto real.

Valores posibles: `True` o `False`

**capture** `boolean`

Decide si se autoriza el pago o se captura. Autorizar un pago con tarjeta te permite
reservar
fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**first\_installments\_deferral** `integer`

Número de meses de espera para debitar la primera cuota.

Ejemplo: 1

**installments\_type** `string`

Tipo de cuotas usado en el pago con tarjeta.

Ejemplo: string

**installments\_amount** `integer`

El monto de la cuota incluye los intereses asociados a la cuota y la información
la define
el proveedor.

Ejemplo: 3

**soft\_descriptor** `string`

El descriptor que se envía por transacción a nuestra plataforma. Se mostrará en el
estado de cuenta bancario físico del cliente (MAX 15; MIN 0).

Ejemplo: COMPANY1

**authorization\_code** `string`

El código de respuesta del adquirente.

Ejemplo: 742A64

**retrieval\_reference\_number** `integer`

El identificador único que asigna un adquirente a una autorización. En el caso de Brasil, recibirás el nsu.

Ejemplo: 200000000012

**acquirer\_reference\_number** `string`

El identificador único que asigna el adquirente de la tarjeta para rastrear la transacción a través de la red de tarjetas. Se usa para la conciliación y los contracargos.

Para los proveedores que devuelven una referencia del adquirente (por ejemplo, Adyen), este campo contiene ese valor, y `retrieval_reference_number` puede estar vacío para esos proveedores.

Ejemplo: 7C9F8E2A1B3D

**par** `string`

La Referencia de cuenta de pago (PAR) de la tarjeta, tal como la devuelve el proveedor. Una PAR identifica la cuenta del titular de la tarjeta a través del número de tarjeta y sus network tokens, por lo que la misma cuenta conserva una sola PAR.

Se devuelve en pagos con tarjeta con o sin network token. Cuando el pago usa un network token, `card_data.network_token.par` lleva el mismo valor. El campo se omite cuando el proveedor no envía una PAR.

Ejemplo: V0010013019000000000000000001

**voucher** `string`

El identificador único del comprobante de pago que asigna el banco emisor para una
transacción con tarjeta.
Este campo está vacío si el gateway no proporciona información sobre la transacción (MAX 255; MIN
3\).

Ejemplo: 43564

**card\_data** `object`

Especifica los detalles de la tarjeta.

**properties**

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en la tarjeta (MAX 26; MIN 2), solo disponible para comercios
con certificación PCI.

Ejemplo: Fannie Weissnat

**iin** `integer`

El número de identificación del emisor (IIN) corresponde a los primeros dígitos del número de la tarjeta
de pago emitida por una institución financiera (MAX 8; MIN 6).

Ejemplo: 41961111

**lfd** `integer`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 2; MIN 1).

Ejemplo: 16

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: VISA

**issuer\_name** `string`

El emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: Banco Galicia

**category** `string`

La categoría del emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: Gold

**type** `string`

El tipo de emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: CREDIT, DEBIT, or CHARGE\_CARD

`fingerprint` string
Cuando un cliente inscribe una tarjeta de crédito varias veces en relación con una o varias cuentas de Yuno, se generan varios vaulted\_tokens, pero el fingerprint te permite identificar cuándo se usa la misma tarjeta para el cliente (MAX 255; MIN 3).
Ejemplo: 55a7fe38-cdc3-45dc-8c5f-820751799c76

**three\_d\_secure** `object`

Especifica los detalles de la transacción 3DS.

**properties**

**three\_d\_secure\_setup\_id** `string`

ID de configuración obtenido para el flujo 3DS Direct.

Ejemplo: 24127d61-b852-42fb-acd4-1ee661645376

**version** `enum`

Indica la versión del protocolo de la especificación EMV 3-D Secure utilizada. 1.0, 2.0, 2.1.0,
2.2.0, 2.2.1.

Ejemplo: 2.2.1

**electronic\_commerce\_indicator** `string`

Este campo debe completarse con el resultado del campo [ECI](https://docs.y.uno/es/reference/eci-indicators-list.md) proporcionado por el servicio de 3D Secure.
El indicador de comercio electrónico (ECI) informa al emisor de la tarjeta si la transacción estaba
protegida por un protocolo de seguridad como VbV o MCSC. Visa y MasterCard exigen que
todas las transacciones 3-D Secure tengan este valor en la solicitud de autorización (MAX: 2,
MIN: 0).

Ejemplo: 04

**cryptogram** `string`

Este campo debe completarse con el resultado del campo cryptogram proporcionado por el
servicio de 3D Secure. En las transacciones de Visa, representa el Cardholder Authentication Verification
Value (CAVV), un valor criptográfico generado por el emisor como evidencia de la autenticación del pago
durante la compra en línea para calificar a la protección contra contracargos. Las transacciones de MasterCard
tienen un valor similar llamado Accountholder Authentication Value (AAV) o
Universal Cardholder Authentication Field (UCAF). Al enviar una transacción para
autorización, el comercio debe incluir el CAVV o el AAV/UCAF para demostrar que el titular de la tarjeta
fue autenticado. Normalmente está codificado en base64 (MAX: 40, MIN: 0).

Ejemplo: BA0BB1Z3N5Q4kjkBU3c3ELGUsJY =

**transaction\_id** `string`

Para 3DS v1:
Este es el identificador único de la transacción. Lo genera automáticamente el MPI. Normalmente
tiene una longitud de 28 bytes y está codificado en base64. Se conoce comúnmente como XID (MAX: 40, MIN:
0\).
Para 3DS v2:
Identificador único universal de la transacción asignado por el DS para identificar una sola transacción.
(MAX: 36, MIN:36).

Ej. para V1: “TjY0MjAxRjA4MD4987DUzMzYyNjU=”
Ej. para V2: “c4e59ceb-a382-4d6a-bc87-385d591fa09d”

**directory\_server\_transaction\_id** `string`

ID de la transacción generado por el servidor de directorio de Mastercard durante la autenticación (MAX
255; MIN 3).

Ejemplo: f38e6948-5388-41a6-bca4-b49723c19437

**pares\_status** `string`

Indica el resultado de la autenticación del titular de la tarjeta durante el proceso de 3-D Secure. Te informa si la autenticación fue exitosa (Y), falló (N), no pudo completarse (U) o solo se intentó (A).

Ejemplo: Y

**has\_challenge** `boolean`

Indica si ocurrió un desafío de 3DS. Cuando es `false` , el flujo puede ser sin fricción o de solo datos. El flujo de solo datos no se marca explícitamente en la respuesta.

Ejemplo: false

**acs\_id** `string`

Identificador único proporcionado por el Access Control Server (ACS) durante el proceso de autenticación de 3-D Secure.

Ejemplo: ACS-1234567890

**liability\_shift** `boolean`

Indica si la responsabilidad por fraude pasó del comercio al emisor de la tarjeta como resultado de la autenticación 3DS. `true` significa que el emisor asume la responsabilidad por las disputas de fraude de esta transacción; `false` significa que el comercio la conserva. Este campo también puede ser `null`, incluso en algunos casos de autenticación exitosa; si lo usas para gestionar contracargos y ves `null` de forma inesperada, contacta al soporte de Yuno.

Ejemplo: true

**network\_token** `object`

Información sobre el network token usado para la transacción. Si aplica.

**properties**

**network** `enum`

El proveedor asociado al token proporcionado. VISA, MASTERCARD, AMERICAN\_EXPRESS.

Ejemplo: MASTERCARD

**status** `enum`

Estado del token para el método de pago. CREATED, ACTIVE, SUSPENDED, CANCELED.

Ejemplo: ACTIVE

**par** `string`

Referencia de la cuenta de pago.

Ejemplo: MCC123456789012

**token\_data** `object`

Detalles del token.

**properties**

**number** `number`

\[Obligatorio] Número del token sin separadores (MAX 19; MIN 8), disponible solo para comercios con certificación PCI.

Ejemplo: 450799000001234

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en el Token (MAX 26; MIN 2).

Ejemplo: John Doe

**iin** `number`

El número de identificación de la institución (IIN) corresponde a los primeros dígitos de un número de network token emitido por una institución financiera (MAX 8; MIN 6).

Ejemplo: 45079900

**lfd** `number`

Últimos cuatro dígitos del network token (MAX 4; MIN 4).

Ejemplo: 1234

**expiration\_month** `number`

Mes de vencimiento del network token (MM) (MAX 2; MIN 2).

Ejemplo: 12

**expiration\_year** `number`

Año de vencimiento del network token (YYYY) (MAX 4; MIN 2).

Ejemplo: 2027

**cryptogram** `string`

\[Obligatorio] - El criptograma único generado por el emisor para el network token usado en la transacción.

**electronic\_commerce\_indicator** `string`

\[Obligatorio solo para ciertos proveedores] - Si el token fue autenticado por Mastercard, el campo debe establecerse en 02. Para Visa o tokens no autenticados, no es necesario enviar el campo.

**token\_requestor\_id** `string`

\[Obligatorio solo para ciertos proveedores] - ID del solicitante del token del comercio

**response** `object`

Detalles de la transacción de red.

**properties**

**code** `number`

Código de respuesta del proveedor de servicios.

Ejemplo: succeeded

**message** `number`

Código de respuesta del proveedor de servicios.

Ejemplo: Transaction Succeeded

**stored\_credentials** `object`

Indica el tipo de procesamiento de la transacción.

**properties**

**reason** `enum`

Indica el tipo de procesamiento de la transacción. Valores posibles del enum: CARD\_ON\_FILE, SUBSCRIPTION, UNSCHEDULED\_CARD\_ON\_FILE

Ejemplo: SUBSCRIPTION

**usage** `enum`

Este campo te permite indicar si es la primera vez que el vaulted\_token/network\_token se usa para un pago o si ya se usó en un pago anterior. Valores posibles del enum: FIRST, USED

Ejemplo: USED

**subscription\_agreement\_id** `string`

Este campo te permite indicar la identificación del acuerdo con el cliente para una suscripción. Principalmente para MX (MAX 255; MIN 3).

Ejemplo: AA0001

**network\_transaction\_id** `string`

Identificador único asignado a una transacción por la red de tarjetas. Se usa para rastrear y referenciar transacciones específicas, en particular en escenarios de pagos recurrentes, y garantiza consistencia y trazabilidad a lo largo del ciclo de vida del pago (MAX 255; MIN 3).

Ejemplo: 583103536844189

**wallet** `object`

Especifica los detalles del método de pago cuando se usa una billetera.

**properties**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un monto
real.

Valores posibles: `True` o `False`

**cryptogram** `string`

Criptograma para integraciones directas con billeteras de tarjetas (MAX 526; MIN 3).

**capture** `boolean`

Define si se autoriza el pago o se captura. Autorizar un pago con tarjeta te permite
reservar
fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**payment\_method\_id** `string`

El método de pago del usuario usado en su billetera.

Ejemplo: credit\_card

**detail** `string`

El detalle del método de pago usado en su billetera.

Ejemplo: visa

**money\_release\_date** `date`

Fecha en la que el dinero del proveedor estará disponible para usar.

Ejemplo: 2022-05-09T00:00:00.000000Z

**sponsor\_id** `string`

Cuenta del proveedor del socio (MAX 255; MIN 3).

Ejemplo: 4562103

**authorization\_code** `string`

Código de respuesta del adquirente.

Ejemplo: 742A64

**expires\_at** `timestamp`

Fecha de vencimiento del método de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**redirect\_url** `string`

La URL a la que redirigir a tu cliente para completar el pago con la billetera.

Ejemplo: [https://www.company.com/wallet\_1231324](https://www.company.com/wallet_1231324)

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**email** `string`

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

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

**first\_name** `string`

El nombre del cliente (MAX 32, MIN 8).

Ejemplo: John

**last\_name** `string`

El apellido del cliente (MAX 32, MIN 8).

Ejemplo: Doe

**username** `string`

El nombre de usuario del cliente en la plataforma (MAX 32, MIN 8).

Ejemplo: John\_Doe\_01

**identification\_type** `string`

El tipo de documento del cliente (MAX 32, MIN 8).

Consulta la [
Referencia de países](https://docs.y.uno/es/reference/country-reference.md). Ejemplo: DNI

**identification\_number** `string`

El número de identificación del cliente (MAX 32, MIN 8).

Ejemplo: 34566123

**fee\_details** `object`

Especifica los detalles de las comisiones.

**properties**

**amount** `float`

Monto de la transacción (múltiplo de 0.0001).

Ejemplo: 40.5

**card\_data** `object`

Especifica los detalles de la tarjeta.

**properties**

**iin** `integer`

El número de identificación del emisor (IIN) corresponde a los primeros dígitos del número de la tarjeta
de pago emitida por una institución financiera (MAX 8; MIN 6).

Ejemplo: 45079900

**lfd** `integer`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 19; MIN 8).

Ejemplo: 19

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: visa

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en la tarjeta (MAX 26; MIN 2), disponible solo para comercios
con certificación PCI.

Ejemplo: JOHN DOE

**bnpl** `object`

Especifica los detalles del método de pago cuando se usa BNPL.

**properties**

**installments** `integer`

Las cuotas del préstamo (MAX 50; MIN 1).

Ejemplo: 10

**provider\_image** `string`

La URL del proveedor (MAX 255; MIN 3).

Ejemplo: [https://www.company.com/](https://www.company.com/)

**redirect\_url** `string`

La URL con la versión completa del ticket, por si quieres redirigir a tu cliente (MAX
255;
MIN
3\).

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**expires\_at** `timestamp`

Fecha de vencimiento del método de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**name** `string`

El nombre legal del cliente (MAX 32, MIN 8).

Ejemplo: Legal name

**username** `string`

El nombre de usuario del cliente en la plataforma del proveedor (MAX 32, MIN 8).

Ejemplo: Legal\_name\_01

**tax\_id\_type** `string`

El identificador fiscal del cliente (MAX 32, MIN 8).

Ejemplo: CUIT

**tax\_id** `string`

El número del identificador fiscal del cliente (MAX 32, MIN 8).

Ejemplo: 20-34566123-7

**type** `string`

El tipo de crédito (MAX 255; MIN 3).

Ejemplo: PERSONAL/BUSINESS

**area** `string`

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

Ejemplo: OTHERS

**role** `string`

El rol del cliente en la empresa (MAX 255; MIN 3).

Ejemplo: OWNER

**bank\_transfer** `object`

Especifica los detalles del método de pago cuando se usa transferencia bancaria.

**properties**

**provider\_image** `string`

La URL del proveedor (MAX 255; MIN 3).

Ejemplo: [https://www.company.com/logo](https://www.company.com/logo)

**account\_type** `string`

Tipo de cuenta bancaria (MAX 255; MIN 3).

Ejemplo: CHECKINGS/SAVINGS

**bank\_name** `string`

Nombre del banco asociado a la cuenta (MAX 255; MIN 3).

Ejemplo: Banco Galicia

**bank\_id** `string`

Identificador del banco seleccionado cuando el proveedor exige elegir uno. Se devuelve solo si el comercio envió un valor.

Ejemplo: galicia

**beneficiary\_name** `string`

El nombre del titular de la cuenta (MAX 255; MIN 3).

Ejemplo: John Doe

**bank\_account** `string`

El número de la cuenta bancaria (MAX 255; MIN 3).

Ejemplo: 54653211313333

**bank\_account\_2** `string`

El número secundario de la cuenta bancaria (MAX 255; MIN 3).

Ejemplo: 78900000000123

**beneficiary\_document\_type** `string`

Tipo de documento del titular de la cuenta (MAX 255; MIN 3).

Valores posibles: consulta la [
Referencia de países](https://docs.y.uno/es/reference/country-reference.md). Ejemplo: DNI

**beneficiary\_document** `string`

Número de documento del titular de la cuenta (MAX 255; MIN 3).

Ejemplo: 54666897

**reference** `string`

Código de referencia del usuario (MAX 255; MIN 3).

Ejemplo: AA01234-BC

**retrieval\_reference\_number** `string`

El identificador único asignado por un adquirente a una autorización. En el caso de Brasil, recibirás el nsu.

Ejemplo: 200000000012

**acquirer\_reference\_number** `string`

El identificador único asignado por el adquirente de la tarjeta para rastrear la transacción a través de la red de tarjetas. Se usa para conciliación y contracargos.

Para los proveedores que devuelven una referencia del adquirente (por ejemplo, Adyen), este campo contiene ese valor, y `retrieval_reference_number` puede estar vacío para esos proveedores.

Ejemplo: 7C9F8E2A1B3D

**par** `string`

La Referencia de cuenta de pago (PAR) de la tarjeta, tal como la devuelve el proveedor. Una PAR identifica la cuenta del titular de la tarjeta a través del número de tarjeta y sus network tokens, por lo que la misma cuenta conserva una sola PAR.

Se devuelve en pagos con tarjeta con o sin network token. Cuando el pago usa un network token, `card_data.network_token.par` lleva el mismo valor. El campo se omite cuando el proveedor no envía una PAR.

Ejemplo: V0010013019000000000000000001

**payment\_instruction** `string`

Instrucciones de pago relacionadas con el pago (MAX 255; MIN 3).

Ejemplo: Go to your bank account and transfer the amount using the reference detailed
below

**redirect\_url** `string`

La URL con la versión completa del ticket, por si quieres redirigir a tu cliente (MAX
255;
MIN
3\).

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**expires\_at** `timestamp`

Fecha de vencimiento del método de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**ticket** `object`

Especifica los detalles del método de pago al usar ticket.

**properties**

**type** `string`

El tipo del ticket.

Ejemplo: number, barcode, custom, reference\_code, qr

**benefit\_type** `enum`

Tipo de beneficio del usuario para el método de pago ticket. JUNAEB, PRIVATE

Ejemplo: PRIVATE

**provider\_number** `integer`

El número del ticket.

Ejemplo: 13141

**provider\_barcode** `string`

El código de barras del ticket, como valor de texto. Para la imagen del código de barras, consulta `provider_logo`.

Ejemplo: 456789009878765u7654

**provider\_logo** `string`

El logo del ticket.

Ejemplo: [https://www.company.com/logo](https://www.company.com/logo)

**provider\_format** `string`

El formato del ticket.

Ejemplo: barcode, custom

**payment\_instruction** `string`

Instrucciones de pago relacionadas con el pago (MAX 255; MIN 3).

Ejemplo: Go to your closest store and pay the total amount using the reference detailed below

**redirect\_url** `string`

La URL con la versión completa del ticket.

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**expires\_at** `timestamp`

Fecha de vencimiento del método de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**payment\_link** `object`

Especifica los detalles del método de pago al usar un enlace de pago.

**properties**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un
monto real.

Valores posibles: `True` o `False`

**capture** `boolean`

Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta te permite
reservar
fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**expires\_at** `timestamp`

Fecha de vencimiento del método de pago. "yyyy-MM-dd HH:mm:ss.SSSz"

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

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**payment\_method\_id** `string`

El método de pago del usuario utilizado en su billetera.

Ejemplo: credit\_card

**detail** `string`

El detalle del método de pago utilizado en su billetera.

Ejemplo: visa

**money\_release\_date** `date`

Fecha en la que el dinero del proveedor estará disponible para usar.

Ejemplo: 2022-05-09T00:00:00.000000Z

**sponsor\_id** `string`

Cuenta del socio en el proveedor (MAX 255; MIN 3).

Ejemplo: 4562103

**authorization\_code** `string`

Código de respuesta del adquirente.

Ejemplo: 742A64

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**email** `string`

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

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

**first\_name** `string`

El nombre del cliente (MAX 32, MIN 8).

Ejemplo: John

**last\_name** `string`

El apellido del cliente (MAX 32, MIN 8).

Ejemplo: Doe

**username** `string`

El nombre de usuario del cliente en la plataforma (MAX 32, MIN 8).

Ejemplo: John\_Doe\_01

**identification\_type** `string`

El tipo de documento del cliente (MAX 32, MIN 8).

Valores posibles: consulta la [
Referencia de países](https://docs.y.uno/es/reference/country-reference.md). Ejemplo: DNI

**identification\_number** `string`

El número de identificación del cliente (MAX 32, MIN 8).

Ejemplo: 34566123

**fee\_details** `object`

Especifica los detalles de las comisiones.

**properties**

**amount** `float`

Monto de la transacción (múltiplo de 0.0001).

Ejemplo: 40.5

**card\_data** `object`

Especifica los detalles de la tarjeta.

**properties**

**iin** `integer`

El número de identificación del emisor (IIN) corresponde a los primeros dígitos de la tarjeta de pago
emitida por una institución financiera (MAX 8; MIN 6).

Ejemplo: 45079900

**lfd** `integer`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 19; MIN 8).

Ejemplo: 19

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: visa

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en ella (MAX 26; MIN 2), solo disponible para comercios
certificados PCI.

Ejemplo: John Doe

**response\_code** `string`

El código que representa la respuesta del resultado de la transacción.

Ejemplo: SUCCEEDED

**response\_message** `string`

La descripción de response\_code.

Ejemplo: Transaction successful

**reason** `string`

El motivo de la transacción. Aplica a transacciones secundarias, como reembolsos o capturas.

Valores posibles: `CANCELLED`, `DISMISS`, `DUPLICATE`, `DUPLICATED`, `FRAUDULENT`, `MISSED`, `NOT_FOUND`, `ORDER_STOPPED`, `REFUNDED`, `REQUESTED_BY_CUSTOMER`, `RESOLVED`, `REVERSE`, `SERVICE_SUSPENDED`

**description** `string`

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

Ejemplo: Purchase on web

**merchant\_reference** `string`

La referencia generada por el comercio para identificar el pago o la transacción.

Ejemplo: AA01

**merchant\_advice\_code** `enum`

Merchant Advice Code normalizado para transacciones rechazadas; úsalo para orientar el comportamiento de reintento y el enrutamiento.

Ejemplo: TRY\_AGAIN\_LATER

**merchant\_advice\_code\_message** `string`

Mensaje legible que explica la recomendación devuelta en `merchant_advice_code` .

Ejemplo: Retry within 24 hours

**provider\_data** `object`

Especifica los datos del proveedor que procesó el pago.

**properties**

**id** `string`

El id del proveedor que procesó el pago.

Ejemplo: DLOCAL

**transaction\_id** `string`

El id de la transacción del proveedor.

Ejemplo: 5a1fa541-5fa2-496e-9fdc-29b34e09a107

**third\_party\_account\_id** `string`

El id de la cuenta del procesador del proveedor. Si aplica.

Ejemplo: AA001298

**third\_party\_transaction\_id** `string`

El id de la transacción del procesador del proveedor. Si aplica.

Ejemplo: 1309982

**account\_id** `string`

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

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

**status** `enum`

El estado de la transacción.

Ejemplo: SUCCEEDED

**status\_detail** `string`

El status\_detail de la transacción.

Ejemplo: APPROVED

**merchant\_advice\_code** `string`

Merchant Advice Code sin procesar devuelto por el proveedor para transacciones rechazadas.

Ejemplo: 25

**merchant\_advice\_code\_message** `string`

Mensaje del proveedor que explica el significado del Merchant Advice Code sin procesar.

Ejemplo: Retry after 24 hours

**response\_code** `string`

El código que representa la respuesta del resultado de la transacción del proveedor.

Ejemplo: SUCCEEDED

**response\_message** `string`

Mensaje con información adicional sobre el estado de la operación.

Ejemplo: Successful transaction

**iso8583\_response\_code** `object`

El código del estándar internacional para mensajería de intercambio originada por tarjetas de transacciones financieras ( [ISO 8583](https://en.wikipedia.org/wiki/ISO_8583) ).

Ejemplo: 00

**iso8583\_response\_message** `object`

El mensaje del estándar internacional para mensajería de intercambio originada por tarjetas de transacciones financieras ( [ISO 8583](https://en.wikipedia.org/wiki/ISO_8583) ).

Ejemplo: Approved or completed successfully

**raw\_notification** `array of object`

La notificación directa del proveedor para la transacción. El formato del objeto depende de la
respuesta del proveedor.

Ejemplo: JSON, XML, string

**detail** `object`

Especifica el objeto de detalle del método de pago devuelto por el proveedor, que especifica los detalles de los
distintos
tipos de categoría de transacción.

**properties**

**card** `object`

Especifica los detalles del método de pago al usar una tarjeta.

**properties**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un
monto real.

Valores posibles: `True` o `False`

**capture** `boolean`

Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta te permite
reservar
fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**first\_installments\_deferral** `integer`

Número de meses de espera para debitar la primera cuota.

Ejemplo: 1

**installments\_type** `string`

Tipo de cuotas utilizado en el pago con tarjeta.

Ejemplo: string

**installments\_amount** `integer`

El monto de la cuota incluye los intereses asociados a la cuota y la información
la define
el proveedor.

Ejemplo: 3

**soft\_descriptor** `string`

El descriptor enviado por transacción a nuestra plataforma. Se mostrará en el
extracto bancario físico del cliente (MAX 15; MIN 0).

Ejemplo: COMPANY1

**authorization\_code** `string`

El código de respuesta del adquirente.

Ejemplo: 742A64

**retrieval\_reference\_number** `integer`

El identificador único asignado por un adquirente a una autorización. En el caso de Brasil, recibirás el nsu.

Ejemplo: 200000000012

**acquirer\_reference\_number** `string`

El identificador único asignado por el adquirente de la tarjeta para rastrear la transacción a través de la red de tarjetas. Se usa para la conciliación y los contracargos.

Para los proveedores que devuelven una referencia del adquirente (por ejemplo, Adyen), este campo contiene ese valor, y `retrieval_reference_number` puede estar vacío para esos proveedores.

Ejemplo: 7C9F8E2A1B3D

**par** `string`

La Referencia de cuenta de pago (PAR) de la tarjeta, tal como la devuelve el proveedor. Una PAR identifica la cuenta del titular de la tarjeta a través del número de tarjeta y sus network tokens, por lo que la misma cuenta conserva una sola PAR.

Se devuelve en pagos con tarjeta con o sin network token. Cuando el pago usa un network token, `card_data.network_token.par` lleva el mismo valor. El campo se omite cuando el proveedor no envía una PAR.

Ejemplo: V0010013019000000000000000001

**voucher** `string`

El identificador único del comprobante de pago asignado por el banco emisor para una
transacción con tarjeta.
Este campo está vacío si el gateway no proporciona información sobre la transacción (MAX 255; MIN
3\).

Ejemplo: 43564

**card\_data** `object`

Especifica los detalles de la tarjeta.

**properties**

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en ella (MAX 26; MIN 2), solo disponible para comercios
certificados PCI.

Ejemplo: Fannie Weissnat

**iin** `integer`

El número de identificación del emisor (IIN) corresponde a los primeros dígitos de la tarjeta de pago
emitida por una institución financiera (MAX 8; MIN 6).

Ejemplo: 41961111

**lfd** `integer`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 2; MIN 1).

Ejemplo: 16

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: VISA

**issuer\_name** `string`

El emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: Banco Galicia

**category** `string`

La categoría del emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: Gold

**type** `string`

El tipo de emisor de la tarjeta (MAX 255; MIN 3).

Ejemplo: CREDIT, DEBIT, or CHARGE\_CARD

**wallet** `object`

Especifica los detalles del método de pago al usar una billetera.

**properties**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un
monto real.

Valores posibles: `True` o `False`

`cryptogram` string
Criptograma para integraciones directas con billeteras de tarjetas (MAX 526; MIN 3).

**capture** `boolean`

Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta te permite
reservar
fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**payment\_method\_id** `string`

El método de pago del usuario utilizado en su billetera.

Ejemplo: credit\_card

**detail** `string`

El detalle del método de pago utilizado en su billetera.

Ejemplo: visa

**money\_release\_date** `date`

Fecha en la que el dinero del proveedor estará disponible para usar.

Ejemplo: 2022-05-09T00:00:00.000000Z

**sponsor\_id** `string`

Cuenta del socio en el proveedor (MAX 255; MIN 3).

Ejemplo: 4562103

**authorization\_code** `string`

Código de respuesta del adquirente.

Ejemplo: 742A64

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**email** `string`

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

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

**first\_name** `string`

El nombre del cliente (MAX 32, MIN 8).

Ejemplo: John

**last\_name** `string`

El apellido del cliente (MAX 32, MIN 8).

Ejemplo: Doe

**username** `string`

El nombre de usuario del cliente en la plataforma (MAX 32, MIN 8).

Ejemplo: John\_Doe\_01

**identification\_type** `string`

El tipo de documento del cliente (MAX 32, MIN 8).

Consulta la [
Referencia de países](https://docs.y.uno/es/reference/country-reference.md). Ejemplo: DNI

**identification\_number** `string`

El número de identificación del cliente (MAX 32, MIN 8).

Ejemplo: 34566123

**fee\_details** `object`

Especifica los detalles de las comisiones.

**properties**

**amount** `float`

Monto de la transacción (múltiplo de 0.0001).

Ejemplo: 40.5

**card\_data** `object`

Especifica los detalles de la tarjeta.

**properties**

**iin** `integer`

El número de identificación del emisor (IIN) corresponde a los primeros dígitos de la tarjeta de pago
emitida por una institución financiera (MAX 8; MIN 6).

Ejemplo: 45079900

**lfd** `integer`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 19; MIN 8).

Ejemplo: 19

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: visa

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en la tarjeta (MAX 26; MIN 2), solo disponible para
comercios con certificación PCI.

Ejemplo: JOHN DOE

**bnpl** `object`

Especifica los detalles del método de pago al usar BNPL.

**properties**

**installments** `integer`

Las cuotas del préstamo (MAX 50; MIN 1).

Ejemplo: 10

**provider\_image** `string`

La URL del proveedor (MAX 255; MIN 3).

Ejemplo: [https://www.company.com/logo](https://www.company.com/logo)

**redirect\_url** `string`

La URL con la versión completa del ticket, por si quieres redirigir a tu cliente (MAX
255;
MIN
3\).

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**name** `string`

El nombre legal del cliente (MAX 32, MIN 8).

Ejemplo: Legal name

**username** `string`

El nombre de usuario del cliente en la plataforma del proveedor (MAX 32, MIN 8).

Ejemplo: Legal\_name\_01

**tax\_id\_type** `string`

El identificador fiscal del cliente (MAX 32, MIN 8).

Ejemplo: CUIT

**tax\_id** `string`

El número del identificador fiscal del cliente (MAX 32, MIN 8).

Ejemplo: 20-34566123-7

**type** `string`

El tipo de crédito (MAX 255; MIN 3).

Ejemplo: PERSONAL/BUSINESS

**area** `string`

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

Ejemplo: OTHERS

**role** `string`

El rol del cliente en la empresa (MAX 255; MIN 3).

Ejemplo: OWNER

**bank\_transfer** `object`

Especifica los detalles del método de pago al usar transferencia bancaria.

**properties**

**provider\_image** `string`

La URL del proveedor (MAX 255; MIN 3).

Ejemplo: [https://www.company.com/](https://www.company.com/)

**account\_type** `string`

Tipo de cuenta bancaria (MAX 255; MIN 3).

Ejemplo: CHECKINGS/SAVINGS

**bank\_name** `string`

Nombre del banco asociado a la cuenta (MAX 255; MIN 3).

Ejemplo: Banco Galicia

**bank\_id** `string`

Identificador del banco seleccionado por el pagador, cuando se envía en la solicitud de pago original.

Ejemplo: galicia

**beneficiary\_name** `string`

El nombre del titular de la cuenta (MAX 255; MIN 3).

Ejemplo: John Doe

**bank\_account** `string`

El número de la cuenta bancaria (MAX 255; MIN 3).

Ejemplo: 54653211313333

**bank\_account\_2** `string`

El número secundario de la cuenta bancaria (MAX 255; MIN 3).

Ejemplo: 78900000000123

**beneficiary\_document\_type** `string`

Tipo de documento del titular de la cuenta (MAX 255; MIN 3).

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

**beneficiary\_document** `string`

Número de documento del titular de la cuenta (MAX 255; MIN 3).

Ejemplo: 54666897

**payment\_instruction** `string`

Instrucciones relacionadas con el pago (MAX 255; MIN 3).

Ejemplo: Go to your bank account and transfer the amount using the reference detailed
below

**redirect\_url** `string`

La URL con la versión completa del ticket, por si quieres redirigir a tu cliente (MAX
255;
MIN
3\).

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**ticket** `object`

Especifica los detalles del método de pago al usar ticket.

**properties**

**type** `string`

El tipo de ticket.

Ejemplo: number, barcode, custom, reference\_code, qr

**provider\_number** `integer`

El número del ticket.

Ejemplo: 13141

**provider\_barcode** `string`

El código de barras del ticket, como valor de texto. Para la imagen del código de barras, consulta `provider_logo`.

Ejemplo: 456789009878765u7654

**provider\_logo** `string`

El logo del ticket.

Ejemplo: [https://www.company.com/logo](https://www.company.com/logo)

**provider\_format** `string`

El formato del ticket.

Ejemplo: barcode, custom

**redirect\_url** `string`

La URL con la versión completa del ticket.

Ejemplo: [https://www.company.com/ticket\_1231324](https://www.company.com/ticket_1231324)

**payment\_link** `object`

Especifica los detalles del método de pago al usar un enlace de pago.

**properties**

**verify** `boolean`

Con amount = 0 y verify = true, puedes verificar la tarjeta del usuario sin autorizar un
monto real.

Valores posibles: `True` o `False`

**capture** `boolean`

Define si se autoriza el pago o se captura. Autorizar un pago con tarjeta te permite
reservar
fondos en la cuenta bancaria de un cliente.

Valores posibles: `True` o `False`

**installments** `integer`

Las cuotas de la tarjeta (MAX 50; MIN 1).

Ejemplo: 3

**payment\_method\_id** `string`

El método de pago del usuario utilizado en su billetera.

Ejemplo: credit\_card

**detail** `string`

El detalle del método de pago utilizado en su billetera.

Ejemplo: visa

**money\_release\_date** `date`

Fecha en la que el dinero del proveedor estará disponible para su uso.

Ejemplo: 2022-05-09T00:00:00.000000Z

**sponsor\_id** `string`

Cuenta de proveedor del socio (MAX 255; MIN 3).

Ejemplo: 4562103

**authorization\_code** `string`

Código de respuesta del adquirente.

Ejemplo: 742A64

**customer\_data** `object`

Especifica los detalles del cliente.

**properties**

**email** `string`

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

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

**first\_name** `string`

El nombre del cliente (MAX 32, MIN 8).

Ejemplo: John

**last\_name** `string`

El apellido del cliente (MAX 32, MIN 8).

Ejemplo: Doe

**username** `string`

El nombre de usuario del cliente en la plataforma (MAX 32, MIN 8).

Ejemplo: John\_Doe\_01

**identification\_type** `string`

El tipo de documento del cliente (MAX 32, MIN 8).

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

**identification\_number** `string`

El número de identificación del cliente (MAX 32, MIN 8).

Ejemplo: 34566123

**fee\_details** `object`

Especifica los detalles de las comisiones.

**properties**

**amount** `float`

Monto de la transacción (múltiplo de 0.0001).

Ejemplo: 40.5

**card\_data** `object`

Especifica los detalles de la tarjeta.

**properties**

**iin** `integer`

El número de identificación del emisor (IIN) se refiere a los primeros dígitos de la tarjeta de pago
emitida por una entidad financiera (MAX 8; MIN 6).

Ejemplo: 45079900

**lfd** `integer`

Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).

Ejemplo: 0010

**number\_length** `integer`

La longitud del número de la tarjeta (MAX 19; MIN 8).

Ejemplo: 19

**security\_code\_length** `integer`

La longitud del código de seguridad de la tarjeta (MAX 1; MIN 1).

Ejemplo: 3

**brand** `string`

La información de la marca de la tarjeta (MAX 255; MIN 3).

Ejemplo: visa

**holder\_name** `string`

Nombre completo del titular de la tarjeta tal como aparece en la tarjeta (MAX 26; MIN 2), solo disponible para
comercios con certificación PCI.

Ejemplo: John Doe

**connection\_data** `object`

Especifica el objeto de datos de la conexión, que representa la conexión utilizada para procesar la transacción. Cuando operas varias conexiones para el mismo proveedor, usa `connection_data.id` para atribuir cada transacción a la conexión específica que la procesó.

**properties**

**id** `string`

El identificador único de la conexión de pago en Yuno (MAX 64 ; MIN 36).

Ejemplo: 88292fd3-bf5b-4b23-bb95-7186ba4e7f88

**name** `string`

El nombre visible de la conexión, tal como está configurado en el dashboard de Yuno. Puede ser `null` en algunos eventos, como las transacciones de seguimiento.

Ejemplo: My Stripe US account

**created\_at** `timestamp`

La fecha y hora en que se creó la transacción.

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

**updated\_at** `timestamp`

La fecha y hora de la última actualización de la transacción.

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

**split\_marketplace** `array of objects`

Arreglo de objetos de split marketplace

**properties**

**recipient\_id** `string`

El identificador único del destinatario en el sistema de Yuno.

Debes enviar el recipient\_id (generado por Yuno) o el 'provider\_recipient\_id' (ID del proveedor externo) al crear un pago.

**provider\_recipient\_id** `string`

El ID del destinatario proporcionado por el proveedor de pago externo, si aplica.

Debes enviar el provider\_recipient\_id o el recipient\_id (generado por Yuno) al crear un pago.

**type** `string`

El tipo de split.

Ejemplo: PURCHASE

**merchant\_reference** `string`

Identificador único opcional de la transacción split.

**amount** `object`

Define el monto del split.

**properties**

**value** `float`

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

**currency** `string`

La moneda utilizada para realizar el pago (MAX 3; MIN 3; ISO 4217).

**liability** `object`

Información opcional sobre la responsabilidad del destinatario por comisiones y contracargos.

**properties**

**processing\_fee** `string`

Indica a quién se le cobrará la comisión de la transacción.

**chargebacks** `boolean`

El destinatario es responsable en caso de contracargo.

**transactions\_history** `array of objects`

La lista de las transacciones que forman parte de un pago, una entrada por intento, por lo que depende de cuántos proveedores probó la ruta de tu método de pago. Este arreglo es opcional: se completa solo cuando el pago se creó con `response_additional_data.transactions_history: true`; de lo contrario, se devuelve como un arreglo vacío `[]`. Los eventos de contracargo siempre incluyen el historial completo.

**workflow** `enum`

El flujo de trabajo del pago. Indica si la integración usará el SDK de Yuno o será una conexión directa
(back to back) (la implementación con tarjeta solo está disponible para comercios con cumplimiento PCI).

Valores posibles del enum:

* `SDK_CHECKOUT`: Usa Yuno SDK.
* `DIRECT`: Integración directa (back to back) con la información del proveedor para una
  experiencia de pago personalizada.
* `REDIRECT`: Integración directa (back to back) con redirección al proveedor.

**callback\_url** `string`

La URL a la que se redirige al cliente después del pago. Solo es obligatoria para las integraciones DIRECT que tienen una
redirección (MAX 526; MIN 3).

Ejemplo: [https://www.company.com/customer\_1231324](https://www.company.com/customer_1231324)

**metadata** `array of objects`

Especifica una lista de pares clave-valor personalizados asociados al pago (para referencias internas, segmentación o etiquetas de flujo de trabajo). Puedes agregar hasta 120 objetos de metadata.

**properties**

**metadata object** `object`

Especifica una clave de metadata y su valor correspondiente.

Úsalo para adjuntar contexto definido por el comercio (por ejemplo: `order_id`, `customer_tier`). Evita enviar datos sensibles o personales.

**properties**

**key** `string`

Especifica una clave de metadata (MAX 48).

Ejemplo: age

**value** `string`

Especifica el valor de la clave de metadata definida (MAX 512).

Ejemplo: 28

**routing\_rules** `array of objects`

Devuelve la información de las reglas de enrutamiento durante la creación del pago.

**properties**

**smart\_routing** `bool`

Especifica si una transacción pasó por la función de smart routing o no.

Ejemplo: false

**monitors** `bool`

Especifica si una transacción pasó por la función de monitors o no.

Ejemplo: false

**condition** `object`

Objeto con la información correspondiente a la condición de enrutamiento que aplica al pago

**properties**

**id** `string`

ID de la condición correspondiente al pago.

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

**subscription\_id** `string`

El identificador único de la suscripción asociada al pago (MAX 64 ; MIN 36).

Ejemplo: 7304911d-5df9-429e-8488-ad41abea1a4c

**subscription** `struct`

Devuelve los detalles de la suscripción asociada al pago.

**properties**

**billing\_cycle** `int`

Especifica el ciclo de facturación de la suscripción asociada al pago.

Ejemplo: 1

**retry** `int`

Especifica el intento de reintento asociado al ciclo de facturación de la suscripción.

Ejemplo: 2

**fraud\_screening** `array of objects`

Proporciona información sobre los análisis de fraude utilizados para el pago.

**properties**

**status** `enum`

El estado final del proceso de análisis del pago.

Ejemplo: SUCCEEDED

**stand\_alone** `boolean`

Campo opcional para enviar en el pago que indica si el análisis de fraude es independiente (stand alone), es decir, que no se ejecutará un pago después de realizar el análisis de fraude. Puedes usar este campo al crear tu ruta CARD.

Ejemplo: false

**transactions** `object`

Especifica los detalles de la transacción asociados a un proceso de análisis del pago.

**properties**

**id** `string`

El id de la transacción de fraude (MAX 64; MIN 36).

Ejemplo: ft12

**type** `enum`

Tipo de la transacción de fraude.

Valores posibles del enum: `PRE_AUTH`, `POS_AUTH`

**status** `enum`

El estado de la transacción (MAX 255; MIN 3).

Ejemplo: SUCCEEDED

**response\_code** `enum`

El código de respuesta de la transacción.

Ejemplo: FRAUD\_VERIFIED

**response\_message** `enum`

El mensaje de respuesta de la transacción.

Ejemplo: Fraud approved

**provider\_data** `object`

Especifica los datos del proveedor que procesó el pago.

**properties**

**provider\_id** `string`

El id del proveedor de prevención de fraude.

Ejemplo: CLEARSALE

**transaction\_id** `string`

El id de la transacción de fraude del proveedor.

Ejemplo: AA001234567

**status** `string`

El estado de la transacción de fraude del proveedor.

Ejemplo: APM

**score** `string`

El puntaje del proveedor para la transacción.

Ejemplo: 0.7

**raw\_response** `string`

El raw\_response del proveedor.

Ejemplo: JSON

**raw\_request** `object`

Copia ofuscada de la solicitud que Yuno envió al proveedor. Solo se devuelve para organizaciones en la lista de permitidos.

Ejemplo: JSON

**created\_at** `timestamp`

La fecha y hora en que se creó el análisis de fraude.

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

**updated\_at** `timestamp`

La fecha y hora de la última actualización del análisis de fraude.

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


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