Este objeto representa el pago creado después de generar la sesión de pago para un cliente.
id string
El identificador único del cliente (MÁX 64 ; MÍN 36).
Ejemplo: 8546df3a-b83e-4bb5-a4b3-57aa6385924f
account_id string
El identificador único de la cuenta (MÁX 64; MÍN 36).
Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b
description string
La descripción del pago (MÁX 255; MÍN 3).
Ejemplo: Compra en la web
country enum
País donde se debe procesar la transacción (MÁX 2; MÍN 2; ISO 3166-1).
Posibles valores del enum: Compruebe la referencia del país.
status enum
Estado de la transacción.
Ejemplo: SUCCEEDED
sub_status enum
Es un complemento a la información de estado.
Ejemplo: DECLINED
merchant_order_id string
El identificador único del pedido del cliente (MÁX 255; MÍN 3).
Ejemplo: 2022-05-09T20:20:54.786342Z
created_at marca de tiempo
La fecha y hora en que se creó el pago.
Ejemplo: 2022-05-09T20:46:54.786342Z
updated_at marca de tiempo
La fecha y hora de la última actualización del pago.
Ejemplo: 2022-05-09T20:46:54.786342Z
amount objeto
Especifica el objeto monto del pago, incluyendo su importe y moneda.
currency enum
La moneda utilizada para realizar el pago (MÁX 3; MÍN 3; ISO 4217).
Posibles valores del enum: Compruebe la referencia del país.
value number
Monto del pago (múltiplo de 0,0001).
Ejemplo: 111111
currency_conversion objeto
Especifica el objeto de conversión de moneda.
provider_currency_conversion_id string
El identificador único de la consulta de tasa de conversión del proveedor (MÁXIMO 526; MÍNIMO 3).
Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b
cardholder_currency enum
La moneda para realizar la conversión (ISO 4217 MAX 3; MIN 3).
Ejemplo: USD
cardholder_amount number
Importe del pago antes de la conversión
Ejemplo: 100
refunded number
El monto del reembolso (múltiplo de 0.0001).
Ejemplo: 111111
captured number
La cantidad capturada (múltiplo de 0.0001).
Ejemplo: 111111
checkout objeto
Especifica el objeto de pago. Este objeto no es obligatorio para pagos consecutivos. Obligatorio cuando
WORKFLOW Se define como CHECKOUT o no se envía. No es necesario para DIRECT
pagos.
WORKFLOW Se define como CHECKOUT o no se envía. No es necesario para DIRECT
pagos.
session string
Se ha creado la sesión de pago 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 basados en una solicitud al SDK.
Ejemplo: falso
payment_method objeto
Especifica el objeto payment_method.
vaulted_token string
El vaulted_token representa un pago almacenado de forma segura y asociado a una transacción anterior. Cuando
utilizar un vaulted_token para crear un pago, no es necesario enviar un token adicional; se puede establecer como
null (MAX: 64; MIN: 36).
Este campo se devuelve en la pago cuando vault_on_success = true y el pago es SUCCEEDED, siempre que el pago un cliente existente de Yuno a través de customer_payer.id.
Ejemplo: 8604911d-5ds9-229e-8468-bd41abear14s
type enum
Tipo de método de pago. Obligatorio para DIRECT o REDIRECT flujo de trabajo. Necesario al integrar monederos, incluso cuando se utiliza el SDK.
Posibles valores de enum:
Posibles valores del enum: compruebe la referencia del tipo de pago.
vault_on_success boolean
Marca para registrar la tarjeta tras un pago correcto. Requiere que el pago haga referencia a un cliente Yuno existente a través de customer_payer.id.
Cuando se configura en true y el pago es SUCCEEDED, la pago incluirá un vaulted_token que se puede utilizar para futuras transacciones. Sin un ID de cliente no se realiza ningún almacenamiento y no vaulted_token aunque se incluyan los datos del cliente 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 se crea un pago utilizando un token,
no es necesario enviar también un vaulted_token, puede definirse como null. No es necesario para pagos
(MAX: 64; MIN: 36).
Ejemplo: 5104911d-5df9-229e-8468-bd41abea1a4s
detail objeto
Especifica el objeto de detalle de método de pago, que proporciona detalles de los diferentes tipos de categorías de transacción que forman parte del objeto de método de pago.
que forman parte del objeto de método de pago.
card objeto
Especifica los detalles del método de pago cuando se utiliza una tarjeta.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
real.
Valores posibles: True o False
capture boolean
Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta le permite
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 1).
Ejemplo: 3
first_installments_deferral integer
Número de meses a esperar para debitar la primera cuota.
Ejemplo 1
installments_type string
Define el tipo de cuotas.
Ejemplo: cadena
installments_amount integer
El importe del plazo incluye los intereses asociados al plazo y la información es
definida por el proveedor.
Ejemplo: 3
soft_descriptor string
El descriptor pasado por transacción a nuestra plataforma. Se presentará en el extracto bancario
del cliente (MAX 15; MIN 0).
Ejemplo: EMPRESA1
authorization_code string
El código de respuesta del adquirente.
Ejemplo: 742A64
retrieval_reference_number string
El identificador único asignado por un adquirente a una autorización. En el caso de Brasil, recibirá el NSU.
Ejemplo: 200000000012
voucher string
El identificador único del recibo 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 objeto
Especifica los detalles de la tarjeta.
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
PCI.
Ejemplo: Fannie Weissnat
country_code string
Código de país de la tarjeta de usuario (MÁXIMO 2; MÍNIMO 2).
Ejemplo: EE.UU.
expiration_month integer
Mes de vencimiento de la tarjeta (MM) (MÁXIMO 2; MÍNIMO 2).
Ejemplo: 03
expiration_year integer
Año de vencimiento de la tarjeta (AAAA) (MÁXIMO 4; MÍNIMO 2).
Ejemplo: 2030
iin string
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 41961111
lfd string
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 4).
Ejemplo: 0010
number_length integer
La longitud del número de la tarjeta (MÁX 19; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: VISA
issuer_name string
El emisor de la tarjeta (MÁX 255; MÍN 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 (MÁX 255; MÍN 3).
Ejemplo: Oro
type string
El tipo de emisor de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: CRÉDITO, DÉBITO o TARJETA_CARGA
fingerprint string
Cuando un cliente registra una tarjeta de crédito varias veces relacionada con una o varias cuentas Yuno, se generarán múltiples vaulted_tokens, pero la huella digital le permite identificar cuándo se usa la misma tarjeta para el cliente (MÁXIMO 255; MÍNIMO 3).
Ejemplo: 55a7fe38-cdc3-45dc-8c5f-820751799c76
three_d_secure objeto
Especifica los detalles de la transacción 3DS.
three_d_secure_setup_id string
ID de configuración obtenido para el flujo directo de 3DS.
Ejemplo: 24127d61-b852-42fb-acd4-1ee661645376
version enum
Hace referencia 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 de la ECI proporcionado por el servicio 3d Secure
. El Indicador de Comercio Electrónico (ICE) 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
transacciones 3-D Secure tengan este valor rellenado en el pedido autorización (MAX: 2, MIN: 0).
Ejemplo: 05
cryptogram string
Este campo debe completarse con el resultado del criptograma proporcionado por el servicio 3DSecure
servicio 3DSecure. En las transacciones Visa, representa el Valor de Verificación de Autenticación del Titular de la Tarjeta
(CAVV), un valor criptográfico generado por el Emisor como prueba de autenticación pago durante
compra en línea para poder acogerse a la protección contra devoluciones de cargo. Las transacciones de MasterCard tienen un valor similar
denominado Valor de Autenticación del Titular de la Tarjeta (AAV) o Campo Universal de Autenticación del Titular de la Tarjeta (UCAF).
(UCAF). Al presentar una transacción para su autorización, el comerciante debe incluir el CAVV o el
AAV/UCAF para demostrar que el titular de la tarjeta ha sido autenticado. Suele estar codificado en base64.
(MÁX: 40, MÍN: 0).
Ejemplo: BA0BB1Z3N5Q4kjkBU3c3ELGUsJY =
transaction_id string
Para 3DS v1:
Es el identificador único de transacción. Lo genera automáticamente el MPI. Suele tener
28 bytes de longitud y codificado en base64. Se suele denominar XID (MAX: 40, MIN: 0).
Para 3DS v2:
Identificador de transacción universalmente único asignado por el DS para identificar una única transacción. (MÁX:
36, MIN:36).
Ex para V1: "TjY0MjAxRjA4MD4987DUzMzYyNjU="
Ex para V2: “c4e59ceb-a382-4d6a-bc87-385d591fa09d”
directory_server_transaction_id string
ID de transacción generado por el servidor de directorio de Mastercard durante la autenticación (MAX 255;
MIN 3).
Ejemplo: f38e6948-5388-41a6-bca4-b49723c19437
network_token objeto
Información sobre el token de red utilizado para la transacción. Si es aplicable.
network enum
El proveedor asociado al token proporcionado. VISA, MASTERCARD, AMERICAN_EXPRESS.
Ejemplo: MASTERCARD
status enum
Estado del token del método de pago. CREADO, ACTIVO, SUSPENDIDO, CANCELADO.
Ejemplo: ACTIVO
par string
Referencia de cuenta de pago.
Ejemplo: MCC123456789012
token_data objeto
Detalles del token.
number number
[Obligatorio] - El número de token sin separadores (MÁXIMO 19; MÍNIMO 8) solo está disponible para comerciantes con certificación PCI.
Ejemplo: 450799000001234
holder_name string
Nombre completo del titular de la tarjeta tal como aparece en el Token (MÁXIMO 26; MÍNIMO 3).
Ejemplo: John Doe
iin number
El número de identificación de la institución (IIN) se refiere a los primeros dígitos de un número de token de red emitido por una institución financiera (MÁX. 8; MÍN. 6).
Ejemplo: 45079900
lfd number
Últimos cuatro dígitos del token de red (MAX 4; MIN 4).
Ejemplo: 1234
expiration_month number
Mes de vencimiento del token de red (MM) (MÁXIMO 2; MÍNIMO 2).
Ejemplo: 12
expiration_year number
Año de caducidad Tokenred (AAAA) (MAX 4; MIN 2).
Ejemplo: 2027
cryptogram string
[Obligatorio] - El criptograma único generado por el emisor para el token de red en uso en la transacción.
electronic_commerce_indicator string
[Solo requerido para ciertos proveedores] - En caso de que el token haya sido autenticado por Mastercard el campo deberá ser configurado a 02. Para Visa o tokens no autenticados, no es necesario enviar el campo.
token_requestor_id string
[Solo requerido para ciertos proveedores] - ID del solicitante del token del comerciante
response objeto
Detalles de la transacción de red.
code number
Código de respuesta del proveedor de servicios.
Ejemplo: tuvo éxito
message number
Código de respuesta del proveedor de servicios.
Ejemplo: transacción exitosa
stored_credentials objeto
Indica el tipo de procesamiento de la transacción.
reason enum
Indica el tipo de procesamiento de la transacción.Enum:TARJETA_EN_ARCHIVO, SUSCRIPCIÓN, TARJETA_EN_ARCHIVO NO PROGRAMADA
Ejemplo: SUSCRIPCIÓN
usage enum
Este campo le permite indicar si es la primera vez que se utiliza el vaulted_token/network_token para un pago o si ya se ha utilizado para un pago anterior. Enumeración: PRIMERO, USADO
Ejemplo: USADO
subscription_agreement_id string
Este campo 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 utiliza para rastrear y hacer referencia a transacciones específicas, en particular en escenarios de pago recurrentes, lo que garantiza la coherencia y la trazabilidad durante todo el ciclo de vida del pago (MÁXIMO 255; MÍNIMO 3).
Ejemplo: 583103536844189
bnpl objeto
Especifica los detalles del método de pago cuando se utiliza Comprar ahora y pagar después (BNPL).
installments integer
Las cuotas del préstamo (MÁX 50; MÍN 1).
Ejemplo: 10
provider_image string
La URL del proveedor (MÁXIMO 255; MÍNIMO 3).
Ejemplo: https://www.company.com/
redirect_url string
La URL con la versión completa del ticket en caso de que quiera redirigir a su cliente (MAX 255;
MIN
3).
Ejemplo: https://www.company.com/ticket_1231324
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
customer_data objeto
Especifica los detalles del cliente.
name string
El nombre legal del cliente (MÁX 32, MÍN 8).
Ejemplo: Nombre legal
username string
Nombre de usuario del cliente en la plataforma del proveedor (MÁX 32, MÍN 8).
Ejemplo: Legal_name_01
tax_id_type string
El identificador fiscal del cliente (MÁX 32, MÍN 8).
Ejemplo: CUIT
tax_id string
El número de identificación fiscal del cliente (MÁX 32, MÍN 8).
Ejemplo: 20-34566123-7
type string
El tipo de crédito (MÁX 255; MÍN 3).
Ejemplo: PERSONAL/NEGOCIOS
area string
La industria del cliente (MÁX 255; MÍN 3).
Ejemplo: OTROS
role string
Rol del cliente en la empresa (MÁX 255; MÍN 3).
Ejemplo: PROPIETARIO
bank_transfer objeto
Especifica los detalles del método de pago cuando se utiliza transferencia bancaria.
provider_image string
La URL del proveedor (MÁXIMO 255; MÍNIMO 3).
Ejemplo: https://www.company.com/
account_type string
Tipo de cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: CHEQUES/AHORROS
bank_name string
Nombre del banco asociado a la cuenta (MÁX 255; MÍN 3).
Ejemplo: Banco Galicia
bank_id string
Identificador del banco seleccionado cuando el proveedor requiere elegir uno (MÁX. 255; MÍN. 1). Opcional.
Ejemplo: Galicia
beneficiary_name string
El nombre del titular de la cuenta (MÁX 255; MÍN 3).
Ejemplo: John Doe
bank_account string
El número de la cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: 54653211313333
bank_account_2 string
El número secundario de la cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: 78900000000123
beneficiary_document_type string
Tipo de documento del titular de la cuenta (MÁX 255; MÍN 3).
Valores posibles: Compruebe la
Referencia del país. Ejemplo: DNI
beneficiary_document string
Número de documento del titular de la cuenta (MÁX 255; MÍN 3).
Ejemplo: 54666897
reference string
Código de referencia para el usuario (MÁX 255; MÍN 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á el nsu.
Ejemplo: 200000000012
payment_instruction string
Instrucciones de pago relacionadas con el pago (MÁX 255; MÍN 3).
Ejemplo: Vaya a su cuenta bancaria y transfiera el importe utilizando la referencia detallada
a continuación
redirect_url string
La URL con la versión completa del ticket en caso de que quiera redirigir a su cliente (MAX 255;
MIN
3).
Ejemplo: https://www.company.com/ticket_1231324
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
wallet objeto
Especifica los detalles del método de pago cuando se usa una billetera.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
real.
Valores posibles: True o False
cryptogram string
Criptograma para integraciones directas con billeteras de tarjetas (MAX 526; MIN 3).
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-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 le permite
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 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
Adquirir el código de respuesta.
Ejemplo: 742A64
customer_data objeto
Especifica los detalles del cliente.
email string
El email del cliente (MÁX 255; MÍN 3).
Ejemplo: [email protected]
first_name string
El nombre del cliente (MAX 32, MIN 8).
Ejemplo: John
last_name string
El apellido del cliente (MÁX 32, MÍN 8).
Ejemplo: Doe
username string
El nombre de usuario del cliente en la plataforma (MÁX 32, MÍN 8).
Ejemplo: John_Doe_01
identification_type string
El tipo de documento del cliente (MÁX 32, MÍN 8).
Compruebe la
Referencia del país. Ejemplo: DNI
identification_number string
El número de identificación del cliente (MÁX 32, MÍN 8).
Ejemplo: 34566123
fee_details objeto
Especifica los detalles de las tarifas.
amount float
Importe de la transacción (múltiplo de 0,0001).
Ejemplo: 40.5
card_data objeto
Especifica los detalles de la tarjeta.
iin integer
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 45079900
lfd integer
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: visa
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
PCI.
Ejemplo: JUAN DOE
store_credentials objeto
Indica el tipo de procesamiento de la transacción. Este objeto se utiliza para enviar información adicional sobre la recurrencia. Es opcional y pocos proveedores lo requieren (por ejemplo, Mercado Pago). Ponte en contacto con tu TAM para confirmar si es necesario para tu integración.
reason enum
Indica el motivo por el que se almacenan las credenciales para la transacción. Enumeración: CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILE.
Ejemplo: SUSCRIPCIÓN
usage enum
Este campo le permite indicar si es la primera vez que se utiliza el vaulted_token/network_token para un pago o si ya se ha utilizado para un pago anterior. Enumeración: PRIMERO, USADO
Ejemplo: USADO
subscription_agreement_id string
Este campo 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 utiliza para rastrear y hacer referencia a transacciones específicas, en particular en escenarios de pago recurrentes, lo que garantiza la coherencia y la trazabilidad durante todo el ciclo de vida del pago (MÁXIMO 255; MÍNIMO 3).
Ejemplo: 583103536844189
additional_data objeto
Esta estructura se utiliza para enviar información adicional sobre la recurrencia. Es opcional, y pocos proveedores la requieren (por ejemplo, Mercado Pago). Ponte en contacto con tu TAM para confirmar si es necesaria para tu integración.
billing_cycles objeto
Especifica el billing_cycles objeto. Define el número de cargos asociados a la suscripción. Si utilizas este objeto, debes introducir datos en todos los campos.
billing_cycles objeto. Define el número de cargos asociados a la suscripción. Si utilizas este objeto, debes introducir datos en todos los campos.current integer
Ejemplo 1
total integer
El número total de ciclos de facturación de la suscripción (MIN 1).
frequency objeto
Especifica el tipo de frecuencia (por ejemplo, DÍA, SEMANA, MES, AÑO) y el valor. Introduce datos en todos los campos si utilizas este objeto.
type string
Especifica el tipo de frecuencia (por ejemplo, DÍA, SEMANA, MES, AÑO).
Ejemplo: MES
value string
Especifica el valor de frecuencia.
availability objeto
Especifica el availability objeto. Define un intervalo de fechas basado en las fechas de inicio y fin en las que la suscripción está disponible para su uso.
availability objeto. Define un intervalo de fechas basado en las fechas de inicio y fin en las que la suscripción está disponible para su uso.start_at string
La fecha de inicio en la que el plan de suscripción estará disponible para su uso. Si no se configura, la suscripción está disponible desde el momento en que se crea. start_at se convierte en obligatorio cuando se utiliza finish_at.
finish_at string
Fecha en la que finalizará la disponibilidad del plan de suscripción. Si no se establece, la suscripción estará disponible de forma indefinida. finish_at se convierte en obligatorio cuando se utiliza start_at.
ticket objeto
Especifica los detalles del método de pago cuando se usa el boleto.
type string
El tipo de billete.
Ejemplo: número, código de barras, personalizado, código_referencia, qr
benefit_type enum
Tipo de beneficio del usuario por método de pago del boleto. JUNAEB, PRIVADO
Ejemplo: PRIVADO
provider_number integer
El número del billete.
Ejemplo: 13141
provider_barcode integer
El código de barras del billete.
Ejemplo: 456789009878765u7654
provider_logo string
El logo del billete.
Ejemplo: https://www.company.com/logo
provider_format string
El formato del billete.
Ejemplo: código de barras, personalizado
payment_instruction string
Instrucciones de pago relacionadas con el pago (MÁX 255; MÍN 3).
Ejemplo: Dirígete a tu tienda más cercana y paga el importe total utilizando la referencia que se detalla a continuación
redirect_url string
La URL con la versión completa del ticket.
Ejemplo: https://www.company.com/ticket_1231324
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
payment_link objeto
Especifica los detalles del método de pago cuando se utiliza un enlace de pago.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
real.
Valores posibles: True o False
capture boolean
Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta le permite
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 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
Adquirir el código de respuesta.
Ejemplo: 742A64
customer_data objeto
Especifica los detalles del cliente.
email string
El email del cliente (MÁX 255; MÍN 3).
Ejemplo: [email protected]
first_name string
El nombre del cliente (MAX 32, MIN 8).
Ejemplo: John
last_name string
El apellido del cliente (MÁX 32, MÍN 8).
Ejemplo: Doe
username string
El nombre de usuario del cliente en la plataforma (MÁX 32, MÍN 8).
Ejemplo: John_Doe_01
identification_type string
El tipo de documento del cliente (MÁX 32, MÍN 8).
Valores posibles: Compruebe la
Referencia del país. Ejemplo: DNI
identification_number string
El número de identificación del cliente (MÁX 32, MÍN 8).
Ejemplo: 34566123
fee_details objeto
Especifica los detalles de las tarifas.
amount float
Importe de la transacción (múltiplo de 0,0001).
Ejemplo: 40.5
card_data objeto
Especifica los detalles de la tarjeta.
iin integer
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 45079900
lfd integer
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: visa
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
PCI.
Ejemplo: John Doe
expiration_month integer
Mes de vencimiento de la tarjeta (MM) (MÁXIMO 2; MÍNIMO 2).
Ejemplo: 03
expiration_year integer
Año de vencimiento de la tarjeta (AAAA) (MÁXIMO 4; MÍNIMO 2).
Ejemplo: 30
customer_payer objeto
Especifica el objeto de cliente para los pagos.
id string
El identificador único del cliente (MAX 64; MIN 36). Especifica el objeto de pago. Este objeto no es
obligatorio para pagos consecutivos. 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 (MÁX 255; MÍN 3).
Ejemplo: 4ce6f7e1-bf2e-4e7f-bc1b-84b26082a1d3
merchant_customer_created_at marca de tiempo
Fecha de alta del cliente en la plataforma de comercios (ISO 8601 MAX 27; MIN 27).
Ejemplo: 2022-05-09T20:46:54.786342Z
merchant_customer_validations objeto
Validaciones de fraude para el cliente pagador.
account_is_verified boolean
Si la cuenta del cliente ya ha sido validada por el comercio. El valor predeterminado es "verdadero".
Valores posibles: True o False
email_is_verified boolean
Si el correo electrónico del cliente ya ha sido validado por el comerciante. El valor predeterminado es "verdadero".
Valores posibles: True o False
phone_is_verified boolean
Si el teléfono del cliente ya ha sido validado por el comercio. El valor predeterminado es "verdadero".
Valores posibles: True o False
first_name string
El nombre del cliente (MÁX 255; MÍN 1).
Ejemplo: John
last_name string
El apellido del cliente (MÁX 255; MÍN 1).
Ejemplo: Doe
gender enum
El sexo del cliente (MÁX 1; MÍN 1; (M=Hombre/F=Mujer/NA=No aplicable/NK=No conocido)).
Posibles valores de enum: M, F, NA, o NK.
date_of_birth string
La fecha de nacimiento del cliente en el formato AAAA-MM-DD (Longitud: 10).
Ejemplo: 1990-02-28
email string
El e-mail del cliente (MÁX 255; MÍN 3).
Ejemplo: [email protected]
nationality enum
La nacionalidad del cliente (MÁX 2; MÍN 2; ISO 3166-1).
Posibles valores del enum: Compruebe la referencia del país.
device_fingerprint string
La fingerprint del dispositivo del cliente (MAX 4000; MIN 1). Para integraciones que utilizan Yuno checkout el valor se obtiene
obtenido automáticamente, no envíe este campo.
Ejemplo: hi88287gbd8d7d782ge.....
device_fingerprints array de objetos
En caso de que estés utilizando una integración DIRECTA y quieras admitir más de un proveedor de servicios de fraude en el flujo de pago, puedes utilizar este objeto para especificar la información necesaria. Para las integraciones que utilizan Yuno checkout, el valor se obtiene automáticamente, no envíes este campo.
provider_id enum
El proveedor de detección de fraudes id
Ejemplo: RIESGADO
id string
La huella digital del dispositivo asociada al proveedor
Ejemplo: hi88287gbd8d7d782ge.....
ip_address string
La dirección IP del cliente (MÁX 45; MÍN 7).
Ejemplo: 192.168.123.167
browser_info objeto
Especifica el objeto browser_info.
accept_header boolean
El valor del encabezado de aceptación del navegador del cliente.
Valores posibles: True o False
accept_browser string
El valor de aceptación del navegador del cliente
Valores posibles: "True" o "False"
accept_content string
El valor del contenido aceptado por el navegador del cliente
Valores posibles: "True" o "False"
platform enum
La plataforma desde la que el cliente realiza el pago.
Posibles valores de enum: WEB, IOS, ANDROID
color_depth float
La profundidad de color del navegador del cliente en bits por píxel. Debe obtenerse utilizando la propiedad
screen.colorDepth del navegador. Valores aceptados: 1, 4, 8, 15, 16, 24, 30, 32 o 48 bits de profundidad de color.
(MÁX
5; MIN 1).
Ejemplo: 15
javascript_enabled boolean
Indica si Javascript está habilitado o no en el dispositivo.
Valores posibles: True o False
java_enabled boolean
Indica si Java está habilitado o no en el dispositivo.
Valores posibles: True o False
browser_time_difference string
Indica la diferencia horaria de Brosner
Ejemplo: -3:00
language string
El valor navigator.language del navegador del cliente (como se define en IETF BCP 47) (MÁX 5; MÍN 1).
Ejemplo: es-ES
screen_height string
La altura total de la pantalla del dispositivo del cliente en píxeles (MÁXIMO 255; MÍNIMO 3).
Ejemplo: 2048
screen_width string
El ancho total de la pantalla del dispositivo del cliente en píxeles (MÁXIMO 255; MÍNIMO 3).
Ejemplo: 1152
user_agent string
El valor del agente de usuario del navegador del cliente (MÁX 255; MÍN 3).
Ejemplo: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, como
Gecko)
Versión/9.0.2 Safari/601.3.9
document objeto
Especifica el objeto de documento del cliente, incluido su número y tipo.
document_number string
El número de documento del cliente (MÁX 40; MÍN 3).
Ejemplo: 1093333333
document_type enum
El tipo de documento del cliente (MÁX 6, MÍN 2).
Posibles valores del enum: Compruebe la
Referencia del país.
phone objeto
Especifica el objeto de teléfono del cliente, incluidos el número y el código.
number string
El número de teléfono del cliente (MAX 40; MIN 3).
Ejemplo: 11992149494
country_code string
El código de llamada del país del teléfono del cliente (MÁXIMO 3; MÍNIMO 1).
Valores posibles: Compruebe la
Referencia del país.
billing_address objeto
Especifica el objeto de dirección de facturación del cliente.
address_line_1 string
La línea de dirección de facturación principal del cliente (MÁX 255; MÍN 3).
Ejemplo: Calle 34 # 56 - 78
address_line_2 string
La línea de dirección de facturación secundaria del cliente (MÁX 255; MÍN 3).
Ejemplo: Apartamento 502, Torre I
city string
La ciudad considerada para la dirección de facturación (MÁX 255; MÍN 3).
Ejemplo: Bogotá
country enum
El país considerado para la dirección de facturación (MÁX 2; MÍN 2; ISO
3166-1).
Posibles valores del enum: Compruebe la referencia del país.
state string
El estado considerado para la dirección de facturación (MÁX 255; MÍN 3).
Ejemplo: Cundinamarca
zip_code string
El código postal considerado para la dirección de facturación (MÁX 11; MÍN 4).
Ejemplo: 111111
neighborhood string
El vecindario de la línea de dirección del cliente (MÁXIMO 255; MÍNIMO 2).
Ejemplo: Barrio 11
shipping_address objeto
Especifica el objeto de dirección de envío del cliente.
address_line_1 string
La línea de dirección de envío principal del cliente (MÁX 255; MÍN 3).
Ejemplo: Calle 34 # 56 - 78
address_line_2 string
La línea de dirección de envío secundaria del cliente (MÁX 255; MÍN 3).
Ejemplo: Apartamento 502, Torre I
city string
La ciudad considerada para la dirección de envío (MÁX 255; MÍN 3).
Ejemplo: Bogotá
country enum
El país considerado para la dirección de envío (MÁX 2; MÍN 2; ISO
3166-1).
Posibles valores del enum: Compruebe la referencia del país.
state string
El estado considerado para la dirección de envío (MÁX 255; MÍN 3).
Ejemplo: Cundinamarca
zip_code string
El código postal considerado para la dirección de envío (MÁX 11; MÍN 4).
Ejemplo: 111111
neighborhood string
El vecindario de la línea de dirección del cliente (MAX 255; MIN 2).
Ejemplo: Barrio 11
geolocation objeto
Geolocalización del cliente.
latitude string
Distancia angular de una ubicación en la Tierra al sur o al norte del ecuador (MÍN: 1, MÁX: 11)
Ejemplo: −34.4905
longitude string
Medición angular de la distancia de un punto de la Tierra al este o al oeste del observatorio de Greenwich. (MÍN: 1, MÁX: 11)
Ejemplo: −58.5555
additional_data objeto
Especifica el objeto additional_data. Este objeto no es obligatorio. Sin embargo, si envía esta información, la
experiencia de pago será mejorada para su usuario.
airline objeto
Especifica el objeto de la línea aérea. Los pasajeros y los billetes deben tener la misma información de pedido.
pnr string
Registro de nombre de pasajero (MÁX 10; MÍN 1).
Ejemplo: 1P-2UUGJW
type enum
Tipo de viaje.
Valores posibles: ONE_WAY, ROUNDTRIP, MULTIPLE_DESTINATIONS
legs array de objects
Especifica el array de objetos de piernas.
order integer
Un índice de ejecución (comienza con 1) que describe el orden de las etapas en una misma ruta.
Ejemplo: 2
route_order integer
Un índice continuo (que empieza por 1) que describe el orden de las rutas por tiempo. Por ejemplo: Si una orden contiene dos rutas: Nueva York→Londres→París (conexión en Londres), Nueva York→Londres debería tener route_order=1, order=1; Londres→París debería tener route_order=1, order=2; París→Londres→Nueva York: París→Londres debería tener route_order=2, order=1; Londres→Nueva York debería tener route_order=2, order=2.
Ejemplo 1
arrival_airport string
Código de aeropuerto IATA (MÁX 3; MÍN 3). Ver http://www.iata.org.
Ejemplo: MAM
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 (MÁX 6; MÍN 6).
Ejemplo: -03:00
arrival_datetime marca de tiempo
La fecha y hora de llegada en hora local al aeropuerto de llegada.
Ejemplo: 2022-05-09T24:46:54.786342Z
base_fare float
El importe de la transacción, excluidos impuestos y tasas, la unidad monetaria más pequeña (múltiplo de
0.0001).
Ejemplo: 23.5676
base_fare_currency string
La moneda utilizada para el monto de la transacción (MÁX 3; MÍN 3; ISO 4217).
Ejemplo: Compruebe la referencia del país.
carrier_code string
Código de operador IATA (MÁX 2; MÍN 2). Ver http://www.iata.org.
Ejemplo: KL
departure_airport string
Código IATA (MÁX 3; MÍN 3). Ver 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
Ciudad del aeropuerto de salida (MAX 2; MIN 2; ISO 3166-1).
Ejemplo: AR
departure_airport_timezone string
Zona horaria del aeropuerto (MÁX 6; MÍN 6).
Ejemplo: -03:00
departure_datetime marca de tiempo
La fecha y hora de salida en hora local en el 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 del servicio de clase, ambos
necesarios para la reserva (MAX 15; MIN 1).
Ejemplo: HL7LNR
fare_class_code string
El código de clase de tarifa de la aerolínea (MAX 1; MIN 1). Los valores pueden ser una letra (A-Z) pero pueden variar según la definición de la aerolínea. Consulta la referencia de información de la aerolínea.
Ejemplo: Sí
flight_number string
El número de vuelo asignado por la aerolínea (MÁX 5; MÍN 1).
Ejemplo: 842
stopover_code string
El código de escala (código de 1 letra que indica si el pasajero está autorizado a hacer una
escala.
Sólo se permiten dos tipos de caracteres O: Escala autorizada (la letra "O", no cero) / X: Escala
no
permitida).
Ejemplo: O
passengers array de objects
Especifica la matriz de objetos que representa a los pasajeros asociados a los billetes.
country enum
País donde se emitió el documento (MÁX 2; MÍN 2; ISO 3166-1).
Posibles valores del enum: Compruebe la referencia del país.
date_of_birth string
La fecha de nacimiento del pasajero en formato AAAA-MM-DD (MÁX 10; MÍN 10).
Ejemplo: 1990-02-28
document objeto
Especifica el objeto de documento para el pasajero.
document_number string
El número de documento del pasajero (MÁX 40; MÍN 3).
Ejemplo: 1093333333
document_type enum
El tipo de documento del pasajero (MÁX 6, MÍN 2).
Posibles valores del enum: Compruebe la
Referencia del país.
phone objeto
Especifica el objeto de teléfono para el pasajero.
country_code string
El código de llamada del país del teléfono del pasajero (MAX 3; MIN 1).
Valores posibles: Compruebe la
Referencia del país
number string
El número de teléfono del pasajero, sin el código del país (MAX 32; MIN 1).
Ejemplo: 1130292837
email string
El email del pasajero (MAX 255; MIN 3).
Ejemplo: [email protected]
first_name string
El nombre del pasajero (MÁX 255; MÍN 3).
Ejemplo: John
last_name string
El apellido del pasajero (MÁX 255; MÍN 3).
Ejemplo: Doe
loyalty_number string
Número de programa de fidelización de pasajeros (MÁX 20, MÍN 1).
Ejemplo: 254587547
loyalty_tier enum
Nivel del programa de fidelización de pasajeros (MÁX 255; MÍN 3).
Posibles valores del enum: Comprueba el
Nivel de fidelidad.
middle_name string
El segundo nombre del pasajero (MÁX 255; MÍN 3).
Ejemplo: Carlos
nationality enum
La nacionalidad del pasajero (MÁX 2; MÍN 2; ISO 3166-1).
Posibles valores del enum: Compruebe la referencia del país.
type enum
El tipo de pasajero (MÁX 1; MÍN 1).
Posibles valores del enum: Compruebe la lista de tipos de pasajero.
tickets array de objects
Especifica la matriz de boletos asociados con los pasajeros.
ticket_number string
Numero del billete (MÁX 14; MÍN 1).
Ejemplo: 7411823255523
e_ticket boolean
¿Es esto un billete electrónico?
Valores posibles: True o False
restricted boolean
Indica si el billete es reembolsable o no.
Valores posibles: True o False
total_fare_amount float
Importe total de la tarifa en la unidad monetaria más pequeña (múltiplo de 0,0001).
Ejemplo: 80000
total_tax_amount float
Importe total de los impuestos en la unidad monetaria más pequeña (múltiplo de 0,0001).
Ejemplo: 14800
total_fee_amount float
Importe total de la tarifa en la unidad monetaria más pequeña (múltiplo de 0,0001).
Ejemplo: 25200
issue objeto
Especifica el objeto en cuestión
address string
Dirección del agente que vendió el billete (MÁX 255; MÍN 3).
Ejemplo: Apartamento 502, Torre I
zip_code string
Código postal del agente que vendió el boleto.
Ejemplo: 1636
carrier_prefix_code string
Transportista emisor o validador. Se trata del prefijo AWB (Air waybill) código IATA de 3 cifras (MAX
3; MIN
3).
Ejemplo: 044
city string
Nombre de la ciudad del agente que vendió el boleto (MÁX 255; MÍN 3).
Ejemplo: Bogotá
country enum
Código del país donde se emitió el billete (MÁX 2; MÍN 2; ISO
3166-1).
Posibles valores del enum: Compruebe el código de país
de la lista.
date string
Fecha de emisión del billete.
Ejemplo: 1979-01-12
travel_agent_code string
Código de la agencia de viajes que emite el billete.
Ejemplo: 10655823
travel_agent_name string
Nombre con el que aparece el punto de venta en la lista de agencias o nombre de la franquicia (MAX 32;
MIN
1).
Ejemplo: Agencia ACME Inc
booking_system_code string
Código del sistema de reserva que emite el billete. (MÁX. 255; MÍN. 1).
Ejemplo: TEST001
booking_system_name string
Nombre del sistema de reservas que emite el billete. (MÁX. 255; MÍN. 1).
Ejemplo: Sistema de reservas
transport objeto
Especifica el objeto de transporte.
id string
La identificación del vehículo de transporte (MÁX 255; MÍN 1).
Ejemplo: ASONDAKS-1234
order objeto
Especifica el objeto de orden.
shipping_amount float
El monto de envío del pedido (múltiplo de 0.0001). Este campo es para fines informativos, el monto de envío ya está incluido en el monto final de la transacción y no se agrega por separado.
Ejemplo: 5190
fee_amount float
El monto de la tarifa del pedido (múltiplo de 0,0001). Este campo es para fines informativos, el monto de la tarifa ya está incluido en el monto final de la transacción y no se agrega por separado.
Ejemplo: 789.50
tip_amount float
El importe de la propina del pedido (múltiplo de 0,0001). Este campo es para fines informativos, 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 de objects
Especifica el objeto de impuestos del pedido.
type string
Tipo del impuesto.
Ejemplo: VAT
tax_base float
El importe base para aplicar el impuesto definido.
Ejemplo: 10000
value float
El monto del impuesto.
Ejemplo: 2100
percentage float
El porcentaje del impuesto.
Ejemplo: 21
items array de objetos
Especifica el objeto del elemento.
id string
El identificador único del elemento (MÁX 255; MÍN 3).
Ejemplo: 3214
name string
El nombre del elemento (MÁX 255; MÍN 3).
Ejemplo: iPhone 12 Pro Max
quantity int
La cantidad del artículo (MÁX 999; MÍN 1).
Ejemplo 1
unit_amount float
El importe unitario del artículo (múltiplo de 0,0001).
Ejemplo: 550
category string
La categoría del artículo (MÁX 255; MÍN 3).
Valores posibles: Compruebe la Lista de categorías de artículos.
brand string
La marca del artículo (MÁX 255; MÍN 3).
Ejemplo: manzana
sku_code string
La unidad de mantenimiento de existencias (SKU) del artículo (MÁX 255; MÍN 3).
Ejemplo: A2342
manufacture_part_number string
El número de pieza de fabricación del artículo (MÁX 255; MÍN 3).
Ejemplo: 345621234
discounts array de objects
Especifica el objeto de descuentos del pedido.
id string
ID del descuento (MAX 255; MIN 3).
Ejemplo: 10OFF
name string
El nombre del descuento (MAX 255; MIN 3).
Ejemplo: Oferta
unit_amount float
El importe del descuento (múltiplo de 0,0001).
Ejemplo: 100
tickets array de objetos
Especifica el objeto de tickets.
id string
Id del ticket (Mín: 1, máx: 255)
Ejemplo: 3214
name string
Nombre del billete (Mín: 1, máx: 255)
Ejemplo: Concierto
description string
Descripción del billete (Mín: 1, máx: 255)
Ejemplo: Concierto
type enum
Tipo de billete
VIRTUAL / FÍSICO
amount objeto
Especifica el objeto monto del pago, incluyendo su importe y moneda.
currency enum
La moneda utilizada para realizar el pago (MÁX 3; MÍN 3; ISO 4217).
Posibles valores del enum: Compruebe la referencia del país.
value number
Monto del pago (múltiplo de 0,0001).
Ejemplo: 111111
event objeto
Especifica el objeto de detalles del evento.
id string
Id del evento relacionado con el ticket
Ejemplo: AA01
name string
Nombre del evento (Mín: 1, máx: 255)
Ejemplo: Música
description string
Descripción del evento (Mín: 1, máx: 255)
Ejemplo: festival
type enum
Tipo de evento
FIESTA, UNIVERSIDAD, FESTIVAL, CIRCO, DEPORTES, CINE, TEATRO, CONCIERTO, OTROS.
date date
Fecha del evento
Ejemplo: 2025-10-25
address objeto
Especifica el objeto de dirección del evento.
address_line_1 string
La línea de dirección principal del evento (MÁXIMO 255; MÍNIMO 3).
Ejemplo: Calle 34 # 56 - 78
address_line_2 string
La línea de dirección de facturación secundaria del evento (MÁXIMO 255; MÍNIMO 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 (MÁXIMO 2; MÍNIMO 2,ISO
3166-1).
Posibles valores del enum: Compruebe el código de país
de la lista.
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 objeto
Especifica el objeto de detalles de envío.
type enum
Tipo de envío.
Ejemplo: ESTÁNDAR
Posibles valores del enum: Compruebe la referencia de envío.
description string
La descripción del envío (MAX 255; MIN 1).
Ejemplo: Envío de muestra de camiseta
carrier enum
El transportista utilizado para la entrega.
Ejemplo: UPS
Posibles valores del enum: Compruebe la referencia de envío.
deliver_at marca de tiempo
Fecha estimada de entrega (ISO 8601 MAX 27; MIN 27).
Ejemplo: 2025-09-17T20:43:54.786342Z
account_funding objeto
Especifica la estructura de financiamiento de la cuenta para transferencias y pagos.
sender objeto
Especifica la información del remitente.
national_entity enum
Tipo de entidad nacional del remitente. Valores posibles:
INDIVIDUALENTITY
first_name string
Nombre del remitente (MÁXIMO 80).
Ejemplo: John
last_name string
Apellido del remitente (MÁXIMO 80).
Ejemplo: Doe
legal_name string
Nombre legal del destinatario. Obligatorio si national_entity es ENTITY (MÁXIMO 80).
Ejemplo: Arcos dorados SA
email string
Correo electrónico del remitente (MÁXIMO 255; MÍNIMO 3).
Ejemplo: [email protected]
country enum
País del remitente (MÁX 2; MÍN 2; ISO 3166-1).
Posibles valores del enum: Compruebe la referencia del país.
date_of_birth date
Fecha de nacimiento del remitente en el YYYY-MM-DD formato (MÁXIMO 10; MÍNIMO 10).
Ejemplo: 1990-02-28
phone objeto
Especifica el objeto del teléfono.
country_code string
Código de país del teléfono del remitente (MÁXIMO 3; MÍNIMO 2).
Ejemplo: 57
number string
Número de teléfono del remitente (MÁXIMO 32; MÍNIMO 1).
Ejemplo: 3132450765
document objeto
Especifica el objeto del documento.
document_number string
Documento nacional de identificación del remitente (MÁXIMO 40; MÍNIMO 3).
Ejemplo: 1093333333
document_type enum
Tipo de documento del remitente (MÁXIMO 6; MÍNIMO 2).
Ejemplo: CC
address objeto
Especifica el objeto de dirección.
address_line_1 string
Dirección de facturación principal (MÁXIMO 255; MÍNIMO 3).
Ejemplo: Calle 34 # 56 - 78
address_line_2 string
Dirección de facturación secundaria (MÁXIMO 255; MÍNIMO 3).
Ejemplo: Apartamento 502, Torre I
city string
Ciudad para la dirección de facturación (MAX 255; MIN 3).
Ejemplo: Bogotá
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 para la dirección de facturación (MÁXIMO 255; MÍNIMO 3).
Ejemplo: Cundinamarca
zip_code string
Código postal de la dirección de facturación (MÁXIMO 11; MÍNIMO 4).
Ejemplo: 111111
recipient objeto
Especifica la información del destinatario.
national_entity enum
Tipo de entidad nacional del destinatario. Valores posibles:
INDIVIDUALENTITY
first_name string
Nombre del remitente (MÁXIMO 80).
Ejemplo: John
last_name string
Apellido del remitente (MÁXIMO 80).
Ejemplo: Doe
legal_name string
Nombre legal del destinatario. Obligatorio si national_entity es ENTITY (MÁXIMO 80).
Ejemplo: Arcos dorados SA
email string
Correo electrónico del destinatario (MÁXIMO 255; MÍNIMO 3).
Ejemplo: [email protected]
country enum
País del destinatario (MÁX 2; MÍN 2; ISO 3166-1).
Posibles valores del enum: Compruebe la referencia del país.
date_of_birth date
Fecha de nacimiento del destinatario en el YYYY-MM-DD formato (MÁXIMO 10; MÍNIMO 10).
Ejemplo: 1985-07-15
phone objeto
Especifica el objeto del teléfono.
country_code string
Código de país del teléfono del destinatario (MÁXIMO 3; MÍNIMO 2).
Ejemplo: 57
number string
Número de teléfono del destinatario (MÁXIMO 32; MÍNIMO 1).
Ejemplo: 3132450765
document objeto
Especifica el objeto del documento.
document_number string
Documento nacional de identificación del destinatario (MÁXIMO 40; MÍNIMO 3).
Ejemplo: 1093333333
document_type enum
Tipo de documento del destinatario (MÁXIMO 6; MÍNIMO 2).
Ejemplo: CC
address objeto
Especifica el objeto de dirección.
address_line_1 string
Dirección de facturación principal (MÁXIMO 255; MÍNIMO 3).
Ejemplo: Calle 34 # 56 - 78
address_line_2 string
Dirección de facturación secundaria (MÁXIMO 255; MÍNIMO 3).
Ejemplo: Apartamento 502, Torre I
city string
Ciudad para la dirección de facturación (MAX 255; MIN 3).
Ejemplo: Bogotá
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 para la dirección de facturación (MÁXIMO 255; MÍNIMO 3).
Ejemplo: Cundinamarca
zip_code string
Código postal de la dirección de facturación (MÁXIMO 11; MÍNIMO 4).
Ejemplo: 111111
seller_details objeto
Especifica el objeto de detalles del vendedor.
name string
El nombre legal del vendedor (MÁX 255; MÍN 3).
Ejemplo: John Doe
email string
El e-mail del vendedor (MÁX 255; MÍN 3).
Ejemplo: [email protected]
reference string
El código de identificación del vendedor (MÁX 255; MÍN 3).
Ejemplo: Vendedor
website string
La URL del sitio web del vendedor (MÁX 255; MÍN 3).
Ejemplo: https://www.test.com/1231324
industry enum
La industria del vendedor (MÁX 255; MÍN 3).
Posibles valores del enum: Compruebe la categoría Industria.
merchant_category_code string
MCC: el código de categoría de comerciante (MAX 235; MIN 1).
Ejemplo: 6199
country enum
El país del vendedor (MÁX 255; MÍN 3).
Posibles valores del enum: Compruebe la lista de códigos de país.
document objeto
Especifica el objeto del documento del vendedor.
document_number string
El número de documento del vendedor (MÁX 40; MÍN 3).
Ejemplo: 1093333333
document_type enum
El tipo de documento del vendedor (MÁX 6, MÍN 2).
Posibles valores del enum: Compruebe la
Referencia del país.
phone objeto
Especifica el objeto de número de teléfono del vendedor.
country_code string
El código de llamada del país del teléfono del vendedor (MAX 3; MIN 1). Valores posibles: Comprobar el
Country reference.
Ejemplo: 57
number string
El número de teléfono del vendedor, sin el código de país (MÁX 32; MÍN 1).
Ejemplo: 3132450765
address objeto
Especifica el objeto de dirección del vendedor.
address_line_1 string
La línea de dirección principal del vendedor (MÁX 255; MÍN 3).
Ejemplo: Calle 34 # 56 - 78
address_line_2 string
La línea de dirección de facturación secundaria del vendedor (MÁX 255; MÍN 3).
Ejemplo: Apartamento 502, Torre I
city string
La ciudad considerada para la dirección del vendedor (MÁX 255; MÍN 3).
Ejemplo: Bogotá
country enum
El país considerado para la dirección del vendedor (MAX 2; MIN 2,ISO
3166-1).
Posibles valores del enum: Compruebe el código de país
de la lista.
state string
El estado considerado para la dirección del vendedor (MÁX 255; MÍN 3).
Ejemplo: Cundinamarca
zip_code string
El código postal considerado para la dirección del vendedor (MÁX 11; MÍN 4).
Ejemplo: 111111
transportations array de objects
Especifica la matriz de transporte de objetos.
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 de objects
Especifica el array de objetos de piernas.
order integer
Un índice de ejecución (comienza con 1) que describe el orden de las etapas en una misma ruta.
route_order integer
Un índice en ejecución (comienza con 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
La ciudad de salida (MAX 255; MIN 1).
departure_timezone string
Zona horaria de salida (MAX 6; MIN 6).
departure_datetime string
La fecha y hora de salida en hora local en el momento de la salida.
departure_reference string
La 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
La ciudad de llegada (MAX 255; MIN 1).
arrival_timezone string
Zona horaria de llegada (MÁX 6; MÍN 6).
arrival_datetime string
La fecha y hora de llegada en hora local a la llegada.
arrival_reference string
La referencia de la llegada (MAX 255; MIN 1).
transport objeto
Especifica el objeto de transporte.
id string
La identificación del vehículo de transporte (MÁX 255; MÍN 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 objeto
Especifica los detalles de la transacción asociados con un pago.
id string
El identificador único de la transacción (MAX 64; MIN 36).
Ejemplo: 7bf8f1f6-4081-41ec-a024-a927056e00ab
type string
Tipo de transacción.
Ejemplo: PURCHASE
status enum
Estado de la transacción.
Ejemplo: SUCCEEDED
category string
La categoría del método de pago utilizado en la transacción.
Ejemplo: CARD
amount string
El importe de la transacción.
Ejemplo: 100
provider_id string
El id del proveedor que procesó la transacción.
Ejemplo: DLOCAL
payment_method objeto
Especifica los detalles del método de pago utilizado en la transacción.
vaulted_token string
El token almacenado para un payment_method previamente almacenado. Si se crea un pago utilizando un
vaulted_token, no es necesario enviar también un token , se puede definir como nulo (MAX: 64; MIN: 36).
Ejemplo: 8604911d-5ds9-229e-8468-bd41abear14s
type string
Tipo de método de pago. Obligatorio para DIRECT o REDIRECT flujo de trabajo. Necesario al integrar monederos, incluso cuando se utiliza el SDK.
Posibles valores de enum:
Posibles valores de enum: Comprueba la referencia del tipo de pago.
vault_on_success boolean
Marcar para inscribir la tarjeta después de un pago exitoso.
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 se crea un pago utilizando un
token, no es necesario enviar también un vaulted_token, se puede definir como null. No es necesario para
pagos consecutivos (MAX: 64; MIN: 36).
Ejemplo: 5104911d-5df9-229e-8468-bd41abea1a4s
parent_payment_method_type enum
Al utilizar una billetera para realizar pagos a través de una integración directa, este campo indica el proveedor del cual se obtuvo la información de la tarjeta.
Ejemplo: APPLE_PAY
detail objeto
Especifica el objeto de detalle del método de pago, que proporciona detalles de las diferentes transacciones
categoría
que forman parte del objeto de método de pago.
card objeto
Especifica los detalles del método de pago cuando se utiliza una tarjeta.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
real.
Valores posibles: True o False
capture boolean
Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta le permite
a
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 1).
Ejemplo: 3
first_installments_deferral integer
Número de meses a esperar para debitar la primera cuota.
Ejemplo 1
installments_type string
Tipo de cuotas utilizadas en el pago con tarjeta.
Ejemplo: cadena
installments_amount integer
El importe del plazo incluye los intereses asociados al plazo y la información
es
definida por el proveedor.
Ejemplo: 3
soft_descriptor string
El descriptor pasado por transacción a nuestra plataforma. Se presentará en el extracto bancario
del cliente (MAX 15; MIN 0).
Ejemplo: EMPRESA1
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á el NSU.
Ejemplo: 200000000012
voucher string
El identificador único del recibo de pago asignado por el banco emisor para una transacción con tarjeta
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 objeto
Especifica los detalles de la tarjeta.
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
PCI.
Ejemplo: Fannie Weissnat
iin integer
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 41961111
lfd integer
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: VISA
issuer_name string
El emisor de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: Banco Galicia
category string
La categoría del emisor de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: Oro
type string
El tipo de emisor de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: CRÉDITO, DÉBITO o TARJETA_CARGA
fingerprint string
Cuando un cliente registra una tarjeta de crédito varias veces relacionada con una o varias cuentas Yuno, se generarán múltiples vaulted_tokens, pero la huella digital le permite identificar cuándo se usa la misma tarjeta para el cliente (MÁXIMO 255; MÍNIMO 3).
Ejemplo: 55a7fe38-cdc3-45dc-8c5f-820751799c76
three_d_secure objeto
Especifica los detalles de la transacción 3DS.
three_d_secure_setup_id string
ID de configuración obtenido para el flujo directo de 3DS.
Ejemplo: 24127d61-b852-42fb-acd4-1ee661645376
version enum
Hace referencia 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 de la ECI proporcionado por el servicio 3d Secure
. El Indicador de Comercio Electrónico (ICE) 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 rellenado en el pedido autorización (MAX: 2,
MIN: 0).
Ejemplo: 04
cryptogram string
Este campo debe completarse con el resultado del criptograma proporcionado por el servicio
servicio 3DSecure. En las transacciones Visa, representa el Cardholder Authentication Verification
Cardholder Authentication Verification Value (CAVV), un valor criptográfico generado por el Emisor como prueba de pago
autenticación durante la compra en línea para poder acogerse a la protección contra devoluciones de cargo. Las transacciones de MasterCard
tienen un valor similar denominado Accountholder Authentication Value (AAV) o el
Campo Universal de Autenticación del Titular de la Tarjeta (UCAF). Al enviar una transacción para
autorización, el comerciante debe incluir el CAVV o AAV/UCAF para demostrar que el titular de la tarjeta ha sido autenticado.
ha sido autenticado. Suele estar codificado en base64 (MAX: 40, MIN: 0).
Ejemplo: BA0BB1Z3N5Q4kjkBU3c3ELGUsJY =
transaction_id string
Para 3DS v1:
Es el identificador único de transacción. Es generado automáticamente por el MPI. Suele tener
normalmente de 28 bytes de longitud y codificado en base64. Se conoce comúnmente como XID (MAX: 40, MIN:
0).
Para 3DS v2:
Identificador de transacción universalmente único asignado por el DS para identificar una única transacción.
(MÁX: 36, MÍN:36).
Ex para V1: "TjY0MjAxRjA4MD4987DUzMzYyNjU="
Ex para V2: “c4e59ceb-a382-4d6a-bc87-385d591fa09d”
directory_server_transaction_id string
ID de 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 3-D Secure. Le informa si la autenticación fue exitosa (Y), falló (N), no pudo completarse (U) o solo se intentó (A).
Ejemplo: Sí
acs_id string
Identificador único proporcionado por el Servidor de Control de Acceso (ACS) durante el proceso de autenticación 3-D Secure.
Ejemplo: ACS-1234567890
network_token objeto
Información sobre el token de red utilizado para la transacción. Si es aplicable.
network enum
El proveedor asociado al token proporcionado. VISA, MASTERCARD, AMERICAN_EXPRESS.
Ejemplo: MASTERCARD
status enum
Estado del token del método de pago. CREADO, ACTIVO, SUSPENDIDO, CANCELADO.
Ejemplo: ACTIVO
par string
Referencia de cuenta de pago.
Ejemplo: MCC123456789012
token_data objeto
Detalles del token.
number number
[Obligatorio] El número de token sin separadores (MÁXIMO 19; MÍNIMO 8) solo está disponible para comerciantes con certificación PCI.
Ejemplo: 450799000001234
holder_name string
Nombre completo del titular de la tarjeta tal como aparece en el Token (MÁXIMO 26; MÍNIMO 3).
Ejemplo: John Doe
iin number
El número de identificación de la institución (IIN) se refiere a los primeros dígitos de un número de token de red emitido por una institución financiera (MÁX. 8; MÍN. 6).
Ejemplo: 45079900
lfd number
Últimos cuatro dígitos del token de red (MAX 4; MIN 4).
Ejemplo: 1234
expiration_month number
Mes de vencimiento del token de red (MM) (MÁXIMO 2; MÍNIMO 2).
Ejemplo: 12
expiration_year number
Año de vencimiento del token de red (AAAA) (MÁXIMO 4; MÍNIMO 2).
Ejemplo: 2027
cryptogram string
[Obligatorio] - El criptograma único generado por el emisor para el token de red en uso en la transacción.
electronic_commerce_indicator string
[Solo requerido para ciertos proveedores] - En caso de que el token haya sido autenticado por Mastercard el campo deberá ser configurado a 02. Para Visa o tokens no autenticados, no es necesario enviar el campo.
token_requestor_id string
[Solo requerido para ciertos proveedores] - ID del solicitante del token del comerciante
response objeto
Detalles de la transacción de red.
code number
Código de respuesta del proveedor de servicios.
Ejemplo: tuvo éxito
message number
Código de respuesta del proveedor de servicios.
Ejemplo: transacción exitosa
stored_credentials objeto
Indica el tipo de procesamiento de la transacción.
reason enum
Indica el tipo de procesamiento de la transacción.Enum:TARJETA_EN_ARCHIVO, SUSCRIPCIÓN, TARJETA_EN_ARCHIVO NO PROGRAMADA
Ejemplo: SUSCRIPCIÓN
usage enum
Este campo le permite indicar si es la primera vez que se utiliza el vaulted_token/network_token para un pago o si ya se ha utilizado para un pago anterior. Enum: PRIMERO, USADO
Ejemplo: USADO
subscription_agreement_id string
Este campo 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 utiliza para rastrear y hacer referencia a transacciones específicas, en particular en escenarios de pago recurrentes, lo que garantiza la coherencia y la trazabilidad durante todo el ciclo de vida del pago (MÁXIMO 255; MÍNIMO 3).
Ejemplo: 583103536844189
wallet objeto
Especifica los detalles del método de pago cuando se usa una billetera.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
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 le permite
a
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 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
Adquirir el código de respuesta.
Ejemplo: 742A64
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
customer_data objeto
Especifica los detalles del cliente.
email string
El email del cliente (MÁX 255; MÍN 3).
Ejemplo: [email protected]
first_name string
El nombre del cliente (MAX 32, MIN 8).
Ejemplo: John
last_name string
El apellido del cliente (MÁX 32, MÍN 8).
Ejemplo: Doe
username string
El nombre de usuario del cliente en la plataforma (MÁX 32, MÍN 8).
Ejemplo: John_Doe_01
identification_type string
El tipo de documento del cliente (MÁX 32, MÍN 8).
Compruebe la
Referencia del país. Ejemplo: DNI
identification_number string
El número de identificación del cliente (MÁX 32, MÍN 8).
Ejemplo: 34566123
fee_details objeto
Especifica los detalles de las tarifas.
amount float
Importe de la transacción (múltiplo de 0,0001).
Ejemplo: 40.5
card_data objeto
Especifica los detalles de la tarjeta.
iin integer
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 45079900
lfd integer
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 4).
Ejemplo: 0010
number_length integer
La longitud del número de la tarjeta (MÁX 19; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: visa
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
PCI.
Ejemplo: JUAN DOE
bnpl objeto
Especifica los detalles del método de pago cuando se utiliza BNPL.
installments integer
Las cuotas del préstamo (MÁX 50; MÍN 1).
Ejemplo: 10
provider_image string
La URL del proveedor (MÁXIMO 255; MÍNIMO 3).
Ejemplo: https://www.company.com/
redirect_url string
La URL con la versión completa del ticket en caso de que quiera redirigir a su cliente (MAX
255;
MIN
3).
Ejemplo: https://www.company.com/ticket_1231324
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
customer_data objeto
Especifica los detalles del cliente.
name string
El nombre legal del cliente (MÁX 32, MÍN 8).
Ejemplo: Nombre legal
username string
Nombre de usuario del cliente en la plataforma del proveedor (MÁX 32, MÍN 8).
Ejemplo: Legal_name_01
tax_id_type string
El identificador fiscal del cliente (MÁX 32, MÍN 8).
Ejemplo: CUIT
tax_id string
El número de identificación fiscal del cliente (MÁX 32, MÍN 8).
Ejemplo: 20-34566123-7
type string
El tipo de crédito (MÁX 255; MÍN 3).
Ejemplo: PERSONAL/NEGOCIOS
area string
La industria del cliente (MÁX 255; MÍN 3).
Ejemplo: OTROS
role string
Rol del cliente en la empresa (MÁX 255; MÍN 3).
Ejemplo: PROPIETARIO
bank_transfer objeto
Especifica los detalles del método de pago cuando se utiliza transferencia bancaria.
provider_image string
La URL del proveedor (MÁXIMO 255; MÍNIMO 3).
Ejemplo: https://www.company.com/logo
account_type string
Tipo de cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: CHEQUES/AHORROS
bank_name string
Nombre del banco asociado a la cuenta (MÁX 255; MÍN 3).
Ejemplo: Banco Galicia
bank_id string
Identificador del banco seleccionado cuando el proveedor requiere elegir uno. Solo se devuelve si el comerciante ha enviado un valor.
Ejemplo: Galicia
beneficiary_name string
El nombre del titular de la cuenta (MÁX 255; MÍN 3).
Ejemplo: John Doe
bank_account string
El número de la cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: 54653211313333
bank_account_2 string
El número secundario de la cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: 78900000000123
beneficiary_document_type string
Tipo de documento del titular de la cuenta (MÁX 255; MÍN 3).
Valores posibles: Compruebe la
Referencia del país. Ejemplo: DNI
beneficiary_document string
Número de documento del titular de la cuenta (MÁX 255; MÍN 3).
Ejemplo: 54666897
reference string
Código de referencia para el usuario (MÁX 255; MÍN 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á el nsu.
Ejemplo: 200000000012
payment_instruction string
Instrucciones de pago relacionadas con el pago (MÁX 255; MÍN 3).
Ejemplo: Vaya a su cuenta bancaria y transfiera el importe utilizando la referencia detallada
a continuación
redirect_url string
La URL con la versión completa del ticket en caso de que quiera redirigir a su cliente (MAX
255;
MIN
3).
Ejemplo: https://www.company.com/ticket_1231324
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
ticket objeto
Especifica los detalles del método de pago cuando se usa el boleto.
type string
El tipo de billete.
Ejemplo: número, código de barras, personalizado, código_referencia, qr
benefit_type enum
Tipo de beneficio del usuario por método de pago del boleto. JUNAEB, PRIVADO
Ejemplo: PRIVADO
provider_number integer
El número del billete.
Ejemplo: 13141
provider_barcode integer
El código de barras del billete.
Ejemplo: 456789009878765u7654
provider_logo string
El logo del billete.
Ejemplo: https://www.company.com/logo
provider_format string
El formato del billete.
Ejemplo: código de barras, personalizado
payment_instruction string
Instrucciones de pago relacionadas con el pago (MÁX 255; MÍN 3).
Ejemplo: Dirígete a tu tienda más cercana y paga el importe total utilizando la referencia que se detalla a continuación
redirect_url string
La URL con la versión completa del ticket.
Ejemplo: https://www.company.com/ticket_1231324
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
payment_link objeto
Especifica los detalles del método de pago cuando se utiliza un enlace de pago.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
real.
Valores posibles: True o False
capture boolean
Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta le permite
a
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
expires_at marca de tiempo
Fecha de vencimiento de los métodos de pago. "aaaa-MM-dd HH:mm:ss.SSSz"
Ejemplo: 2026-05-09T20:46:54.786342Z
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 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
Adquirir el código de respuesta.
Ejemplo: 742A64
customer_data objeto
Especifica los detalles del cliente.
email string
El email del cliente (MÁX 255; MÍN 3).
Ejemplo: [email protected]
first_name string
El nombre del cliente (MAX 32, MIN 8).
Ejemplo: John
last_name string
El apellido del cliente (MÁX 32, MÍN 8).
Ejemplo: Doe
username string
El nombre de usuario del cliente en la plataforma (MÁX 32, MÍN 8).
Ejemplo: John_Doe_01
identification_type string
El tipo de documento del cliente (MÁX 32, MÍN 8).
Valores posibles: Comprueba la
Referencia del país. Ejemplo: DNI
identification_number string
El número de identificación del cliente (MÁX 32, MÍN 8).
Ejemplo: 34566123
fee_details objeto
Especifica los detalles de las tarifas.
amount float
Importe de la transacción (múltiplo de 0,0001).
Ejemplo: 40.5
card_data objeto
Especifica los detalles de la tarjeta.
iin integer
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 45079900
lfd integer
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 4).
Ejemplo: 0010
number_length integer
La longitud del número de la tarjeta (MÁX 19; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: visa
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
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 del código_respuesta.
Ejemplo: Transacción exitosa
reason string
El motivo de la transacción. Aplica para transacciones secundarias, como devoluciones 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 (MÁX 255; MÍN 3).
Ejemplo: Compra en la web
merchant_reference string
La referencia generada por el comerciante para identificar el pago/transacción.
Ejemplo: AA01
merchant_advice_code enum
Código de aviso comercial normalizado para transacciones rechazadas; úselo para guiar el comportamiento de reintento y el enrutamiento.
Ejemplo: TRY_AGAIN_LATER
merchant_advice_code_message string
Mensaje legible para humanos que explica el consejo devuelto en merchant_advice_code.
Ejemplo: Reintentar dentro de 24 horas
provider_data objeto
Especifica los datos del proveedor que procesó el pago.
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
La identificación 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 (MÁX 64; MÍN 36).
Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b
status enum
Estado de la transacción.
Ejemplo: SUCCEEDED
status_detail string
El estado_detalle de la transacción.
Ejemplo: APROBADO
merchant_advice_code string
Código de aviso comercial sin procesar devuelto por el proveedor para transacciones rechazadas.
Ejemplo: 25
merchant_advice_code_message string
Mensaje del proveedor que explica el significado del Código de aviso comercial sin procesar.
Ejemplo: Reintentar después de 24 horas
response_code string
El código que representa la respuesta del resultado de la transacción del proveedor.
Ejemplo: SUCCEEDED
response_message string
Mensaje para proporcionar información adicional sobre el estado de la operación.
Ejemplo: Transacción exitosa
iso8583_response_code objeto
El código del estándar internacional para tarjetas de transacciones financieras originó la mensajería de intercambio (ISO 8583).
Ejemplo: 00
iso8583_response_message objeto
El mensaje de la tarjeta estándar internacional para transacciones financieras se originó mediante mensajería de intercambio (ISO 8583).
Ejemplo: Aprobado o completado exitosamente
raw_notification array de objetos
La notificación directa del proveedor para la transacción. El formato del objeto depende de la
respuesta del proveedor.
Ejemplo: JSON, XML, cadena
detail objeto
Especifica el objeto de detalle del método de pago devuelto por el proveedor, que especifica los detalles de las
diferentes tipos
de transacción.
card objeto
Especifica los detalles del método de pago cuando se utiliza una tarjeta.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
real.
Valores posibles: True o False
capture boolean
Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta le permite
a
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 1).
Ejemplo: 3
first_installments_deferral integer
Número de meses a esperar para debitar la primera cuota.
Ejemplo 1
installments_type string
Tipo de cuotas utilizadas en el pago con tarjeta.
Ejemplo: cadena
installments_amount integer
El importe del plazo incluye los intereses asociados al plazo y la información
es
definida por el proveedor.
Ejemplo: 3
soft_descriptor string
El descriptor pasado por transacción a nuestra plataforma. Se presentará en el extracto bancario
del cliente (MAX 15; MIN 0).
Ejemplo: EMPRESA1
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á el NSU.
Ejemplo: 200000000012
voucher string
El identificador único del recibo de pago asignado por el banco emisor para una transacción con tarjeta
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 objeto
Especifica los detalles de la tarjeta.
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
PCI.
Ejemplo: Fannie Weissnat
iin integer
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 41961111
lfd integer
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: VISA
issuer_name string
El emisor de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: Banco Galicia
category string
La categoría del emisor de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: Oro
type string
El tipo de emisor de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: CRÉDITO, DÉBITO o TARJETA_CARGA
wallet objeto
Especifica los detalles del método de pago cuando se usa una billetera.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
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 le permite
a
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 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
Adquirir el código de respuesta.
Ejemplo: 742A64
customer_data objeto
Especifica los detalles del cliente.
email string
El email del cliente (MÁX 255; MÍN 3).
Ejemplo: [email protected]
first_name string
El nombre del cliente (MAX 32, MIN 8).
Ejemplo: John
last_name string
El apellido del cliente (MÁX 32, MÍN 8).
Ejemplo: Doe
username string
El nombre de usuario del cliente en la plataforma (MÁX 32, MÍN 8).
Ejemplo: John_Doe_01
identification_type string
El tipo de documento del cliente (MÁX 32, MÍN 8).
Compruebe la
Referencia del país. Ejemplo: DNI
identification_number string
El número de identificación del cliente (MÁX 32, MÍN 8).
Ejemplo: 34566123
fee_details objeto
Especifica los detalles de las tarifas.
amount float
Importe de la transacción (múltiplo de 0,0001).
Ejemplo: 40.5
card_data objeto
Especifica los detalles de la tarjeta.
iin integer
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 45079900
lfd integer
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 4).
Ejemplo: 0010
number_length integer
La longitud del número de la tarjeta (MÁX 19; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: visa
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
PCI.
Ejemplo: JUAN DOE
bnpl objeto
Especifica los detalles del método de pago cuando se utiliza BNPL.
installments integer
Las cuotas del préstamo (MÁX 50; MÍN 1).
Ejemplo: 10
provider_image string
La URL del proveedor (MÁXIMO 255; MÍNIMO 3).
Ejemplo: https://www.company.com/logo
redirect_url string
La URL con la versión completa del ticket en caso de que quiera redirigir a su cliente (MAX
255;
MIN
3).
Ejemplo: https://www.company.com/ticket_1231324
customer_data objeto
Especifica los detalles del cliente.
name string
El nombre legal del cliente (MÁX 32, MÍN 8).
Ejemplo: Nombre legal
username string
Nombre de usuario del cliente en la plataforma del proveedor (MÁX 32, MÍN 8).
Ejemplo: Legal_name_01
tax_id_type string
El identificador fiscal del cliente (MÁX 32, MÍN 8).
Ejemplo: CUIT
tax_id string
El número de identificación fiscal del cliente (MÁX 32, MÍN 8).
Ejemplo: 20-34566123-7
type string
El tipo de crédito (MÁX 255; MÍN 3).
Ejemplo: PERSONAL/NEGOCIOS
area string
La industria del cliente (MÁX 255; MÍN 3).
Ejemplo: OTROS
role string
Rol del cliente en la empresa (MÁX 255; MÍN 3).
Ejemplo: PROPIETARIO
bank_transfer objeto
Especifica los detalles del método de pago cuando se utiliza transferencia bancaria.
provider_image string
La URL del proveedor (MÁXIMO 255; MÍNIMO 3).
Ejemplo: https://www.company.com/
account_type string
Tipo de cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: CHEQUES/AHORROS
bank_name string
Nombre del banco asociado a la cuenta (MÁX 255; MÍN 3).
Ejemplo: Banco Galicia
bank_id string
Identificador del banco seleccionado por el pagador cuando se proporciona en el pago pedido original.
Ejemplo: Galicia
beneficiary_name string
El nombre del titular de la cuenta (MÁX 255; MÍN 3).
Ejemplo: John Doe
bank_account string
El número de la cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: 54653211313333
bank_account_2 string
El número secundario de la cuenta bancaria (MÁX 255; MÍN 3).
Ejemplo: 78900000000123
beneficiary_document_type string
Tipo de documento del titular de la cuenta (MÁX 255; MÍN 3).
Valores posibles: Compruebe la
Referencia del país. Ejemplo: DNI
beneficiary_document string
Número de documento del titular de la cuenta (MÁX 255; MÍN 3).
Ejemplo: 54666897
payment_instruction string
Instrucciones de pago relacionadas con el pago (MÁX 255; MÍN 3).
Ejemplo: Vaya a su cuenta bancaria y transfiera el importe utilizando la referencia detallada
a continuación
redirect_url string
La URL con la versión completa del ticket en caso de que quiera redirigir a su cliente (MAX
255;
MIN
3).
Ejemplo: https://www.company.com/ticket_1231324
ticket objeto
Especifica los detalles del método de pago cuando se usa el boleto.
type string
El tipo de billete.
Ejemplo: número, código de barras, personalizado, código_referencia, qr
provider_number integer
El número del billete.
Ejemplo: 13141
provider_barcode integer
El código de barras del billete.
Ejemplo: 456789009878765u7654
provider_logo string
El logo del billete.
Ejemplo: https://www.company.com/logo
provider_format string
El formato del billete.
Ejemplo: código de barras, personalizado
redirect_url string
La url con la versión completa del ticket.
Ejemplo: https://www.company.com/ticket_1231324
payment_link objeto
Especifica los detalles del método de pago cuando se utiliza un enlace de pago.
verify boolean
Utilizando amount = 0 y verify = true, puede verificar la tarjeta del usuario sin autorizar un importe real.
real.
Valores posibles: True o False
capture boolean
Decide si autorizar el pago o capturarlo. Autorizar un pago con tarjeta le permite
a
reservar fondos en la cuenta bancaria de un cliente.
Valores posibles: True o False
installments integer
Las cuotas de la tarjeta (MÁX 50; MÍN 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
Adquirir el código de respuesta.
Ejemplo: 742A64
customer_data objeto
Especifica los detalles del cliente.
email string
El email del cliente (MÁX 255; MÍN 3).
Ejemplo: [email protected]
first_name string
El nombre del cliente (MAX 32, MIN 8).
Ejemplo: John
last_name string
El apellido del cliente (MÁX 32, MÍN 8).
Ejemplo: Doe
username string
El nombre de usuario del cliente en la plataforma (MÁX 32, MÍN 8).
Ejemplo: John_Doe_01
identification_type string
El tipo de documento del cliente (MÁX 32, MÍN 8).
Valores posibles: Compruebe la
Referencia del país. Ejemplo: DNI
identification_number string
El número de identificación del cliente (MÁX 32, MÍN 8).
Ejemplo: 34566123
fee_details objeto
Especifica los detalles de las tarifas.
amount float
Importe de la transacción (múltiplo de 0,0001).
Ejemplo: 40.5
card_data objeto
Especifica los detalles de la tarjeta.
iin integer
El número de identificación del emisor (NII) se refiere a los primeros dígitos del número de la tarjeta de pago emitida por una entidad financiera (MÁX. 8; MÍN. 6).
emitida por una entidad financiera (MAX 8; MIN 6).
Ejemplo: 45079900
lfd integer
Los últimos cuatro dígitos de la tarjeta (MÁX 4; MÍN 4).
Ejemplo: 0010
number_length integer
La longitud del número de la tarjeta (MÁX 19; MÍN 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
Información de la marca de la tarjeta (MÁX 255; MÍN 3).
Ejemplo: visa
holder_name string
Nombre completo del titular de la tarjeta tal y como aparece en la tarjeta (MAX 26; MIN 3) sólo disponible para comercios certificados PCI
PCI.
Ejemplo: John Doe
connection_data objeto
Especifica el objeto de datos de conexión, que representa la conexión utilizada para procesar la transacción.
id string
El identificador único de la conexión de pago en Yuno (MAX 64; MIN 36).
Ejemplo: 88292fd3-bf5b-4b23-bb95-7186ba4e7f88
created_at marca de tiempo
La fecha y hora en que se creó la transacción.
Ejemplo: 2022-05-09T20:46:54.786342Z
updated_at marca de tiempo
La fecha y hora desde la última vez que se actualizó la transacción.
Ejemplo: 2022-05-09T20:46:54.786342Z
split_marketplace array de objects
Matriz de objetos del mercado dividido
recipient_id string
El identificador único del destinatario en el sistema Yuno.
Debes proporcionar el 'cipient_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 corresponde.
Debes proporcionar el provider_recipient_id o el recipient_id (generado por Yuno) al crear un pago.
type string
El tipo de división.
Ejemplo: PURCHASE
merchant_reference string
Identificador único opcional para la transacción dividida.
amount objeto
Define el monto de la división.
value float
El importe dividido (múltiplo de 0,0001).
currency string
La moneda utilizada para realizar el pago (MAX 3; MIN 3; ISO 4217).
liability objeto
Información opcional sobre la responsabilidad del destinatario por tarifas y contracargos.
processing_fee string
Indica a quién se cobrará la tasa de transacción.
chargebacks boolean
El destinatario es responsable en caso de una devolución de cargo.
transactions_history array de objects
La lista de las transacciones que forman parte de un pago. Dependerá de cuántos proveedores haya configurado en tu ruta de método de pago.
workflow enum
El flujo de trabajo de pago. Indica si la integración utilizará el SDK de Yuno o será una conexión back to back
(Implementación de tarjeta sólo disponible para comerciantes que cumplan con PCI).
Posibles valores de enum:
SDK_CHECKOUT: Utiliza el SDK de Yuno.DIRECT: Integración back to back con la información del proveedor para una experiencia de pago personalizada. experiencia.REDIRECT: Integración back to back con redirección de proveedores.
callback_url string
La URL donde redirigir al cliente después del pago. Sólo se requiere para las integraciones DIRECT que tienen una
redirección (MAX 526; MIN 3).
Ejemplo: https://www.company.com/customer_1231324
metadata array de objects
Especifica una lista de pares clave-valor personalizados asociados al pago (para referencias internas, segmentación o etiquetas de flujo de trabajo). Puedes añadir hasta 100 objetos de metadatos.
metadata object objeto
Especifica una clave de metadatos y el valor respectivo.
Se utiliza para adjuntar un contexto definido por el comerciante (por ejemplo: order_id, customer_tier). Evita enviar datos sensibles o personales.
order_id, customer_tier). Evita enviar datos sensibles o personales.key string
Especifica una clave de metadatos (MAX 48).
Ejemplo: edad
value string
Especifica el valor de la clave de metadatos definida (MAX 512).
Ejemplo: 28
routing_rules array de objects
Devuelve la información de las reglas de enrutamiento durante la creación del pago.
smart_routing bool
Especifica si una transacción pasó por la función de enrutamiento inteligente o no.
Ejemplo: falso
monitors bool
Especifica si una transacción pasó por la función de monitores o no.
Ejemplo: falso
condition objeto
Objeto con la información correspondiente a la condición de ruta que se aplica al pago.
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 (MÁX 64; MÍN 36).
Ejemplo: 7304911d-5df9-429e-8488-ad41abea1a4c
subscription struct
Devuelve los detalles de la suscripción asociados al pago.
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 de objects
Proporciona información sobre los escaneos de fraude utilizados para el pago.
status enum
El estado final del proceso de selección del pago.
Ejemplo: SUCCEEDED
stand_alone boolean
Campo opcional para enviar el pago indicando si la detección de fraude es independiente, lo que significa que no se ejecutará un pago después de realizar la detección de fraude. Puede utilizar este campo mientras crea su ruta CARD.
Ejemplo: falso
transactions objeto
Especifica los detalles de la transacción asociados con un proceso de verificación del pago.
id string
El id de la transacción fraudulenta (MAX 64; MIN 36).
Ejemplo: ft12
type enum
Tipo de transacción fraudulenta.
Posibles valores de enum: PRE_AUTH, POS_AUTH
status enum
El estado de la transacción (MÁX 255; MÍN 3).
Ejemplo: SUCCEEDED
response_code enum
El código de respuesta de la transacción.
Ejemplo: FRAUDE_VERIFICADO
response_message enum
El mensaje de respuesta de la transacción.
Ejemplo: Fraude aprobado
provider_data objeto
Especifica los datos del proveedor que procesó el pago.
provider_id string
El id del proveedor de prevención de fraude.
Ejemplo: VENTA LIQUIDADA
transaction_id string
El id de la transacción fraudulenta del proveedor.
Ejemplo: AA001234567
status string
El estado de la transacción de fraude del proveedor.
Ejemplo: APM
score string
La puntuación del proveedor para la transacción.
Ejemplo: 0.7
raw_response string
El raw_response del proveedor.
Ejemplo: JSON
created_at marca de tiempo
La fecha y hora en que se creó la detección de fraude.
Ejemplo: 2022-05-09T20:46:54.786342Z
updated_at marca de tiempo
La fecha y la hora desde la última vez que se actualizó la detección de fraude.
Ejemplo: 2022-05-09T20:46:54.786342Z