Saltar al contenido principal
En esta sección encontrarás todos los tipos de reporte y los campos relacionados disponibles al generar tus reportes. Ten en cuenta la descripción de los campos, donde puedes encontrar el origen de los datos y su disponibilidad. Yuno ofrece varios tipos de reporte: A continuación, encontrarás los detalles de cada tipo de reporte.
ActualizacionesLos campos de los reportes están sujetos a modificaciones, y se pueden agregar nuevos campos al final de la estructura actual.

Reporte de pagos

ParámetroTipoDescripciónEjemplo
account_idstringEl identificador único de la cuenta (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120002
airline_leg_arrival_airportstringCódigo del aeropuerto de destino del tramo de vuelo.JFK
airline_leg_base_farenumberTarifa base del tramo de vuelo antes de impuestos y cargos.250
airline_leg_base_fare_currencyenumMoneda en la que se cobra la tarifa base (ISO 4217).USD
airline_leg_carrier_codestringCódigo de la aerolínea transportista del tramo de vuelo.AA
airline_leg_departure_airportstringCódigo del aeropuerto de salida del tramo de vuelo.LAX
airline_leg_departure_datetimedatetimeFecha y hora de salida del vuelo.2024-09-12 15:30
airline_leg_fare_basis_codestringCódigo que define las reglas tarifarias del boleto.Y26HNR
airline_leg_fare_class_codestringCódigo de clase del boleto (p. ej., económica, ejecutiva).Y
airline_leg_flight_numberstringNúmero del vuelo del tramo específico.100
airline_leg_stopover_codeenumIndica si el vuelo tiene escala (Y/N).N
airline_passenger_countrystringPaís de residencia del pasajero.US
airline_passenger_date_of_birthdateFecha de nacimiento del pasajero.1990-05-14
airline_passenger_document_numberstringNúmero del documento de identificación del pasajero.A12345678
airline_passenger_document_typeenumTipo de documento de identificación (p. ej., pasaporte, documento de identidad).PASSPORT
airline_passenger_emailstringDirección de email del pasajero.passenger@email.com
airline_passenger_first_namestringNombre del pasajero.John
airline_passenger_last_namestringApellido del pasajero.Doe
airline_passenger_loyalty_numberstringNúmero del programa de lealtad del pasajero.123456789
airline_passenger_loyalty_tierenumNivel del programa de lealtad del pasajero (p. ej., Gold, Platinum).Gold
airline_passenger_middle_namestringSegundo nombre del pasajero (si aplica).Andrew
airline_passenger_nationalitystringNacionalidad del pasajero.US
airline_passenger_phone_country_codestringCódigo de país del número de teléfono del pasajero.1
airline_passenger_phone_numberstringNúmero de teléfono del pasajero.555-1234
airline_passenger_typeenumTipo de pasajero (p. ej., adulto, niño, infante).Adulto
airline_ticket_e_ticketbooleanIndica si el boleto es electrónico (true/false).TRUE
airline_ticket_issue_addressstringDirección donde se emitió el boleto.123 Main St
airline_ticket_issue_carrier_prefix_codestringCódigo de prefijo de la aerolínea emisora.1
airline_ticket_issue_citystringCiudad donde se emitió el boleto.New York
airline_ticket_issue_countrystringPaís donde se emitió el boleto.US
airline_ticket_issue_datedateFecha en que se emitió el boleto.2024-09-10
airline_ticket_issue_travel_agent_codestringCódigo del agente de viajes que emitió el boleto.TA123
airline_ticket_issue_travel_agent_namestringNombre del agente de viajes que emitió el boleto.John Doe Travel
airline_ticket_issue_zip_codestringCódigo postal donde se emitió el boleto.10001
airline_ticket_restrictedbooleanIndica si el boleto tiene restricciones (true/false).FALSE
airline_ticket_ticket_numberstringNúmero único asignado al boleto.1234567890123
airline_ticket_total_fare_amountnumberMonto total pagado por el boleto.300
airline_ticket_total_fee_amountnumberTotal de cargos adicionales aplicados al boleto.50
airline_ticket_total_tax_amountnumberTotal de impuestos aplicados al boleto.25
authorization_codestringCódigo de autorización devuelto por el adquirente / emisor cuando la transacción es aprobada. Puede ser numérico o alfanumérico. Ya documentado en Transacciones.T60375
amount_valuenumberEl monto del pago (múltiplo de 0.0001).111111
bank_namestringNombre del banco asociado a la transacción.Wells Fargo
beneficiary_namestringNombre del beneficiario de la transacción o del pago.Jane Doe
billing_cycles_currentintegerNúmero del ciclo de facturación actual (indexado desde 1) para pagos asociados a una suscripción.3
billing_cycles_next_atdatetimeMarca de tiempo de la próxima facturación programada para pagos asociados a una suscripción.2027-04-10T10:14:39.515Z
billing_cycles_totalintegerNúmero total de ciclos de facturación configurados. 2000000 es un valor centinela para una suscripción indefinida (ilimitada).12
bnpl_installmentsstringLas cuotas del préstamo (MAX 50; MIN 1).12
browser_info_accept_headerstringEl encabezado ‘accept’ enviado por el navegador.text/html
browser_info_color_depthnumberProfundidad de color admitida por la pantalla del navegador (en bits).24
browser_info_javascript_enabledbooleanIndica si JavaScript está habilitado en el navegador.TRUE
browser_info_languagestringIdioma predeterminado configurado en el navegador.en-US
browser_info_screen_heightnumberAltura de la pantalla del navegador en píxeles.1080
browser_info_screen_widthnumberAncho de la pantalla del navegador en píxeles.1920
browser_info_user_agentstringCadena de user agent que representa el navegador y el sistema operativo.Mozilla/5.0
capturednumberIndica el monto total capturado del pago.1000.00
card_brandstringMarca de la tarjeta utilizada en la transacción (p. ej., Visa, MasterCard).Visa
card_categorystringCategoría de la tarjeta (p. ej., crédito, débito).Credit
card_holder_namestringNombre del titular de la tarjeta.John Doe
card_iinstringNúmero de identificación del emisor (IIN) de la tarjeta (primeros 6 dígitos).123456
card_issuer_codestringCódigo que identifica al emisor de la tarjeta.CITI123
card_issuer_namestringNombre del banco o institución que emite la tarjeta.Citi Bank
card_lfdnumberÚltimos cuatro dígitos del número de la tarjeta.7890
card_typeenumTipo de tarjeta (p. ej., crédito, débito).Credit
checkout_sessionstringIdentificador único de la sesión de checkout.ch_sess_12345
countryenumEl país donde se debe procesar la transacción (MAX 2; MIN 2; ISO 3166-1).US
connection_namestringEtiqueta asignada por el comercio a la conexión del proveedor (account_integration) a través de la cual se enrutó la transacción.Rappi MX (#30441) 866b71f2db 1_9V4FF82f
created_attimestampLa fecha de creación del pago (MAX 27; MIN 27; ISO 8601).2022-05-09T20:46:54.786342Z
currencyenumLa moneda utilizada para realizar el pago (MAX 3; MIN 3; ISO 4217).COP
customer_first_namestringEl nombre del cliente (MAX 255; MIN 1).John
customer_idstringEl identificador único del cliente (MAX 255; MIN 3).23456
customer_last_namestringEl apellido del cliente (MAX 255; MIN 1).Doe
customer_payer_phone_country_codenumberEl código de país del cliente (MAX 3; MIN 2).52
customer_payer_phone_numbernumberEl número de teléfono del cliente (MAX 255; MIN 1).3313873320
date_of_birthdateFecha de nacimiento de la persona.1985-07-28
descriptionstringLa descripción del pago (MAX 255; MIN 3).Order1234
device_fingerprintstringIdentificador único del dispositivo utilizado en la transacción.df_987654321
document_numberstringNúmero de documento de la persona.A98765432
document_typeenumTipo de documento (p. ej., documento de identidad, pasaporte).ID
emailstringEl email del cliente (MAX 255; MIN 3).john.doe@email.com
genderenumGénero de la persona.Male
installmentsnumberNúmero de cuotas del pago.6
ip_addressstringLa dirección IP del cliente (MAX 255; MIN 3).2806:103e:2a:414
merchant_customer_idenumUn identificador único asignado por un comercio para representar a un cliente específico (MAX 255; MIN 3).9440127422
merchant_order_idstringLa identificación de la orden (MAX 255; MIN 3).123456789
metadata_valuestring (json)Metadatos personalizados adjuntos al pago por el comercio en el momento de la creación, serializados como un arreglo JSON de objetos {key, value}.
nationalitystringNacionalidad de la persona.US
network_tokenstringNúmero del token sin separadores (MAX 19; MIN 8), disponible solo para comercios con certificación PCI.1234567890123456
network_transaction_idstringIdentificador único asignado a una transacción por la red de tarjetas. Se utiliza para rastrear y referenciar transacciones específicas, en particular en escenarios de pagos recurrentes, y garantiza consistencia y trazabilidad a lo largo del ciclo de vida del pago. (MAX 255; MIN 3)NTX123456789
network_token_iinstringIIN/BIN del network token (DPAN) utilizado en la transacción. Primeros 8 dígitos del PAN tokenizado; difiere de card_iin. Se completa en transacciones con network token (Apple Pay / Google Pay).51884710
network_token_last4stringÚltimos 4 dígitos del PAN del network token (DPAN). Difiere de card_lfd. Se completa en transacciones con network token.8394
network_token_typestringTipo de fondeo o marca de la tarjeta del network token (CREDIT, DEBIT, VISA, MASTERCARD, AMEX, etc.). Se completa principalmente en Apple Pay (~99.9%); puede estar vacío en Google Pay. Nota: este campo NO contiene el identificador de la billetera (APPLE_PAY/GOOGLE_PAY), usa payment_method_type para eso.CREDIT
order_fee_amountnumberTotal de comisiones aplicadas a la orden.10
order_item_brandstringMarca del artículo de la orden.Nike
order_item_categorystringCategoría del artículo de la orden.Shoes
order_item_idstringIdentificador único del artículo de la orden.item_12345
order_item_manufacture_part_numberstringNúmero de parte del fabricante del artículo.MP56789
order_item_namestringNombre del artículo de la orden.Air Max 2024
order_item_quantitynumberCantidad del artículo de la orden.2
order_item_sku_codestringCódigo SKU del artículo de la orden.SKU98765
order_item_unit_amountnumberPrecio unitario del artículo.150
order_shipping_amountnumberCosto de envío de la orden.20
payment_callback_urlstringUn endpoint URL proporcionado por el comercio.https://www.domain.com
payment_idstringUn identificador único asignado a una transacción de pago específica.69ad0a39-b769-423c-b223-d7b8bf
payment_method_typestringMétodo de pago específico utilizado (CARD, APPLE_PAY, PIX, NEQUI, YAPE, MERCADO_PAGO_WALLET, BANK_TRANSFER, GCASH, BOLETO, OXXO, etc.).APPLE_PAY
payment_seller_details_address_citystringCiudad de la dirección del vendedor.Miami
payment_seller_details_address_countrystringPaís de la dirección del vendedor.US
payment_seller_details_address_line_1stringPrimera línea de la dirección del vendedor.456 Market St
payment_seller_details_address_line_2stringSegunda línea de la dirección del vendedor.Apt 202
payment_seller_details_address_statestringEstado o provincia de la dirección del vendedor.FL
payment_seller_details_address_zip_codestringCódigo postal de la dirección del vendedor.33101
payment_seller_details_countrystringPaís donde tiene su sede el vendedor.US
payment_seller_details_document_numberstringNúmero de documento del vendedor.98765432
payment_seller_details_document_typeenumTipo de documento del vendedor (p. ej., ID, pasaporte).ID
payment_seller_details_emailstringDirección de email del vendedor.seller@domain.com
payment_seller_details_industrystringLa industria a la que pertenece el vendedor.Retail
payment_seller_details_namestringNombre del vendedor.Best Store
payment_seller_details_phone_codestringCódigo de país del número de teléfono del vendedor.1
payment_seller_details_phone_numberstringNúmero de teléfono del vendedor.123-456-7890
payment_seller_details_referencestringReferencia interna del vendedor.ref_789456
payment_seller_details_web_sitestringURL del sitio web del vendedor.www.domain.com
payment_tax_basenumberMonto base utilizado para calcular el impuesto.100
payment_tax_percentagenumberPorcentaje de impuesto aplicado a la transacción.10
payment_tax_typestringTipo de impuesto aplicado (p. ej., VAT, GST).VAT
payment_tax_valuenumberEl monto del impuesto calculado.10
payment_workflowstringWorkflow utilizado para el proceso de pago.standard
pnrstringReferencia del Passenger Name Record (PNR).1P-2UUGJW
provider_numberintegerEl número del ticket.13141
refundednumberEl monto del pago que fue reembolsado.10000
sdk_action_requiredbooleanUn campo booleano que indica si se necesita una acción adicional del cliente o del comercio.TRUE
statusenumEl estado del pago (MAX 255; MIN 3).SUCCEEDED
sub_statusenumEl subestado del pago (MAX 255; MIN 3).APPROVED
subscription_idstringUn identificador único asignado a una suscripción recurrente o a un acuerdo de facturación.111aaa222
transaction_idstring (uuid)Identificador interno de la transacción de Yuno asociado al pago.67d2c9dc-69c6-45b0-b07e-34e869f4d471
updated_attimestampLa fecha y hora de la última actualización del pago.2022-05-15T20:46:54.786342Z

Reporte de transacciones

ParámetroTipoDescripciónEjemplo
account_idstringIdentificador único de la cuenta (MAX 64; MIN 36).2c05976d-f696-497f-a309-6421883de48d
account_integration_idstringIdentificador único de la integración de la cuenta (MAX 64; MIN 36).6a0f939c-0cd1-4350-acbc-b0cbdbee9739
amountnumberMonto de la transacción (MAX 10000; MIN 0).887
authorization_codestringCódigo de autorización de la transacción (MAX 6; MIN 6).161058
bank_namestringNombre del banco que participa en la transacción (MAX 100; MIN 3).Bank ABC
bank_transfer_accountstringDetalles de la cuenta de transferencia bancaria (MAX 255; MIN 3).12345678901234567
bank_transfer_account_2stringDetalles de la cuenta secundaria de transferencia bancaria (MAX 255; MIN 3).76543210987654321
bank_transfer_account_typeenumTipo de la cuenta de transferencia bancaria (MAX 20; MIN 3).Checking
bank_transfer_payment_instructionstringInstrucciones para pagos por transferencia bancaria (MAX 255; MIN 3).Payment to be completed within 48 hours.
beneficiary_documentstringIdentificador del documento del beneficiario (MAX 20; MIN 5).123456789
beneficiary_document_typeenumTipo de documento del beneficiario (MAX 10; MIN 3).Passport
beneficiary_namestringNombre completo del beneficiario (MAX 255; MIN 3).John Doe
billing_cycles_currentintegerNúmero del ciclo de facturación actual (con índice desde 1) para pagos respaldados por suscripciones.3
billing_cycles_next_atdatetimeMarca de tiempo de la próxima facturación programada para pagos respaldados por suscripciones.2027-04-10T10:14:39.515Z
billing_cycles_totalintegerNúmero total de ciclos de facturación configurados. 2000000 es un valor centinela para una suscripción indefinida (ilimitada).12
capturebooleanIndica si la transacción está capturada.TRUE
card_brandstringMarca de la tarjeta utilizada (MAX 50; MIN 2).VISA
card_categorystringCategoría de la tarjeta utilizada (MAX 50; MIN 2).CLASSIC
card_holder_namestringNombre del titular de la tarjeta (MAX 255; MIN 2).Jane Doe
card_iinstringNúmero de identificación del emisor (IIN) de la tarjeta (MAX 8; MIN 6).49296404
card_issuer_codestringCódigo del emisor de la tarjeta (MAX 50; MIN 2).BCO001
card_issuer_countrystringCódigo de país ISO Alpha-2 del banco emisor, derivado del IIN de la tarjeta.MX
card_issuer_namestringNombre del emisor de la tarjeta (MAX 100; MIN 3).Bank ABC
card_lfdstringÚltimos cuatro dígitos del número de la tarjeta (MAX 4; MIN 4).1228
card_number_lengthnumberLongitud del número de la tarjeta (MAX 19; MIN 12).16
card_security_code_lengthnumberLongitud del código de seguridad de la tarjeta (MAX 4; MIN 3).3
card_typeenumTipo de tarjeta utilizada (CREDIT o DEBIT).CREDIT
card_expiration_monthnumberMes de vencimiento de la tarjeta (MAX 2; MIN 1).10
card_expiration_yearnumberAño de vencimiento de la tarjeta (MAX 2; MIN 2).10
countryenumPaís donde ocurrió la transacción (MAX 2; MIN 2).UY
connection_namestringEtiqueta asignada por el comercio a la conexión del proveedor (account_integration) a través de la cual se enrutó la transacción.Rappi MX (#30441) 866b71f2db 1_9V4FF82f
created_attimestampMarca de tiempo de creación de la transacción (ISO 8601).2024-09-11T23:16:06.602Z
currencyenumCódigo de moneda de la transacción (MAX 3; MIN 3).UYU
customer_first_namestringNombre del cliente (MAX 255; MIN 3).Jane
customer_idstringIdentificador único del cliente (MAX 64; MIN 36).f4c53557-a832-44e9 -94e4-0344f91e9d4f
customer_last_namestringApellido del cliente (MAX 255; MIN 3).Doe
descriptionstringDescripción de la transacción (MAX 255; MIN 3).Merchant Ecommerce
document_numberstringNúmero de documento del cliente (MAX 20; MIN 5).48054205
document_typestringTipo de documento del cliente (MAX 10; MIN 2).CI
emailstringDirección de email del cliente (MAX 255; MIN 3).example@email.com
first_installments_deferralstringDetalles del diferimiento de la primera cuota (MAX 255; MIN 3).No deferral
fingerprint_codestring (uuid)Fingerprint único de la tarjeta, que Yuno usa para identificar la misma tarjeta entre transacciones sin exponer datos del PAN.5aa1d176-7460-4ca4-8579-17d92b32fec1
fraud_screening_provider_scorenumberPuntuación de análisis de fraude proporcionada por el sistema de detección de fraude (MAX 100; MIN 0).85
installmentsnumberNúmero de cuotas de la transacción (MAX 24; MIN 1).1
installments_amountnumberMonto total de las cuotas (MAX 10000; MIN 0).887
installments_typestringTipo de plan de cuotas (MAX 50; MIN 3).Single payment
iso_codestringCódigo de respuesta ISO 8583 devuelto por el adquirente o la red. 00/000 indican aprobación.00
iso_messagestringMensaje asociado a la respuesta ISO 8583.Aprobado
merchant_order_idstringIdentificador de la orden del comercio (MAX 64; MIN 36).NC2- 66e224a53fb722eaa0507579
merchant_transaction_idstringIdentificador de la transacción del comercio (MAX 64; MIN 36).NC2- 66e224a53fb722eaa0507579
merchant_advice_codestringMerchant Advice Code normalizado para transacciones rechazadas; úsalo para guiar el comportamiento de reintento y el enrutamiento.01
merchant_advice_code_messagestringMensaje legible que explica la recomendación devuelta en merchant_advice_code.Reintentar después de 24 horas
merchant_customer_idstringEl identificador único del cliente en el comercio externo (MAX 255; MIN 3).9440127422
nationalitystringNacionalidad del cliente (MAX 3; MIN 2).UY
network_tokenstringNúmero del token sin separadores (MAX 19; MIN 8), disponible solo para comercios certificados PCI.1234567890123456
network_transaction_idstringIdentificador único asignado a una transacción por la red de tarjetas. Se usa para rastrear y referenciar transacciones específicas, en particular en escenarios de pagos recurrentes, y garantiza consistencia y trazabilidad a lo largo del ciclo de vida del pago. (MAX 255; MIN 3)NTX123456789
network_token_iinstringIIN/BIN del token de red (DPAN) usado en la transacción. Primeros 8 dígitos del PAN tokenizado; difiere de card_iin. Se completa en transacciones con token de red (Apple Pay / Google Pay).51884710
network_token_last4stringÚltimos 4 dígitos del PAN del token de red (DPAN). Difiere de card_lfd. Se completa en transacciones con token de red.8394
network_token_typestringTipo de fondos o marca de la tarjeta del token de red (CREDIT, DEBIT, VISA, MASTERCARD, AMEX, etc.). Se completa principalmente en Apple Pay (~99.9%); puede estar vacío en Google Pay. Nota: este campo NO contiene el identificador de la billetera (APPLE_PAY/GOOGLE_PAY), usa payment_method_type para eso.CREDIT
payment_idstringIdentificador único del pago (MAX 64; MIN 36).49b08cf9-c577-4451- a673-2dc1ae930200
payment_link_fee_detailsstringDetalles de las comisiones asociadas al enlace de pago (MAX 255; MIN 3).No additional fees
payment_link_money_release_datetimestampFecha en que se liberará el dinero del enlace de pago (ISO 8601).2024-09-15
payment_link_payment_method_detailstringDetalles del método de pago usado en el enlace de pago (MAX 255; MIN 3).VISA Card ending in 1228
payment_link_payment_method_idstringIdentificador único del método de pago en el enlace de pago (MAX 64; MIN 36).PLPMID123456
payment_link_sponsor_idstringIdentificador único del patrocinador del enlace de pago (MAX 64; MIN 36).PLS123456
payment_method_categoryenumCategoría del método de pago (CARD, BANK_TRANSFER, etc.).CARD
payment_method_typeenumTipo de método de pago (CARD, BANK_TRANSFER, etc.).CARD
pnrstringPassenger Name Record, si aplica (MAX 64; MIN 36).987654321
provider_account_idstringIdentificador de la cuenta del proveedor (MAX 64; MIN 36).699ec8d444
provider_expiration_datetimestampFecha de vencimiento proporcionada por el proveedor (ISO 8601).2024-12-31
provider_idstringIdentificador único del proveedor (MAX 64; MIN 36).PROVIDER ID
provider_merchant_advice_codestringMerchant Advice Code sin procesar devuelto por el proveedor para transacciones rechazadas.R1
provider_merchant_advice_code_messagestringMensaje del proveedor que explica el significado del Merchant Advice Code sin procesar.Issuer unavailable
provider_raw_notificationstring (json)Payload de la notificación de webhook sin procesar recibida del proveedor. Envuelto como .
provider_raw_responsestring (json)Cuerpo de la respuesta sin procesar devuelto por la API del proveedor. Envuelto como .
provider_imagestringURL de la imagen o el logotipo del proveedor (MAX 255; MIN 3).https://example.com/logo.png
provider_numberstringNúmero del proveedor (MAX 64; MIN 36).12345
provider_response_codestringCódigo de respuesta del proveedor (MAX 255; MIN 3).200
provider_response_messagestringMensaje de respuesta del proveedor (MAX 255; MIN 3).The payment was paid.
provider_statusstringEstado del pago en el proveedor (MAX 255; MIN 3).PAID
provider_status_detailstringEstado detallado del proveedor (MAX 255; MIN 3).La transacción se completó correctamente.
provider_third_party_account_idstringID de cuenta de terceros asociado al proveedor (MAX 64; MIN 36).ACC123456
provider_third_party_transaction_idstringID de transacción de terceros asociado al proveedor (MAX 64; MIN 36).TID123456
provider_transaction_idstringIdentificador único de la transacción del proveedor (MAX 64; MIN 36).T-51056-1e10f992-e5cf- 40bf-9eb6-8edc881de30b
reasonstringMotivo de la transacción (MAX 255; MIN 3).Merchant’s order payment
redirect_urlstringURL a la que se redirigirá al usuario después del pago (MAX 255; MIN 3).https://example.com/redirect-url
refund_execution_originstringOrigen de la ejecución del reembolso (MAX 255; MIN 3).Customer Request
refund_execution_userstringUsuario que ejecutó el reembolso (MAX 255; MIN 3).RefundServiceAgent
response_codestringCódigo de respuesta del sistema (MAX 255; MIN 3).200
response_messagestringMensaje de respuesta del sistema (MAX 255; MIN 3).Payment successful.
retrieval_reference_numberstringNúmero de referencia para recuperar los detalles de la transacción (MAX 255; MIN 3).1234567890
soft_descriptorstringEl soft descriptor que se muestra en el estado de cuenta bancario del cliente (MAX 22; MIN 3).MERCHANT ECOMMERCE
stored_credentials_reasonstringMotivo de negocio por el que se usaron las credenciales almacenadas. Valores: CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILE.CARD_ON_FILE
stored_credentials_usagestringClasificación de uso. FIRST = captura inicial, USED = uso posterior.USED
statusenumEstado de la transacción (MAX 50; MIN 2).PAID
subscription_idstringIdentificador único de una suscripción asociada a la transacción (MAX 64; MIN 36).SUB123456
three_d_secure_cryptogramstringDatos del criptograma usados en la autenticación 3D Secure (MAX 255; MIN 3).ABCDEFG12345
three_d_secure_directory_server_transaction_idstringID de transacción del servidor de directorio para la autenticación 3D Secure (MAX 255; MIN 3).3DSTID123456
three_d_secure_electronic_commerce_indicatorstringIndicador de comercio electrónico para la autenticación 3D Secure (MAX 255; MIN 3).ECI05
three_d_secure_setup_idstringID de configuración para la autenticación 3D Secure (MAX 255; MIN 3).SETUP123456
three_d_secure_transaction_idstringID de transacción para la autenticación 3D Secure (MAX 255; MIN 3).3DSTXID123456
three_d_secure_versionstringVersión del protocolo 3D Secure utilizada (MAX 255; MIN 3).2.1.0
has_challengebooleanIndica si la transacción tiene un paso de desafío (3D Secure).FALSE
ticket_provider_barcodestringCódigo de barras proporcionado por el proveedor del ticket (MAX 255; MIN 3).123456789
ticket_provider_formatstringFormato del ticket proporcionado por el proveedor (MAX 255; MIN 3).PDF
ticket_provider_logostringLogotipo del proveedor del ticket (MAX 255; MIN 3).https://example.com/logo.png
tokenstringToken generado para la transacción (MAX 255; MIN 3).fa476a40-854c-4e66 -9a98-55a68a6b88f4
transaction_idstringIdentificador único de la transacción (MAX 64; MIN 36).b04db1c6-b2c7-4765-a77e-953d284d080b
typestringTipo de transacción (MAX 50; MIN 2).PURCHASE
updated_attimestampMarca de tiempo de la última actualización de la transacción (ISO 8601).2024-09-11T23:17:07.602Z
vault_on_successbooleanIndica si se debe almacenar en el vault cuando la transacción es exitosa.FALSE
vaulted_tokenstringToken generado para una tarjeta almacenada en el vault (MAX 255; MIN 3).fa476a40-854c-4e66- 9a98-55a68a6b88f4
verifybooleanIndica si se realizó la verificación.FALSE
walletstringBilletera asociada a la transacción (MAX 255; MIN 3).Wallet ABC
wallet_transaction_card_binstringEl número de identificación del emisor (IIN) corresponde a los primeros dígitos del número de la tarjeta de pago emitida por una institución financiera (MAX 8; MIN 6).492964
wallet_transaction_card_last_4_digitsstringLos últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).1228

Resumen de conciliación

ParameterTypeDescriptionExample
transaction_idstringEl identificador único de la transacción asignado por Yuno (MAX 64; MIN 36).9104911d-5df9-429e-8488-ad41abea1a4b
payment_idstringEl identificador único del pago (MAX 64; MIN 36).5104911d-5df9-229e-8468-bd41abea1a4b
reconciliation_idstringEl identificador único asignado a una transacción cuando se concilia (MAX 255; MIN 3).2478d494-4a20-45b1-8a12-1c2604cf2d1d
account_idstringEl identificador único de la cuenta (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120002
customer_idstringEl identificador único del cliente (MAX 255; MIN 3).cus_23456
merchant_order_idstringIdentificación de la orden asignada por tu empresa (MAX 255; MIN 3).ORDER-abc123456789
merchant_transaction_idstringIdentificación de la transacción asignada por tu empresa (MAX 255; MIN 3).TXN-987654321
created_attimestampFecha de creación de la transacción (MAX 27; MIN 27; ISO 8601).2026-02-03T22:21:03.000Z
updated_attimestampLa fecha y hora de la última actualización de la transacción (ISO 8601).2026-02-03T22:40:17.000Z
reconciliation_datedateLa fecha en que se concilió la transacción (MAX 27; MIN 27; ISO 8601).2026-02-09
reconciliation_settlement_datedateFecha indicada por el adquirente en la que los fondos se depositarán en la cuenta bancaria del comercio.2026-02-09
estimated_settlement_datedateFecha en la que se espera depositar los fondos al comercio.2026-02-09
provider_idenumEl ID del proveedor que procesó la transacción.PROVIDER_ABC
provider_statusstringEl estado de la transacción según el proveedor (MAX 255; MIN 3).charged_back
provider_transaction_idstringEl identificador único de la transacción en el proveedor (MAX 255; MIN 3).141267964175
retrieval_reference_numberstringNúmero de referencia único para la recuperación de la transacción (MAX 255; MIN 3).CAQMCAQRisS2iL
response_codestringEl código que representa la respuesta al resultado de la transacción.SUCCEEDED
authorization_codestringEl código de respuesta del adquirente.09137Z
amountdecimalEl monto de la transacción en la moneda original.100.00
currencyenumLa moneda utilizada para realizar el pago (MAX 3; MIN 3; ISO 4217).USD
countryenumEl país donde debe procesarse la transacción (MAX 2; MIN 2; ISO 3166-1).US
local_amountdecimalMonto de la transacción expresado en la moneda local del comercio (múltiplo de 0.0001).1000.00
net_amountdecimalMonto neto después de comisiones e impuestos en la moneda original (múltiplo de 0.0001).970.00
settlement_gross_amountdecimalMonto bruto de la transacción en la moneda de liquidación (múltiplo de 0.0001).100.00
settlement_feesdecimalComisión total retenida por el adquirente en la moneda de liquidación (múltiplo de 0.0001).15.00
settlement_net_creditdecimalMonto de crédito menos comisiones en la moneda de liquidación (múltiplo de 0.0001).970.00
local_retentiondecimalRetención de impuestos locales aplicada a la transacción (múltiplo de 0.0001).0.25
local_taxdecimalImpuestos locales aplicados a la transacción (múltiplo de 0.0001).0.50
provider_fee_taxesdecimalImpuestos sobre las comisiones del proveedor en la moneda original (múltiplo de 0.0001).0.10
provider_feesdecimalComisiones retenidas por el proveedor en la moneda original (múltiplo de 0.0001).10.00
statusenumEl estado de la transacción (MAX 255; MIN 3).SUCCEEDED
typeenumEl tipo de transacción. Valores posibles: PURCHASE, REFUND, CHARGEBACK (MAX 255; MIN 3).PURCHASE
reconciliation_statusenumEl estado de conciliación de una transacción. Valores posibles: RECONCILED, NOT_RECONCILED, CONFLICT, NON_RECONCILABLE (MAX 255; MIN 3).RECONCILED
reconciliation_sub_statusenumEl subestado de conciliación de una transacción. Valores posibles: AUTOMATICALLY, MANUAL, PENDING (MAX 255; MIN 3).AUTOMATICALLY
payment_method_categoryenumCategoría de la transacción (p. ej., CARD, WALLET, BANK_TRANSFER) (MAX 255; MIN 3).CARD
payment_method_typeenumEl tipo de método de pago seleccionado por el cliente (MAX 255; MIN 3).MD
card_brandenumLa información de la marca de la tarjeta estandarizada por Yuno (MAX 255; MIN 3).MASTERCARD
provider_card_brandstringEl método de pago o la marca de la tarjeta según lo informado por el proveedor (MAX 255; MIN 3).MASTERCARD
card_categoryenumCategoría de la tarjeta utilizada en la transacción (MAX 255; MIN 3).CLASSIC
card_typeenumEl tipo de emisor de la tarjeta. Valores posibles: CREDIT, DEBIT (MAX 255; MIN 3).CREDIT
card_iinstringEl número de identificación del emisor (IIN) de la tarjeta de pago. Se almacena como string para conservar los ceros iniciales (MAX 8; MIN 6).411111
card_lfdstringÚltimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).7890
card_issuer_countryenumPaís del emisor de la tarjeta (MAX 2; MIN 2; ISO 3166-1).US
card_issuer_namestringBanco al que corresponde la tarjeta.BANK ABC
card_expiration_monthnumberMes de vencimiento de la tarjeta (MAX 2; MIN 1).11
card_expiration_yearnumberAño de vencimiento de la tarjeta (MAX 2; MIN 2).27
installmentsnumberEn caso de una transacción con tarjeta, el número de cuotas en las que se solicitó el pago (MAX 2; MIN 1).1
descriptionstringDescripción de texto libre de la transacción proporcionada por el comercio.Ecommerce purchase
pnrstringEl registro del nombre del pasajero (MAX 255; MIN 3).1P-2UUGJW

Liquidaciones y comisiones

ParámetroTypeDescriptionEjemplo
transaction_idstringEl identificador único de la transacción asignado por Yuno (MAX 64; MIN 36).9104911d-5df9-429e-8488-ad41abea1a4b
payment_idstringEl identificador único del pago (MAX 64; MIN 36). Un pago puede agrupar varias transacciones (p. ej., PURCHASE más REFUND).5104911d-5df9-229e-8468-bd41abea1a4b
reconciliation_idstringEl identificador único asignado a una transacción cuando se concilia (MAX 255; MIN 3).2478d494-4a20-45b1-8a12-1c2604cf2d1d
settlement_batch_idstringNúmero único de lote de liquidación del adquirente que puedes encontrar en tu estado de cuenta bancario para el depósito correspondiente (MAX 255; MIN 3).SETT-111450235000
account_idstringEl ID de la cuenta del comercio (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120002
organization_codestringIdentificador único de la organización asociada con la transacción (MAX 64; MIN 3).ORG_ABC_001
customer_idstringEl identificador único del cliente (MAX 255; MIN 3).cus_23456
merchant_order_idstringIdentificación de la orden asignada por el comercio (MAX 255; MIN 3).ORDER-abc123456789
merchant_transaction_idstringIdentificación de la transacción asignada por el comercio (MAX 255; MIN 3).TXN-987654321
provider_merchant_idstringID del comercio en el sistema del PSP (MAX 255; MIN 3).15a8c304-d334-4da7-bccb-09cf85a1d7a6
transaction_datetimestampFecha de creación de la transacción (MAX 27; MIN 27; ISO 8601).2026-01-29T20:56:25.000Z
settlement_datedateFecha en la que los fondos se liquidaron en la cuenta del comercio.2026-02-03
reconciliation_datedateLa fecha en que se concilió la transacción.2026-01-21
estimated_settlement_datedateFecha en la que se espera depositar los fondos al comercio.2026-02-05
acquirerenumNombre del adquirente que procesó el pago original. En los modelos de agregador, el proveedor es el mismo que el adquirente. En otros modelos pueden ser entidades distintas (MAX 255; MIN 3).Acquirer ABC
provider_idenumIdentificador del proveedor / gateway que procesó la transacción.PROVIDER_ABC
provider_transaction_idstringEl identificador único de la transacción asignado por el gateway. Este campo está vacío si el gateway no proporciona información de la transacción (MAX 255; MIN 3).53443e9c-dd17-11ec-9d64-0242ac120002
authorization_codestringEn caso de una transacción con tarjeta, el código que asigna el banco emisor a la transacción cuando se autoriza. Vacío si el gateway no lo proporciona (MAX 255; MIN 3).123456
typeenumEl tipo de transacción. Valores posibles: PURCHASE, REFUND, CHARGEBACK (MAX 255; MIN 3).PURCHASE
currencyenumCódigo de la moneda en la que se realizó la transacción original (MAX 3; MIN 3; ISO 4217).USD
settlement_currencyenumCódigo de la moneda en la que se realizó la liquidación (MAX 3; MIN 3; ISO 4217).USD
gross_creditdecimalPara transacciones de crédito, el monto bruto correspondiente en la moneda original (múltiplo de 0.0001).1000.00
gross_debitdecimalPara transacciones de débito (reembolsos, contracargos), el monto bruto correspondiente en la moneda original (múltiplo de 0.0001).200.00
settlement_gross_amountdecimalEl monto bruto correspondiente a todas las transacciones en la moneda de liquidación (múltiplo de 0.0001).100.00
settlement_net_creditdecimalEl monto enviado en las solicitudes de transacciones de crédito menos las comisiones del adquirente en la moneda de liquidación (múltiplo de 0.0001).970.00
settlement_net_debitdecimalEl monto enviado en las solicitudes de transacciones de débito menos las comisiones del adquirente en la moneda de liquidación (múltiplo de 0.0001).190.00
fx_ratedecimalEl tipo de cambio aplicado a la transacción en el momento de la liquidación (múltiplo de 0.0001).10.0000
local_amountdecimalMonto de la transacción expresado en la moneda local del comercio (múltiplo de 0.0001).1000.00
net_amountdecimalMonto neto en la moneda original después de comisiones e impuestos (múltiplo de 0.0001).970.00
settlement_feesdecimalLa comisión retenida por el adquirente en las transacciones en la moneda de liquidación. Debe ser la diferencia entre los montos bruto y neto (múltiplo de 0.0001).15.00
provider_feesdecimalComisiones retenidas por el proveedor en la moneda original (múltiplo de 0.0001).10.00
settlement_taxesdecimalEl valor de los impuestos aplicados a las transacciones en la moneda de liquidación. Debe ser la diferencia entre los montos bruto y neto (múltiplo de 0.0001).1.00
local_taxdecimalImpuestos locales aplicados a la transacción en moneda local (múltiplo de 0.0001).0.50
local_retentiondecimalRetención de impuestos locales aplicada a la transacción en moneda local (múltiplo de 0.0001).0.25
provider_fee_taxesdecimalImpuestos sobre las comisiones del proveedor en la moneda original (múltiplo de 0.0001).0.10
reconciliation_statusenumEl estado de conciliación de una transacción. Valores posibles: RECONCILED, NOT_RECONCILED, CONFLICT, NON_RECONCILABLE (MAX 255; MIN 3).RECONCILED
reconciliation_sub_statusenumEl subestado de conciliación de una transacción. Valores posibles: AUTOMATICALLY, MANUAL, PENDING (MAX 255; MIN 3).AUTOMATICALLY
payment_method_categoryenumCategoría de la transacción (p. ej., CARD, WALLET, BANK_TRANSFER) (MAX 255; MIN 3).CARD
payment_method_typeenumEl tipo de método de pago seleccionado por el cliente (p. ej., VI, MD, PIX, BOLETO) (MAX 255; MIN 3).VI
card_brandenumMarca de la tarjeta utilizada en la transacción (p. ej., VISA, MASTERCARD, AMEX) (MAX 255; MIN 3).VISA
card_typeenumTipo de tarjeta utilizada en la transacción. Valores posibles: CREDIT, DEBIT (MAX 7; MIN 5).CREDIT
card_iinstringEl número de identificación del emisor (IIN), es decir, los primeros dígitos de la tarjeta de pago. Se almacena como string para conservar los ceros iniciales (MAX 8; MIN 6).411111
card_lfdstringÚltimos cuatro dígitos de la tarjeta de pago (MAX 4; MIN 4).7890
installmentsnumberEn caso de una transacción con tarjeta, el número de cuotas en las que se solicitó el pago (MAX 2; MIN 1).1
countryenumPaís de la cuenta del comercio (MAX 2; MIN 2; ISO 3166-1).US
payout_batch_idstringIdentificador del reporte o lote del proveedor del que se ingirió la línea de liquidación. Coincide con payout_batch_id en el reporte Settlement Payouts. Columna opcional, se solicita con columns, disponible para comercios en el nuevo motor de conciliación de Yuno.0526f07e-cd82-5737-82c1-55a10692425d

Payouts de liquidación

El reporte Settlement Payouts lista los payouts (transferencias bancarias) que cada proveedor de pago informa haber depositado en tus cuentas de comercio. Cada fila es una línea de payout tal como la informa el proveedor: quién pagó, a qué cuenta, cuándo, y los montos bruto, de comisiones y neto de la transferencia. Úsalo para comparar los depósitos que ves en tu estado de cuenta bancario con lo que declaró el proveedor. Este reporte es distinto del reporte de payouts, que cubre los payouts que envías a beneficiarios a través de Yuno.
DisponibilidadEl reporte Settlement Payouts está disponible para comercios que usan el nuevo motor de conciliación de Yuno. Solicitarlo para una organización que aún no usa el nuevo motor devuelve un error 400.
Las filas de payout no se concilian transacción por transacción, por lo que no tienen estado de conciliación. Para ver qué líneas de liquidación pertenecen a un payout, cruza la columna payout_batch_id con la misma columna del reporte Settlements & Fees. De forma predeterminada, el reporte devuelve las primeras 17 columnas siguientes, en ese orden. Las demás columnas son opcionales y se solicitan con el parámetro columns. Ten en cuenta que columns reemplaza la selección predeterminada en lugar de ampliarla: para agregar settlement_date también debes listar cada columna predeterminada que quieras conservar.
ParámetroTipoDescripciónEjemplo
payout_idstringIdentificador del payout (transferencia) asignado por el proveedor. Agrupa las líneas de liquidación pagadas en la misma transferencia. No es un identificador de lote y su formato depende del proveedor.TX61083816600XT
payout_batch_idstringIdentificador del reporte o lote del proveedor del que se ingirió la línea de payout. Las líneas de liquidación ingeridas del mismo reporte tienen el mismo valor en el reporte Settlements & Fees, lo que permite vincular ambos reportes.0526f07e-cd82-5737-82c1-55a10692425d
payout_datedateFecha en la que el proveedor pagó los fondos (ISO 8601, YYYY-MM-DD).2026-09-03
payout_typeenumCómo se obtuvo el payout. Valores posibles: STATED (informado por el proveedor en sus archivos de liquidación), DERIVED (inferido por Yuno al sumar los componentes de la liquidación; aún no disponible).STATED
provider_idenumIdentificador del proveedor que pagó los fondos.ADYEN
acquirerenumNombre del adquirente que pagó los fondos. Mismo valor que provider_id, se conserva por coherencia con el reporte Settlements & Fees.ADYEN
account_idstringCuenta que recibió los fondos, según la nombra el proveedor: una cuenta de comercio, una cuenta bancaria o un identificador de destinatario. No es el identificador de cuenta de Yuno.Yuno_main
typeenumTipo de línea de payout según la informa el proveedor. Los valores posibles incluyen PAYOUT, WITHDRAWAL, TED, MERCHANTPAYOUT.PAYOUT
settlement_currencyenumMoneda en la que se realizó el payout (MAX 3; MIN 3; ISO 4217).BRL
settlement_gross_amountdecimalMonto bruto del payout según lo informa el proveedor (múltiplo de 0.0001).20215.42
settlement_feesdecimalComisiones que el proveedor deduce en el payout (múltiplo de 0.0001). Algunos proveedores expresan las comisiones como valores negativos.353.53
settlement_net_amountdecimalMonto neto pagado según lo informa el proveedor (múltiplo de 0.0001). No siempre es el bruto menos las comisiones: algunos proveedores también deducen reembolsos y ajustes dentro del payout.18041.97
descriptionstringTexto libre informado por el proveedor: banco, sucursal y cuenta, estado, identificador fiscal, fecha prevista, entre otros.Payout Date=2026-09-03, Bank=001, Branch=0001, Account=123456
report_datedateFecha del archivo o reporte del proveedor del que se tomó la fila (ISO 8601, YYYY-MM-DD). Puede ser posterior a payout_date.2026-09-03
source_file_typestringSección o archivo del reporte del proveedor del que se tomó la fila. Vacío en ingestas antiguas.settlement
updated_attimestampFecha y hora en que Yuno procesó la fila por última vez (ISO 8601, UTC, sin designador de zona).2026-09-03T02:16:16.000000
primary_keystringIdentificador estable de la fila. Úsalo para detectar cambios entre dos ejecuciones del reporte.9770dff205e82f7d0f7bbb85b63caeed
settlement_datetimestampFecha y hora del payout. La hora solo está presente cuando el proveedor la informa. Columna opcional.2026-09-03 00:00:00
currencyenumAlias de settlement_currency (MAX 3; MIN 3; ISO 4217). Columna opcional.BRL
provider_uuidstringIdentificador único del proveedor en el catálogo de Yuno (MAX 64; MIN 36). Columna opcional.432ee183-ee45-454f-99de-a22f8ff9bbf5
organization_codestringIdentificador único de la organización (MAX 64; MIN 36). Columna opcional.64143128-dd12-11ec-9d64-0242ac120002

Reporte de comunicaciones

El reporte de comunicaciones ofrece información detallada sobre todas las comunicaciones (llamadas, mensajes) entre los clientes y el comercio a través de los canales de comunicación de Yuno. Este reporte incluye datos sobre la duración de las llamadas, el contenido de los mensajes, el estado de la comunicación y otras métricas relevantes.
ParámetroTipoDescripciónEjemplo
communication_idstringIdentificador único de la comunicación (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120002
order_idstringIdentificador de la orden asociada a la comunicación (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120003
payment_idstringIdentificador del pago asociado a la comunicación (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120004
communication_statusenumEstado actual de la comunicación (MAX 255; MIN 3).COMPLETED
destination_phonestringNúmero de teléfono al que se envió la comunicación (MAX 255; MIN 3).+1234567890
created_atdatetimeFecha y hora en que se inició la comunicación (ISO 8601).2024-03-15 14:30:00
countrystringCódigo del país al que se envió la comunicación (ISO 3166-1 alpha-2; MAX 2; MIN 2).US
transcriptionstringTranscripción de texto del contenido de la comunicación (MAX 1000; MIN 3).Customer confirmed payment details…
call_durationnumberDuración de la llamada en segundos (MAX 3600; MIN 0).180
messagesarrayArreglo de mensajes intercambiados durante la comunicación.
summarystringResumen del contenido de la comunicación (MAX 500; MIN 3).Payment verification call completed successfully
channelenumCanal de comunicación utilizado (p. ej., VOICE, SMS, WHATSAPP; MAX 50; MIN 3).VOICE
focusstringTema principal o foco de la comunicación (MAX 255; MIN 3).Payment Verification

Reporte de transacciones de fraude

El reporte de transacciones de fraude ofrece información detallada sobre las transacciones que los sistemas de detección de fraude de Yuno marcaron como posible fraude. Este reporte incluye puntajes de fraude, respuestas de los proveedores y detalles de las transacciones para el análisis de riesgo.
ParámetroTipoDescripciónEjemplo
account_idstringIdentificador único de la cuenta (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120002
countryenumPaís donde ocurrió la transacción (MAX 2; MIN 2; ISO 3166-1).US
payment_idstringIdentificador único del pago (MAX 64; MIN 36).69ad0a39-b769-423c-b223-d7b8bf
transaction_idstringIdentificador único de la transacción (MAX 64; MIN 36).b04db1c6-b2c7-4765-a77e-953d284d080b
transaction_typeenumTipo de transacción (p. ej., PURCHASE, REFUND).PURCHASE
statusenumEstado de la transacción (MAX 255; MIN 3).SUCCEEDED
provider_transaction_idstringIdentificador de la transacción del proveedor (MAX 255; MIN 3).T-51056-1e10f992-e5cf-40bf-9eb6-8edc881de30b
response_codestringCódigo de respuesta del sistema (MAX 255; MIN 3).200
provider_idstringIdentificador único del proveedor (MAX 64; MIN 36).PROVIDER ID
provider_scorenumberPuntaje de riesgo de fraude proporcionado por el sistema de detección de fraude (MAX 100; MIN 0).85
provider_third_party_account_idstringID de cuenta de terceros asociado al proveedor (MAX 64; MIN 36).ACC123456
provider_account_idstringIdentificador de la cuenta del proveedor (MAX 64; MIN 36).699ec8d444
provider_statusstringEstado del pago en el proveedor (MAX 255; MIN 3).PAID
provider_status_detailstringEstado detallado del proveedor (MAX 255; MIN 3).Transaction completed successfully
provider_response_messagestringMensaje de respuesta del proveedor (MAX 255; MIN 3).The payment was paid
created_attimestampMarca de tiempo de creación de la transacción (ISO 8601).2024-09-11T23:16:06.602Z
updated_attimestampMarca de tiempo de la última actualización de la transacción (ISO 8601).2024-09-11T23:17:07.602Z
account_integration_idstringIdentificador único de la integración de la cuenta (MAX 64; MIN 36).6a0f939c-0cd1-4350-acbc-b0cbdbee9739
provider_response_codestringCódigo de respuesta del proveedor (MAX 255; MIN 3).200

Reporte de payouts

El reporte de payouts ofrece información detallada sobre todas las transacciones de payout procesadas a través de Yuno. Este reporte incluye datos del beneficiario, métodos de retiro, estado del payout e información financiera para fines de seguimiento y conciliación.
ParámetroTipoDescripciónEjemplo
beneficiary_national_entitystringEntidad nacional u organización del beneficiario.Bank ABC
payout_idstringIdentificador único del payout (MAX 64; MIN 36).69ad0a39-b769-423c-b223-d7b8bf
beneficiary_legal_namestringNombre legal del beneficiario (MAX 255; MIN 3).John Doe Corporation
account_idstringIdentificador único de la cuenta (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120002
statusenumEstado del payout (MAX 255; MIN 3).SUCCEEDED
merchant_referencestringNúmero de referencia asignado por el comercio (MAX 255; MIN 3).REF123456
descriptionstringDescripción del payout (MAX 255; MIN 3).Commission payment
purposestringPropósito de la transacción de payout.Commission
countryenumPaís donde se procesa el payout (MAX 2; MIN 2; ISO 3166-1).US
amount_valuenumberMonto del payout (múltiplo de 0.0001).100000
currencyenumMoneda utilizada para el payout (MAX 3; MIN 3; ISO 4217).USD
merchant_beneficiary_idstringIdentificador del beneficiario asignado por el comercio (MAX 255; MIN 3).BEN123456
provider_idstringIdentificador único del proveedor (MAX 64; MIN 36).PROVIDER ID
created_attimestampMarca de tiempo de creación del payout (ISO 8601).2024-09-11T23:16:06.602Z
updated_attimestampMarca de tiempo de la última actualización del payout (ISO 8601).2024-09-11T23:17:07.602Z
beneficiary_first_namestringNombre del beneficiario (MAX 255; MIN 3).John
beneficiary_last_namestringApellido del beneficiario (MAX 255; MIN 3).Doe
beneficiary_emailstringDirección de email del beneficiario (MAX 255; MIN 3).john.doe@email.com
beneficiary_countryenumPaís de residencia del beneficiario (MAX 2; MIN 2; ISO 3166-1).US
beneficiary_date_of_birthdateFecha de nacimiento del beneficiario.1985-07-28
beneficiary_document_numberstringNúmero de documento del beneficiario (MAX 20; MIN 5).123456789
beneficiary_document_typeenumTipo de documento del beneficiario (MAX 10; MIN 3).PASSPORT
beneficiary_phone_country_codestringCódigo de país del número de teléfono del beneficiario.1
beneficiary_phone_numberstringNúmero de teléfono del beneficiario (MAX 255; MIN 3).555-1234
beneficiary_address_line_1stringPrimera línea de la dirección del beneficiario (MAX 255; MIN 3).123 Main St
beneficiary_address_line_2stringSegunda línea de la dirección del beneficiario (MAX 255; MIN 3).Apt 202
beneficiary_citystringCiudad de la dirección del beneficiario (MAX 255; MIN 3).New York
beneficiary_statestringEstado o provincia de la dirección del beneficiario (MAX 255; MIN 3).NY
beneficiary_zip_codestringCódigo postal de la dirección del beneficiario (MAX 255; MIN 3).10001
withdrawal_method_branchstringSucursal bancaria del método de retiro.Main Branch
withdrawal_method_branch_digitstringDígito de la sucursal del método de retiro.1
withdrawal_method_account_numberstringNúmero de cuenta del método de retiro (MAX 255; MIN 3).123456789
withdrawal_method_account_digitstringDígito de la cuenta del método de retiro.1
withdrawal_method_account_typeenumTipo de cuenta del método de retiro (MAX 20; MIN 3).CHECKING
withdrawal_method_address_line_1stringPrimera línea de la dirección del método de retiro (MAX 255; MIN 3).456 Bank St
withdrawal_method_address_line_2stringSegunda línea de la dirección del método de retiro (MAX 255; MIN 3).Suite 100
withdrawal_method_address_citystringCiudad de la dirección del método de retiro (MAX 255; MIN 3).Miami
withdrawal_method_statestringEstado de la dirección del método de retiro (MAX 255; MIN 3).FL
withdrawal_method_zip_codestringCódigo postal de la dirección del método de retiro (MAX 255; MIN 3).33101
withdrawal_method_emailstringDirección de email del método de retiro (MAX 255; MIN 3).withdrawal@bank.com
withdrawal_method_document_numberstringNúmero de documento del método de retiro (MAX 20; MIN 5).98765432
withdrawal_method_document_typeenumTipo de documento del método de retiro (MAX 10; MIN 3).ID
withdrawal_method_phone_country_codestringCódigo de país del número de teléfono del método de retiro.1
withdrawal_method_phone_numberstringNúmero de teléfono del método de retiro (MAX 255; MIN 3).123-456-7890
withdrawal_method_typeenumTipo de método de retiro (MAX 50; MIN 3).BANK_TRANSFER
withdrawal_method_codestringCódigo del método de retiro (MAX 50; MIN 3).BANKABC_TRANSFER
withdrawal_method_countryenumPaís del método de retiro (MAX 2; MIN 2; ISO 3166-1).US

Reporte de comisiones

El reporte de comisiones proporciona información detallada sobre todas las comisiones y cargos aplicados a las transacciones procesadas a través de Yuno. Este reporte incluye las comisiones del adquirente, los impuestos, los costos calculados y el estado de las comisiones para el análisis financiero y la conciliación.
ParámetroTipoDescripciónEjemplo
transaction_idstringEl identificador único de la transacción asignado por Yuno (MAX 64; MIN 36).2c5fdb3a-15e5-4f7b-93a7-c229e1688d91
provider_transaction_idstringEl identificador único de la transacción asignado por el gateway. Este campo está vacío si el gateway no proporciona información de la transacción (MAX 255; MIN 3).EDR3848FF094TY
acquirer_typestringNombre del adquirente que procesó el pago original. En los modelos de agregador, el proveedor es el mismo que el adquirente. En otros modelos, pueden ser entidades distintas (MAX 255; MIN 3).Sale
acquirer_gross_amountstringEl monto bruto correspondiente a todas las transacciones en la moneda de liquidación (múltiplo de 0.0001).1000
acquirer_feesstringLa comisión retenida por el adquirente sobre las transacciones en la moneda de liquidación. Debe ser la diferencia entre los montos bruto y neto (múltiplo de 0.0001).15
acquirer_taxesstringEl valor de los impuestos aplicados a las transacciones en la moneda de liquidación. Debe ser la diferencia entre los montos bruto y neto (múltiplo de 0.0001).5
countryenumPaís donde ocurrió la transacción (MAX 2; MIN 2; ISO 3166-1).US
typestringEl tipo de transacción. Mostramos los tipos enviados por el proveedor (MAX 255; MIN 3).PURCHASE
gross_fieldstringColumna de liquidación tomada como monto brutogross_amount
fix_costdecimalCosto fijo sobre el monto bruto de cada transacción0
percentage_costdecimalCosto porcentual del monto bruto de cada transacción0.02
calculated_fix_costed_feedecimalCosto fijo calculado a partir del monto bruto de cada transacción15
calculated_percentage_costdecimalCosto porcentual calculado a partir del monto bruto5
acquirer_net_amountdecimalEl monto enviado en las solicitudes de transacción de crédito menos las comisiones del adquirente en la moneda de liquidación (múltiplo de 0.0001).980
calculated_net_amountdecimalMonto neto calculado con la información del comercio980
fee_taxes_diffdecimalDiferencia entre el net_amount del adquirente y el monto calculado-5
fee_statusenumEstado de validación de las comisionesOK, ERROR
fee_sub_statusenumValidación esperada, error por exceso o error por defectoEXPECTED, ABOVE_EXPECTED, BELOW_EXPECTED
acquirerenumNombre del adquirente que procesó el pago original. En los modelos de agregador, el proveedor es el mismo que el adquirente. En otros modelos, pueden ser entidades distintas (MAX 255; MIN 3).ACQUIRER
settlement_datedateFecha estimada por el adquirente en la que los fondos se depositarán en la cuenta bancaria del comercio.2025-06-01
currencyenumCódigo de la moneda en la que se realizó la transacción (MAX 3; MIN 3; ISO 4217).USD
card_iinnumberEl número de identificación del emisor (IIN) corresponde a los primeros dígitos del número de una tarjeta de pago emitida por una institución financiera (MAX 8; MIN 8).123456
card_lfdnumberÚltimos cuatro dígitos de la tarjeta (MAX 4; MIN 4).1234
authorization_codenumberEn el caso de una transacción con tarjeta, el código que el banco emisor asigna a la transacción cuando se autoriza. Este campo está vacío si el gateway no proporciona información de la transacción (MAX 255; MIN 3).123456

Flujo de caja (Agenda)

El reporte de flujo de caja (también conocido como Agenda) muestra las transacciones que ya se procesaron y están programadas para liquidarse en el futuro. Te permite anticipar los fondos entrantes. Los adelantos (pagos anticipados) se excluyen para que la vista refleje solo las próximas liquidaciones que aún tienes derecho a recibir.
ParámetroTipoDescripciónEjemplo
installmentsnumberNúmero de cuotas de la transacción (MAX 24; MIN 1).6
installment_amountdecimalMonto de la cuota actual (MAX 10000; MIN 0).147.83
installment_numbernumberNúmero de la cuota actual que se está liquidando (MAX 6; MIN 3).1
payment_method_categoryenumCategoría de la transacción (por ejemplo, CARD, WALLET, BANK_TRANSFER) (MAX 255; MIN 3).CARD
bankstringCódigo del banco donde el comercio recibe la liquidación.0237
bank_accountstringDetalles de la cuenta bancaria de la transacción.12345-6
bank_agencystringDetalles de la agencia o sucursal bancaria de la transacción.12
customer_idstringEl identificador único del cliente (MAX 255; MIN 3).cus_23456
payment_method_typeenumEl tipo de método de pago seleccionado por el cliente (MAX 255; MIN 3).VI
pnrstringPassenger Name Record, si aplica (MAX 64; MIN 36).1P-2UUGJW
provider_feesdecimalComisiones cobradas por el proveedor en la moneda original (múltiplo de 0.0001).0.86
provider_idenumIdentificación del proveedor (MAX 255; MIN 3).PROVIDER_ABC
provider_taxesdecimalImpuestos aplicados por el proveedor (múltiplo de 0.0001).0.10
agenda_sub_statusenumSubestado del elemento de la agenda (MAX 255; MIN 3).PENDING
authorization_codestringCódigo de autorización de la transacción (MAX 6; MIN 6).123456
card_brandenumMarca de la tarjeta utilizada (MAX 50; MIN 2).MASTERCARD
card_lfdstringÚltimos cuatro dígitos del número de la tarjeta (MAX 4; MIN 4).7890
provider_intended_settlement_datedateFecha de liquidación prevista informada originalmente por el proveedor.2026-06-11
response_codestringCódigo de respuesta del sistema (MAX 255; MIN 3).SUCCEEDED
status_paymentenumEstado del pago (MAX 255; MIN 3).SUCCEEDED
acquirerenumNombre del adquirente que procesó la transacción (MAX 255; MIN 3).Acquirer ABC
agenda_statusenumEstado del elemento de la agenda (MAX 255; MIN 3).PENDING
card_iinstringNúmero de identificación del emisor (IIN) de la tarjeta (MAX 8; MIN 6).411111
payment_idstringEl identificador único del pago (MAX 64; MIN 36).5104911d-5df9-229e-8468-bd41abea1a4b
pending_amountdecimalMonto aún pendiente de la transacción (múltiplo de 0.0001).49.14
provider_transaction_idstringIdentificador de la transacción del proveedor (MAX 255; MIN 3).53443e9c-dd17-11ec-9d64-0242ac120002
ur_keystringUna combinación de campos que identifica de forma única cada pago en todas las etapas del flujo de pago.01027058000191047408760001…
provider_statusenumEstado del pago en el proveedor (MAX 255; MIN 3).SUCCEEDED
sales_reconciliation_datedateFecha en que está programada la conciliación de ventas.2026-05-13
third_party_transaction_idstringIdentificador de la transacción de un tercero (MAX 255; MIN 3).TP123456789
updated_attimestampMarca de tiempo de la última actualización de la transacción (ISO 8601).2026-05-11T11:33:52.000Z
advancement_amountdecimalMonto adelantado de la transacción (múltiplo de 0.0001). Es cero cuando no se ha aplicado ningún adelanto.0.00
card_typeenumTipo de tarjeta utilizada. Valores posibles: CREDIT, DEBIT.CREDIT
currencyenumCódigo de la moneda de la transacción (MAX 3; MIN 3; ISO 4217).BRL
transaction_amountdecimalMonto de la transacción (MAX 10000; MIN 0).50.00
countryenumPaís de la cuenta del comercio (MAX 2; MIN 2; ISO 3166-1).BR
created_attimestampMarca de tiempo de la creación de la transacción (ISO 8601).2026-05-11T18:33:50.000Z
merchant_order_idstringIdentificación de la orden (MAX 255; MIN 3).ORDER-abc123456789
merchant_transaction_idstringIdentificación de la transacción asignada por tu empresa (MAX 255; MIN 3).TXN-987654321
provider_confirmation_datedateFecha en que el proveedor confirmó la transacción.2026-05-12
transaction_idstringEl identificador único de la transacción asignado por Yuno (MAX 64; MIN 36).9104911d-5df9-429e-8488-ad41abea1a4b
type_transactionenumEl tipo de transacción. Valores posibles: PURCHASE, REFUND, CHARGEBACK.PURCHASE

Reporte de adelantos

El reporte de adelantos registra los pagos anticipados, es decir, los casos en que el proveedor liquida los fondos antes de la fecha programada originalmente (común en Brasil). Úsalo para monitorear qué cuentas por cobrar se adelantaron, las comisiones de negociación aplicadas y el impacto en tu flujo de caja frente al plan de liquidación original.
ParámetroTipoDescripciónEjemplo
operation_idstringIdentificador único de la operación de adelanto (pago anticipado) (MAX 64; MIN 36).69ad0a39-b769-423c-b223-d7b8bf9a1c2d
merchant_idstringIdentificador único del comercio (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120002
organization_codestringIdentificador único de la organización asociada a la operación (MAX 64; MIN 3).ORG_ABC_001
product_idstringIdentificador único del producto o del acuerdo de cuentas por cobrar vinculado al adelanto (MAX 64; MIN 36).f4c53557-a832-44e9-94e4-0344f91e9d4f
ur_keystringClave de referencia única que vincula el adelanto con la cuenta por cobrar subyacente (MAX 255; MIN 3).UR123456789
operation_typeenumTipo de operación de adelanto. Valores posibles: ADVANCE, REFUND.ADVANCE
movement_typeenumTipo de movimiento del adelanto. Valores posibles: CREDIT, DEBIT.CREDIT
operation_datedateFecha en que se procesó la operación de adelanto.2026-04-15
operation_settlement_datedateFecha en que la operación de adelanto se liquidó al comercio.2026-04-16
ur_operation_datedateFecha de la operación UR (cuenta por cobrar) subyacente.2026-04-15
ur_original_settlement_datedateFecha de liquidación originalmente programada dla cuenta por cobrar subyacente, antes del adelanto.2026-05-20
negotiation_gross_amountdecimalMonto bruto negociado para el adelanto (múltiplo de 0.0001).1000.00
negotiation_feesdecimalComisiones cobradas por la negociación (múltiplo de 0.0001).15.00
negotiation_net_amountdecimalMonto neto después de las comisiones de negociación (múltiplo de 0.0001).985.00
ur_gross_amountdecimalMonto bruto de la operación UR subyacente (múltiplo de 0.0001).1000.00
ur_feesdecimalComisiones cobradas por la operación UR (múltiplo de 0.0001).10.00
ur_net_amountdecimalMonto neto de la operación UR (múltiplo de 0.0001).990.00
ur_currencyenumMoneda utilizada en la operación UR (MAX 3; MIN 3; ISO 4217).BRL
acquirerenumNombre del adquirente que procesó el adelanto (MAX 255; MIN 3).Acquirer ABC
countryenumPaís donde ocurrió la operación de adelanto (MAX 2; MIN 2; ISO 3166-1).BR
bankstringDetalles del banco de la operación de adelanto (MAX 255; MIN 3).0237
bank_agencystringDetalles de la agencia bancaria de la operación de adelanto (MAX 255; MIN 3).12
bank_accountstringDetalles de la cuenta bancaria de la operación de adelanto (MAX 255; MIN 3).12345-6
settlement_accountstringEl identificador único de la cuenta de liquidación que recibió el adelanto (MAX 64; MIN 36).64143128-dd12-11ec-9d64-0242ac120002