- Pago
- Transacción
- Resumen de conciliación
- Liquidaciones y comisiones
- Payouts de liquidación
- Comunicaciones
- Transacciones de fraude
- Payouts
- Comisiones
- Flujo de caja (Agenda)
- Anticipos
Reporte de pagos
Detalles de los campos del reporte de pagos
Detalles de los campos del reporte de pagos
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
account_id | string | El identificador único de la cuenta (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120002 |
airline_leg_arrival_airport | string | Código del aeropuerto de destino del tramo de vuelo. | JFK |
airline_leg_base_fare | number | Tarifa base del tramo de vuelo antes de impuestos y cargos. | 250 |
airline_leg_base_fare_currency | enum | Moneda en la que se cobra la tarifa base (ISO 4217). | USD |
airline_leg_carrier_code | string | Código de la aerolínea transportista del tramo de vuelo. | AA |
airline_leg_departure_airport | string | Código del aeropuerto de salida del tramo de vuelo. | LAX |
airline_leg_departure_datetime | datetime | Fecha y hora de salida del vuelo. | 2024-09-12 15:30 |
airline_leg_fare_basis_code | string | Código que define las reglas tarifarias del boleto. | Y26HNR |
airline_leg_fare_class_code | string | Código de clase del boleto (p. ej., económica, ejecutiva). | Y |
airline_leg_flight_number | string | Número del vuelo del tramo específico. | 100 |
airline_leg_stopover_code | enum | Indica si el vuelo tiene escala (Y/N). | N |
airline_passenger_country | string | País de residencia del pasajero. | US |
airline_passenger_date_of_birth | date | Fecha de nacimiento del pasajero. | 1990-05-14 |
airline_passenger_document_number | string | Número del documento de identificación del pasajero. | A12345678 |
airline_passenger_document_type | enum | Tipo de documento de identificación (p. ej., pasaporte, documento de identidad). | PASSPORT |
airline_passenger_email | string | Dirección de email del pasajero. | passenger@email.com |
airline_passenger_first_name | string | Nombre del pasajero. | John |
airline_passenger_last_name | string | Apellido del pasajero. | Doe |
airline_passenger_loyalty_number | string | Número del programa de lealtad del pasajero. | 123456789 |
airline_passenger_loyalty_tier | enum | Nivel del programa de lealtad del pasajero (p. ej., Gold, Platinum). | Gold |
airline_passenger_middle_name | string | Segundo nombre del pasajero (si aplica). | Andrew |
airline_passenger_nationality | string | Nacionalidad del pasajero. | US |
airline_passenger_phone_country_code | string | Código de país del número de teléfono del pasajero. | 1 |
airline_passenger_phone_number | string | Número de teléfono del pasajero. | 555-1234 |
airline_passenger_type | enum | Tipo de pasajero (p. ej., adulto, niño, infante). | Adulto |
airline_ticket_e_ticket | boolean | Indica si el boleto es electrónico (true/false). | TRUE |
airline_ticket_issue_address | string | Dirección donde se emitió el boleto. | 123 Main St |
airline_ticket_issue_carrier_prefix_code | string | Código de prefijo de la aerolínea emisora. | 1 |
airline_ticket_issue_city | string | Ciudad donde se emitió el boleto. | New York |
airline_ticket_issue_country | string | País donde se emitió el boleto. | US |
airline_ticket_issue_date | date | Fecha en que se emitió el boleto. | 2024-09-10 |
airline_ticket_issue_travel_agent_code | string | Código del agente de viajes que emitió el boleto. | TA123 |
airline_ticket_issue_travel_agent_name | string | Nombre del agente de viajes que emitió el boleto. | John Doe Travel |
airline_ticket_issue_zip_code | string | Código postal donde se emitió el boleto. | 10001 |
airline_ticket_restricted | boolean | Indica si el boleto tiene restricciones (true/false). | FALSE |
airline_ticket_ticket_number | string | Número único asignado al boleto. | 1234567890123 |
airline_ticket_total_fare_amount | number | Monto total pagado por el boleto. | 300 |
airline_ticket_total_fee_amount | number | Total de cargos adicionales aplicados al boleto. | 50 |
airline_ticket_total_tax_amount | number | Total de impuestos aplicados al boleto. | 25 |
authorization_code | string | Có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_value | number | El monto del pago (múltiplo de 0.0001). | 111111 |
bank_name | string | Nombre del banco asociado a la transacción. | Wells Fargo |
beneficiary_name | string | Nombre del beneficiario de la transacción o del pago. | Jane Doe |
billing_cycles_current | integer | Número del ciclo de facturación actual (indexado desde 1) para pagos asociados a una suscripción. | 3 |
billing_cycles_next_at | datetime | Marca de tiempo de la próxima facturación programada para pagos asociados a una suscripción. | 2027-04-10T10:14:39.515Z |
billing_cycles_total | integer | Número total de ciclos de facturación configurados. 2000000 es un valor centinela para una suscripción indefinida (ilimitada). | 12 |
bnpl_installments | string | Las cuotas del préstamo (MAX 50; MIN 1). | 12 |
browser_info_accept_header | string | El encabezado ‘accept’ enviado por el navegador. | text/html |
browser_info_color_depth | number | Profundidad de color admitida por la pantalla del navegador (en bits). | 24 |
browser_info_javascript_enabled | boolean | Indica si JavaScript está habilitado en el navegador. | TRUE |
browser_info_language | string | Idioma predeterminado configurado en el navegador. | en-US |
browser_info_screen_height | number | Altura de la pantalla del navegador en píxeles. | 1080 |
browser_info_screen_width | number | Ancho de la pantalla del navegador en píxeles. | 1920 |
browser_info_user_agent | string | Cadena de user agent que representa el navegador y el sistema operativo. | Mozilla/5.0 |
captured | number | Indica el monto total capturado del pago. | 1000.00 |
card_brand | string | Marca de la tarjeta utilizada en la transacción (p. ej., Visa, MasterCard). | Visa |
card_category | string | Categoría de la tarjeta (p. ej., crédito, débito). | Credit |
card_holder_name | string | Nombre del titular de la tarjeta. | John Doe |
card_iin | string | Número de identificación del emisor (IIN) de la tarjeta (primeros 6 dígitos). | 123456 |
card_issuer_code | string | Código que identifica al emisor de la tarjeta. | CITI123 |
card_issuer_name | string | Nombre del banco o institución que emite la tarjeta. | Citi Bank |
card_lfd | number | Últimos cuatro dígitos del número de la tarjeta. | 7890 |
card_type | enum | Tipo de tarjeta (p. ej., crédito, débito). | Credit |
checkout_session | string | Identificador único de la sesión de checkout. | ch_sess_12345 |
country | enum | El país donde se debe procesar la transacción (MAX 2; MIN 2; ISO 3166-1). | US |
connection_name | string | Etiqueta 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_at | timestamp | La fecha de creación del pago (MAX 27; MIN 27; ISO 8601). | 2022-05-09T20:46:54.786342Z |
currency | enum | La moneda utilizada para realizar el pago (MAX 3; MIN 3; ISO 4217). | COP |
customer_first_name | string | El nombre del cliente (MAX 255; MIN 1). | John |
customer_id | string | El identificador único del cliente (MAX 255; MIN 3). | 23456 |
customer_last_name | string | El apellido del cliente (MAX 255; MIN 1). | Doe |
customer_payer_phone_country_code | number | El código de país del cliente (MAX 3; MIN 2). | 52 |
customer_payer_phone_number | number | El número de teléfono del cliente (MAX 255; MIN 1). | 3313873320 |
date_of_birth | date | Fecha de nacimiento de la persona. | 1985-07-28 |
description | string | La descripción del pago (MAX 255; MIN 3). | Order1234 |
device_fingerprint | string | Identificador único del dispositivo utilizado en la transacción. | df_987654321 |
document_number | string | Número de documento de la persona. | A98765432 |
document_type | enum | Tipo de documento (p. ej., documento de identidad, pasaporte). | ID |
email | string | El email del cliente (MAX 255; MIN 3). | john.doe@email.com |
gender | enum | Género de la persona. | Male |
installments | number | Número de cuotas del pago. | 6 |
ip_address | string | La dirección IP del cliente (MAX 255; MIN 3). | 2806:103e:2a:414 |
merchant_customer_id | enum | Un identificador único asignado por un comercio para representar a un cliente específico (MAX 255; MIN 3). | 9440127422 |
merchant_order_id | string | La identificación de la orden (MAX 255; MIN 3). | 123456789 |
metadata_value | string (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}. | |
nationality | string | Nacionalidad de la persona. | US |
network_token | string | Número del token sin separadores (MAX 19; MIN 8), disponible solo para comercios con certificación PCI. | 1234567890123456 |
network_transaction_id | string | Identificador ú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_iin | string | IIN/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_last4 | string | Últimos 4 dígitos del PAN del network token (DPAN). Difiere de card_lfd. Se completa en transacciones con network token. | 8394 |
network_token_type | string | Tipo 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_amount | number | Total de comisiones aplicadas a la orden. | 10 |
order_item_brand | string | Marca del artículo de la orden. | Nike |
order_item_category | string | Categoría del artículo de la orden. | Shoes |
order_item_id | string | Identificador único del artículo de la orden. | item_12345 |
order_item_manufacture_part_number | string | Número de parte del fabricante del artículo. | MP56789 |
order_item_name | string | Nombre del artículo de la orden. | Air Max 2024 |
order_item_quantity | number | Cantidad del artículo de la orden. | 2 |
order_item_sku_code | string | Código SKU del artículo de la orden. | SKU98765 |
order_item_unit_amount | number | Precio unitario del artículo. | 150 |
order_shipping_amount | number | Costo de envío de la orden. | 20 |
payment_callback_url | string | Un endpoint URL proporcionado por el comercio. | https://www.domain.com |
payment_id | string | Un identificador único asignado a una transacción de pago específica. | 69ad0a39-b769-423c-b223-d7b8bf |
payment_method_type | string | Mé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_city | string | Ciudad de la dirección del vendedor. | Miami |
payment_seller_details_address_country | string | País de la dirección del vendedor. | US |
payment_seller_details_address_line_1 | string | Primera línea de la dirección del vendedor. | 456 Market St |
payment_seller_details_address_line_2 | string | Segunda línea de la dirección del vendedor. | Apt 202 |
payment_seller_details_address_state | string | Estado o provincia de la dirección del vendedor. | FL |
payment_seller_details_address_zip_code | string | Código postal de la dirección del vendedor. | 33101 |
payment_seller_details_country | string | País donde tiene su sede el vendedor. | US |
payment_seller_details_document_number | string | Número de documento del vendedor. | 98765432 |
payment_seller_details_document_type | enum | Tipo de documento del vendedor (p. ej., ID, pasaporte). | ID |
payment_seller_details_email | string | Dirección de email del vendedor. | seller@domain.com |
payment_seller_details_industry | string | La industria a la que pertenece el vendedor. | Retail |
payment_seller_details_name | string | Nombre del vendedor. | Best Store |
payment_seller_details_phone_code | string | Código de país del número de teléfono del vendedor. | 1 |
payment_seller_details_phone_number | string | Número de teléfono del vendedor. | 123-456-7890 |
payment_seller_details_reference | string | Referencia interna del vendedor. | ref_789456 |
payment_seller_details_web_site | string | URL del sitio web del vendedor. | www.domain.com |
payment_tax_base | number | Monto base utilizado para calcular el impuesto. | 100 |
payment_tax_percentage | number | Porcentaje de impuesto aplicado a la transacción. | 10 |
payment_tax_type | string | Tipo de impuesto aplicado (p. ej., VAT, GST). | VAT |
payment_tax_value | number | El monto del impuesto calculado. | 10 |
payment_workflow | string | Workflow utilizado para el proceso de pago. | standard |
pnr | string | Referencia del Passenger Name Record (PNR). | 1P-2UUGJW |
provider_number | integer | El número del ticket. | 13141 |
refunded | number | El monto del pago que fue reembolsado. | 10000 |
sdk_action_required | boolean | Un campo booleano que indica si se necesita una acción adicional del cliente o del comercio. | TRUE |
status | enum | El estado del pago (MAX 255; MIN 3). | SUCCEEDED |
sub_status | enum | El subestado del pago (MAX 255; MIN 3). | APPROVED |
subscription_id | string | Un identificador único asignado a una suscripción recurrente o a un acuerdo de facturación. | 111aaa222 |
transaction_id | string (uuid) | Identificador interno de la transacción de Yuno asociado al pago. | 67d2c9dc-69c6-45b0-b07e-34e869f4d471 |
updated_at | timestamp | La fecha y hora de la última actualización del pago. | 2022-05-15T20:46:54.786342Z |
Reporte de transacciones
Detalles de los campos del reporte de transacciones
Detalles de los campos del reporte de transacciones
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
account_id | string | Identificador único de la cuenta (MAX 64; MIN 36). | 2c05976d-f696-497f-a309-6421883de48d |
account_integration_id | string | Identificador único de la integración de la cuenta (MAX 64; MIN 36). | 6a0f939c-0cd1-4350-acbc-b0cbdbee9739 |
amount | number | Monto de la transacción (MAX 10000; MIN 0). | 887 |
authorization_code | string | Código de autorización de la transacción (MAX 6; MIN 6). | 161058 |
bank_name | string | Nombre del banco que participa en la transacción (MAX 100; MIN 3). | Bank ABC |
bank_transfer_account | string | Detalles de la cuenta de transferencia bancaria (MAX 255; MIN 3). | 12345678901234567 |
bank_transfer_account_2 | string | Detalles de la cuenta secundaria de transferencia bancaria (MAX 255; MIN 3). | 76543210987654321 |
bank_transfer_account_type | enum | Tipo de la cuenta de transferencia bancaria (MAX 20; MIN 3). | Checking |
bank_transfer_payment_instruction | string | Instrucciones para pagos por transferencia bancaria (MAX 255; MIN 3). | Payment to be completed within 48 hours. |
beneficiary_document | string | Identificador del documento del beneficiario (MAX 20; MIN 5). | 123456789 |
beneficiary_document_type | enum | Tipo de documento del beneficiario (MAX 10; MIN 3). | Passport |
beneficiary_name | string | Nombre completo del beneficiario (MAX 255; MIN 3). | John Doe |
billing_cycles_current | integer | Número del ciclo de facturación actual (con índice desde 1) para pagos respaldados por suscripciones. | 3 |
billing_cycles_next_at | datetime | Marca de tiempo de la próxima facturación programada para pagos respaldados por suscripciones. | 2027-04-10T10:14:39.515Z |
billing_cycles_total | integer | Número total de ciclos de facturación configurados. 2000000 es un valor centinela para una suscripción indefinida (ilimitada). | 12 |
capture | boolean | Indica si la transacción está capturada. | TRUE |
card_brand | string | Marca de la tarjeta utilizada (MAX 50; MIN 2). | VISA |
card_category | string | Categoría de la tarjeta utilizada (MAX 50; MIN 2). | CLASSIC |
card_holder_name | string | Nombre del titular de la tarjeta (MAX 255; MIN 2). | Jane Doe |
card_iin | string | Número de identificación del emisor (IIN) de la tarjeta (MAX 8; MIN 6). | 49296404 |
card_issuer_code | string | Código del emisor de la tarjeta (MAX 50; MIN 2). | BCO001 |
card_issuer_country | string | Código de país ISO Alpha-2 del banco emisor, derivado del IIN de la tarjeta. | MX |
card_issuer_name | string | Nombre del emisor de la tarjeta (MAX 100; MIN 3). | Bank ABC |
card_lfd | string | Últimos cuatro dígitos del número de la tarjeta (MAX 4; MIN 4). | 1228 |
card_number_length | number | Longitud del número de la tarjeta (MAX 19; MIN 12). | 16 |
card_security_code_length | number | Longitud del código de seguridad de la tarjeta (MAX 4; MIN 3). | 3 |
card_type | enum | Tipo de tarjeta utilizada (CREDIT o DEBIT). | CREDIT |
card_expiration_month | number | Mes de vencimiento de la tarjeta (MAX 2; MIN 1). | 10 |
card_expiration_year | number | Año de vencimiento de la tarjeta (MAX 2; MIN 2). | 10 |
country | enum | País donde ocurrió la transacción (MAX 2; MIN 2). | UY |
connection_name | string | Etiqueta 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_at | timestamp | Marca de tiempo de creación de la transacción (ISO 8601). | 2024-09-11T23:16:06.602Z |
currency | enum | Código de moneda de la transacción (MAX 3; MIN 3). | UYU |
customer_first_name | string | Nombre del cliente (MAX 255; MIN 3). | Jane |
customer_id | string | Identificador único del cliente (MAX 64; MIN 36). | f4c53557-a832-44e9 -94e4-0344f91e9d4f |
customer_last_name | string | Apellido del cliente (MAX 255; MIN 3). | Doe |
description | string | Descripción de la transacción (MAX 255; MIN 3). | Merchant Ecommerce |
document_number | string | Número de documento del cliente (MAX 20; MIN 5). | 48054205 |
document_type | string | Tipo de documento del cliente (MAX 10; MIN 2). | CI |
email | string | Dirección de email del cliente (MAX 255; MIN 3). | example@email.com |
first_installments_deferral | string | Detalles del diferimiento de la primera cuota (MAX 255; MIN 3). | No deferral |
fingerprint_code | string (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_score | number | Puntuación de análisis de fraude proporcionada por el sistema de detección de fraude (MAX 100; MIN 0). | 85 |
installments | number | Número de cuotas de la transacción (MAX 24; MIN 1). | 1 |
installments_amount | number | Monto total de las cuotas (MAX 10000; MIN 0). | 887 |
installments_type | string | Tipo de plan de cuotas (MAX 50; MIN 3). | Single payment |
iso_code | string | Código de respuesta ISO 8583 devuelto por el adquirente o la red. 00/000 indican aprobación. | 00 |
iso_message | string | Mensaje asociado a la respuesta ISO 8583. | Aprobado |
merchant_order_id | string | Identificador de la orden del comercio (MAX 64; MIN 36). | NC2- 66e224a53fb722eaa0507579 |
merchant_transaction_id | string | Identificador de la transacción del comercio (MAX 64; MIN 36). | NC2- 66e224a53fb722eaa0507579 |
merchant_advice_code | string | Merchant Advice Code normalizado para transacciones rechazadas; úsalo para guiar el comportamiento de reintento y el enrutamiento. | 01 |
merchant_advice_code_message | string | Mensaje legible que explica la recomendación devuelta en merchant_advice_code. | Reintentar después de 24 horas |
merchant_customer_id | string | El identificador único del cliente en el comercio externo (MAX 255; MIN 3). | 9440127422 |
nationality | string | Nacionalidad del cliente (MAX 3; MIN 2). | UY |
network_token | string | Número del token sin separadores (MAX 19; MIN 8), disponible solo para comercios certificados PCI. | 1234567890123456 |
network_transaction_id | string | Identificador único asignado a una transacción por la red de tarjetas. Se usa para rastrear y referenciar transacciones específicas, en particular en escenarios de pagos recurrentes, y garantiza consistencia y trazabilidad a lo largo del ciclo de vida del pago. (MAX 255; MIN 3) | NTX123456789 |
network_token_iin | string | IIN/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_last4 | string | Ú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_type | string | Tipo 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_id | string | Identificador único del pago (MAX 64; MIN 36). | 49b08cf9-c577-4451- a673-2dc1ae930200 |
payment_link_fee_details | string | Detalles de las comisiones asociadas al enlace de pago (MAX 255; MIN 3). | No additional fees |
payment_link_money_release_date | timestamp | Fecha en que se liberará el dinero del enlace de pago (ISO 8601). | 2024-09-15 |
payment_link_payment_method_detail | string | Detalles del método de pago usado en el enlace de pago (MAX 255; MIN 3). | VISA Card ending in 1228 |
payment_link_payment_method_id | string | Identificador único del método de pago en el enlace de pago (MAX 64; MIN 36). | PLPMID123456 |
payment_link_sponsor_id | string | Identificador único del patrocinador del enlace de pago (MAX 64; MIN 36). | PLS123456 |
payment_method_category | enum | Categoría del método de pago (CARD, BANK_TRANSFER, etc.). | CARD |
payment_method_type | enum | Tipo de método de pago (CARD, BANK_TRANSFER, etc.). | CARD |
pnr | string | Passenger Name Record, si aplica (MAX 64; MIN 36). | 987654321 |
provider_account_id | string | Identificador de la cuenta del proveedor (MAX 64; MIN 36). | 699ec8d444 |
provider_expiration_date | timestamp | Fecha de vencimiento proporcionada por el proveedor (ISO 8601). | 2024-12-31 |
provider_id | string | Identificador único del proveedor (MAX 64; MIN 36). | PROVIDER ID |
provider_merchant_advice_code | string | Merchant Advice Code sin procesar devuelto por el proveedor para transacciones rechazadas. | R1 |
provider_merchant_advice_code_message | string | Mensaje del proveedor que explica el significado del Merchant Advice Code sin procesar. | Issuer unavailable |
provider_raw_notification | string (json) | Payload de la notificación de webhook sin procesar recibida del proveedor. Envuelto como . | |
provider_raw_response | string (json) | Cuerpo de la respuesta sin procesar devuelto por la API del proveedor. Envuelto como . | |
provider_image | string | URL de la imagen o el logotipo del proveedor (MAX 255; MIN 3). | https://example.com/logo.png |
provider_number | string | Número del proveedor (MAX 64; MIN 36). | 12345 |
provider_response_code | string | Código de respuesta del proveedor (MAX 255; MIN 3). | 200 |
provider_response_message | string | Mensaje de respuesta del proveedor (MAX 255; MIN 3). | The payment was paid. |
provider_status | string | Estado del pago en el proveedor (MAX 255; MIN 3). | PAID |
provider_status_detail | string | Estado detallado del proveedor (MAX 255; MIN 3). | La transacción se completó correctamente. |
provider_third_party_account_id | string | ID de cuenta de terceros asociado al proveedor (MAX 64; MIN 36). | ACC123456 |
provider_third_party_transaction_id | string | ID de transacción de terceros asociado al proveedor (MAX 64; MIN 36). | TID123456 |
provider_transaction_id | string | Identificador único de la transacción del proveedor (MAX 64; MIN 36). | T-51056-1e10f992-e5cf- 40bf-9eb6-8edc881de30b |
reason | string | Motivo de la transacción (MAX 255; MIN 3). | Merchant’s order payment |
redirect_url | string | URL a la que se redirigirá al usuario después del pago (MAX 255; MIN 3). | https://example.com/redirect-url |
refund_execution_origin | string | Origen de la ejecución del reembolso (MAX 255; MIN 3). | Customer Request |
refund_execution_user | string | Usuario que ejecutó el reembolso (MAX 255; MIN 3). | RefundServiceAgent |
response_code | string | Código de respuesta del sistema (MAX 255; MIN 3). | 200 |
response_message | string | Mensaje de respuesta del sistema (MAX 255; MIN 3). | Payment successful. |
retrieval_reference_number | string | Número de referencia para recuperar los detalles de la transacción (MAX 255; MIN 3). | 1234567890 |
soft_descriptor | string | El soft descriptor que se muestra en el estado de cuenta bancario del cliente (MAX 22; MIN 3). | MERCHANT ECOMMERCE |
stored_credentials_reason | string | Motivo de negocio por el que se usaron las credenciales almacenadas. Valores: CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILE. | CARD_ON_FILE |
stored_credentials_usage | string | Clasificación de uso. FIRST = captura inicial, USED = uso posterior. | USED |
status | enum | Estado de la transacción (MAX 50; MIN 2). | PAID |
subscription_id | string | Identificador único de una suscripción asociada a la transacción (MAX 64; MIN 36). | SUB123456 |
three_d_secure_cryptogram | string | Datos del criptograma usados en la autenticación 3D Secure (MAX 255; MIN 3). | ABCDEFG12345 |
three_d_secure_directory_server_transaction_id | string | ID de transacción del servidor de directorio para la autenticación 3D Secure (MAX 255; MIN 3). | 3DSTID123456 |
three_d_secure_electronic_commerce_indicator | string | Indicador de comercio electrónico para la autenticación 3D Secure (MAX 255; MIN 3). | ECI05 |
three_d_secure_setup_id | string | ID de configuración para la autenticación 3D Secure (MAX 255; MIN 3). | SETUP123456 |
three_d_secure_transaction_id | string | ID de transacción para la autenticación 3D Secure (MAX 255; MIN 3). | 3DSTXID123456 |
three_d_secure_version | string | Versión del protocolo 3D Secure utilizada (MAX 255; MIN 3). | 2.1.0 |
has_challenge | boolean | Indica si la transacción tiene un paso de desafío (3D Secure). | FALSE |
ticket_provider_barcode | string | Código de barras proporcionado por el proveedor del ticket (MAX 255; MIN 3). | 123456789 |
ticket_provider_format | string | Formato del ticket proporcionado por el proveedor (MAX 255; MIN 3). | |
ticket_provider_logo | string | Logotipo del proveedor del ticket (MAX 255; MIN 3). | https://example.com/logo.png |
token | string | Token generado para la transacción (MAX 255; MIN 3). | fa476a40-854c-4e66 -9a98-55a68a6b88f4 |
transaction_id | string | Identificador único de la transacción (MAX 64; MIN 36). | b04db1c6-b2c7-4765-a77e-953d284d080b |
type | string | Tipo de transacción (MAX 50; MIN 2). | PURCHASE |
updated_at | timestamp | Marca de tiempo de la última actualización de la transacción (ISO 8601). | 2024-09-11T23:17:07.602Z |
vault_on_success | boolean | Indica si se debe almacenar en el vault cuando la transacción es exitosa. | FALSE |
vaulted_token | string | Token generado para una tarjeta almacenada en el vault (MAX 255; MIN 3). | fa476a40-854c-4e66- 9a98-55a68a6b88f4 |
verify | boolean | Indica si se realizó la verificación. | FALSE |
wallet | string | Billetera asociada a la transacción (MAX 255; MIN 3). | Wallet ABC |
wallet_transaction_card_bin | string | El número de identificación del emisor (IIN) corresponde a los primeros dígitos del número de la tarjeta de pago emitida por una institución financiera (MAX 8; MIN 6). | 492964 |
wallet_transaction_card_last_4_digits | string | Los últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4). | 1228 |
Resumen de conciliación
Detalles de los campos de Resumen de conciliación
Detalles de los campos de Resumen de conciliación
| Parameter | Type | Description | Example |
|---|---|---|---|
transaction_id | string | El identificador único de la transacción asignado por Yuno (MAX 64; MIN 36). | 9104911d-5df9-429e-8488-ad41abea1a4b |
payment_id | string | El identificador único del pago (MAX 64; MIN 36). | 5104911d-5df9-229e-8468-bd41abea1a4b |
reconciliation_id | string | El identificador único asignado a una transacción cuando se concilia (MAX 255; MIN 3). | 2478d494-4a20-45b1-8a12-1c2604cf2d1d |
account_id | string | El identificador único de la cuenta (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120002 |
customer_id | string | El identificador único del cliente (MAX 255; MIN 3). | cus_23456 |
merchant_order_id | string | Identificación de la orden asignada por tu empresa (MAX 255; MIN 3). | ORDER-abc123456789 |
merchant_transaction_id | string | Identificación de la transacción asignada por tu empresa (MAX 255; MIN 3). | TXN-987654321 |
created_at | timestamp | Fecha de creación de la transacción (MAX 27; MIN 27; ISO 8601). | 2026-02-03T22:21:03.000Z |
updated_at | timestamp | La fecha y hora de la última actualización de la transacción (ISO 8601). | 2026-02-03T22:40:17.000Z |
reconciliation_date | date | La fecha en que se concilió la transacción (MAX 27; MIN 27; ISO 8601). | 2026-02-09 |
reconciliation_settlement_date | date | Fecha indicada por el adquirente en la que los fondos se depositarán en la cuenta bancaria del comercio. | 2026-02-09 |
estimated_settlement_date | date | Fecha en la que se espera depositar los fondos al comercio. | 2026-02-09 |
provider_id | enum | El ID del proveedor que procesó la transacción. | PROVIDER_ABC |
provider_status | string | El estado de la transacción según el proveedor (MAX 255; MIN 3). | charged_back |
provider_transaction_id | string | El identificador único de la transacción en el proveedor (MAX 255; MIN 3). | 141267964175 |
retrieval_reference_number | string | Número de referencia único para la recuperación de la transacción (MAX 255; MIN 3). | CAQMCAQRisS2iL |
response_code | string | El código que representa la respuesta al resultado de la transacción. | SUCCEEDED |
authorization_code | string | El código de respuesta del adquirente. | 09137Z |
amount | decimal | El monto de la transacción en la moneda original. | 100.00 |
currency | enum | La moneda utilizada para realizar el pago (MAX 3; MIN 3; ISO 4217). | USD |
country | enum | El país donde debe procesarse la transacción (MAX 2; MIN 2; ISO 3166-1). | US |
local_amount | decimal | Monto de la transacción expresado en la moneda local del comercio (múltiplo de 0.0001). | 1000.00 |
net_amount | decimal | Monto neto después de comisiones e impuestos en la moneda original (múltiplo de 0.0001). | 970.00 |
settlement_gross_amount | decimal | Monto bruto de la transacción en la moneda de liquidación (múltiplo de 0.0001). | 100.00 |
settlement_fees | decimal | Comisión total retenida por el adquirente en la moneda de liquidación (múltiplo de 0.0001). | 15.00 |
settlement_net_credit | decimal | Monto de crédito menos comisiones en la moneda de liquidación (múltiplo de 0.0001). | 970.00 |
local_retention | decimal | Retención de impuestos locales aplicada a la transacción (múltiplo de 0.0001). | 0.25 |
local_tax | decimal | Impuestos locales aplicados a la transacción (múltiplo de 0.0001). | 0.50 |
provider_fee_taxes | decimal | Impuestos sobre las comisiones del proveedor en la moneda original (múltiplo de 0.0001). | 0.10 |
provider_fees | decimal | Comisiones retenidas por el proveedor en la moneda original (múltiplo de 0.0001). | 10.00 |
status | enum | El estado de la transacción (MAX 255; MIN 3). | SUCCEEDED |
type | enum | El tipo de transacción. Valores posibles: PURCHASE, REFUND, CHARGEBACK (MAX 255; MIN 3). | PURCHASE |
reconciliation_status | enum | El estado de conciliación de una transacción. Valores posibles: RECONCILED, NOT_RECONCILED, CONFLICT, NON_RECONCILABLE (MAX 255; MIN 3). | RECONCILED |
reconciliation_sub_status | enum | El subestado de conciliación de una transacción. Valores posibles: AUTOMATICALLY, MANUAL, PENDING (MAX 255; MIN 3). | AUTOMATICALLY |
payment_method_category | enum | Categoría de la transacción (p. ej., CARD, WALLET, BANK_TRANSFER) (MAX 255; MIN 3). | CARD |
payment_method_type | enum | El tipo de método de pago seleccionado por el cliente (MAX 255; MIN 3). | MD |
card_brand | enum | La información de la marca de la tarjeta estandarizada por Yuno (MAX 255; MIN 3). | MASTERCARD |
provider_card_brand | string | El método de pago o la marca de la tarjeta según lo informado por el proveedor (MAX 255; MIN 3). | MASTERCARD |
card_category | enum | Categoría de la tarjeta utilizada en la transacción (MAX 255; MIN 3). | CLASSIC |
card_type | enum | El tipo de emisor de la tarjeta. Valores posibles: CREDIT, DEBIT (MAX 255; MIN 3). | CREDIT |
card_iin | string | El 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_lfd | string | Últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4). | 7890 |
card_issuer_country | enum | País del emisor de la tarjeta (MAX 2; MIN 2; ISO 3166-1). | US |
card_issuer_name | string | Banco al que corresponde la tarjeta. | BANK ABC |
card_expiration_month | number | Mes de vencimiento de la tarjeta (MAX 2; MIN 1). | 11 |
card_expiration_year | number | Año de vencimiento de la tarjeta (MAX 2; MIN 2). | 27 |
installments | number | En caso de una transacción con tarjeta, el número de cuotas en las que se solicitó el pago (MAX 2; MIN 1). | 1 |
description | string | Descripción de texto libre de la transacción proporcionada por el comercio. | Ecommerce purchase |
pnr | string | El registro del nombre del pasajero (MAX 255; MIN 3). | 1P-2UUGJW |
Liquidaciones y comisiones
Detalles de los campos de Liquidaciones y comisiones
Detalles de los campos de Liquidaciones y comisiones
| Parámetro | Type | Description | Ejemplo |
|---|---|---|---|
transaction_id | string | El identificador único de la transacción asignado por Yuno (MAX 64; MIN 36). | 9104911d-5df9-429e-8488-ad41abea1a4b |
payment_id | string | El 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_id | string | El identificador único asignado a una transacción cuando se concilia (MAX 255; MIN 3). | 2478d494-4a20-45b1-8a12-1c2604cf2d1d |
settlement_batch_id | string | Nú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_id | string | El ID de la cuenta del comercio (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120002 |
organization_code | string | Identificador único de la organización asociada con la transacción (MAX 64; MIN 3). | ORG_ABC_001 |
customer_id | string | El identificador único del cliente (MAX 255; MIN 3). | cus_23456 |
merchant_order_id | string | Identificación de la orden asignada por el comercio (MAX 255; MIN 3). | ORDER-abc123456789 |
merchant_transaction_id | string | Identificación de la transacción asignada por el comercio (MAX 255; MIN 3). | TXN-987654321 |
provider_merchant_id | string | ID del comercio en el sistema del PSP (MAX 255; MIN 3). | 15a8c304-d334-4da7-bccb-09cf85a1d7a6 |
transaction_date | timestamp | Fecha de creación de la transacción (MAX 27; MIN 27; ISO 8601). | 2026-01-29T20:56:25.000Z |
settlement_date | date | Fecha en la que los fondos se liquidaron en la cuenta del comercio. | 2026-02-03 |
reconciliation_date | date | La fecha en que se concilió la transacción. | 2026-01-21 |
estimated_settlement_date | date | Fecha en la que se espera depositar los fondos al comercio. | 2026-02-05 |
acquirer | enum | Nombre 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_id | enum | Identificador del proveedor / gateway que procesó la transacción. | PROVIDER_ABC |
provider_transaction_id | string | El 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_code | string | En 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 |
type | enum | El tipo de transacción. Valores posibles: PURCHASE, REFUND, CHARGEBACK (MAX 255; MIN 3). | PURCHASE |
currency | enum | Código de la moneda en la que se realizó la transacción original (MAX 3; MIN 3; ISO 4217). | USD |
settlement_currency | enum | Código de la moneda en la que se realizó la liquidación (MAX 3; MIN 3; ISO 4217). | USD |
gross_credit | decimal | Para transacciones de crédito, el monto bruto correspondiente en la moneda original (múltiplo de 0.0001). | 1000.00 |
gross_debit | decimal | Para transacciones de débito (reembolsos, contracargos), el monto bruto correspondiente en la moneda original (múltiplo de 0.0001). | 200.00 |
settlement_gross_amount | decimal | El monto bruto correspondiente a todas las transacciones en la moneda de liquidación (múltiplo de 0.0001). | 100.00 |
settlement_net_credit | decimal | El 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_debit | decimal | El 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_rate | decimal | El tipo de cambio aplicado a la transacción en el momento de la liquidación (múltiplo de 0.0001). | 10.0000 |
local_amount | decimal | Monto de la transacción expresado en la moneda local del comercio (múltiplo de 0.0001). | 1000.00 |
net_amount | decimal | Monto neto en la moneda original después de comisiones e impuestos (múltiplo de 0.0001). | 970.00 |
settlement_fees | decimal | La 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_fees | decimal | Comisiones retenidas por el proveedor en la moneda original (múltiplo de 0.0001). | 10.00 |
settlement_taxes | decimal | El 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_tax | decimal | Impuestos locales aplicados a la transacción en moneda local (múltiplo de 0.0001). | 0.50 |
local_retention | decimal | Retención de impuestos locales aplicada a la transacción en moneda local (múltiplo de 0.0001). | 0.25 |
provider_fee_taxes | decimal | Impuestos sobre las comisiones del proveedor en la moneda original (múltiplo de 0.0001). | 0.10 |
reconciliation_status | enum | El estado de conciliación de una transacción. Valores posibles: RECONCILED, NOT_RECONCILED, CONFLICT, NON_RECONCILABLE (MAX 255; MIN 3). | RECONCILED |
reconciliation_sub_status | enum | El subestado de conciliación de una transacción. Valores posibles: AUTOMATICALLY, MANUAL, PENDING (MAX 255; MIN 3). | AUTOMATICALLY |
payment_method_category | enum | Categoría de la transacción (p. ej., CARD, WALLET, BANK_TRANSFER) (MAX 255; MIN 3). | CARD |
payment_method_type | enum | El tipo de método de pago seleccionado por el cliente (p. ej., VI, MD, PIX, BOLETO) (MAX 255; MIN 3). | VI |
card_brand | enum | Marca de la tarjeta utilizada en la transacción (p. ej., VISA, MASTERCARD, AMEX) (MAX 255; MIN 3). | VISA |
card_type | enum | Tipo de tarjeta utilizada en la transacción. Valores posibles: CREDIT, DEBIT (MAX 7; MIN 5). | CREDIT |
card_iin | string | El 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_lfd | string | Últimos cuatro dígitos de la tarjeta de pago (MAX 4; MIN 4). | 7890 |
installments | number | En caso de una transacción con tarjeta, el número de cuotas en las que se solicitó el pago (MAX 2; MIN 1). | 1 |
country | enum | País de la cuenta del comercio (MAX 2; MIN 2; ISO 3166-1). | US |
payout_batch_id | string | Identificador 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.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.
Detalles de los campos de Settlement Payouts
Detalles de los campos de Settlement Payouts
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
payout_id | string | Identificador 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_id | string | Identificador 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_date | date | Fecha en la que el proveedor pagó los fondos (ISO 8601, YYYY-MM-DD). | 2026-09-03 |
payout_type | enum | Có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_id | enum | Identificador del proveedor que pagó los fondos. | ADYEN |
acquirer | enum | Nombre del adquirente que pagó los fondos. Mismo valor que provider_id, se conserva por coherencia con el reporte Settlements & Fees. | ADYEN |
account_id | string | Cuenta 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 |
type | enum | Tipo de línea de payout según la informa el proveedor. Los valores posibles incluyen PAYOUT, WITHDRAWAL, TED, MERCHANTPAYOUT. | PAYOUT |
settlement_currency | enum | Moneda en la que se realizó el payout (MAX 3; MIN 3; ISO 4217). | BRL |
settlement_gross_amount | decimal | Monto bruto del payout según lo informa el proveedor (múltiplo de 0.0001). | 20215.42 |
settlement_fees | decimal | Comisiones que el proveedor deduce en el payout (múltiplo de 0.0001). Algunos proveedores expresan las comisiones como valores negativos. | 353.53 |
settlement_net_amount | decimal | Monto 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 |
description | string | Texto 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_date | date | Fecha 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_type | string | Sección o archivo del reporte del proveedor del que se tomó la fila. Vacío en ingestas antiguas. | settlement |
updated_at | timestamp | Fecha 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_key | string | Identificador estable de la fila. Úsalo para detectar cambios entre dos ejecuciones del reporte. | 9770dff205e82f7d0f7bbb85b63caeed |
settlement_date | timestamp | Fecha y hora del payout. La hora solo está presente cuando el proveedor la informa. Columna opcional. | 2026-09-03 00:00:00 |
currency | enum | Alias de settlement_currency (MAX 3; MIN 3; ISO 4217). Columna opcional. | BRL |
provider_uuid | string | Identificador único del proveedor en el catálogo de Yuno (MAX 64; MIN 36). Columna opcional. | 432ee183-ee45-454f-99de-a22f8ff9bbf5 |
organization_code | string | Identificador ú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.Detalles de los campos del reporte de comunicaciones
Detalles de los campos del reporte de comunicaciones
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
communication_id | string | Identificador único de la comunicación (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120002 |
order_id | string | Identificador de la orden asociada a la comunicación (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120003 |
payment_id | string | Identificador del pago asociado a la comunicación (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120004 |
communication_status | enum | Estado actual de la comunicación (MAX 255; MIN 3). | COMPLETED |
destination_phone | string | Número de teléfono al que se envió la comunicación (MAX 255; MIN 3). | +1234567890 |
created_at | datetime | Fecha y hora en que se inició la comunicación (ISO 8601). | 2024-03-15 14:30:00 |
country | string | Código del país al que se envió la comunicación (ISO 3166-1 alpha-2; MAX 2; MIN 2). | US |
transcription | string | Transcripción de texto del contenido de la comunicación (MAX 1000; MIN 3). | Customer confirmed payment details… |
call_duration | number | Duración de la llamada en segundos (MAX 3600; MIN 0). | 180 |
messages | array | Arreglo de mensajes intercambiados durante la comunicación. | |
summary | string | Resumen del contenido de la comunicación (MAX 500; MIN 3). | Payment verification call completed successfully |
channel | enum | Canal de comunicación utilizado (p. ej., VOICE, SMS, WHATSAPP; MAX 50; MIN 3). | VOICE |
focus | string | Tema 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.Detalles de los campos del reporte de transacciones de fraude
Detalles de los campos del reporte de transacciones de fraude
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
account_id | string | Identificador único de la cuenta (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120002 |
country | enum | País donde ocurrió la transacción (MAX 2; MIN 2; ISO 3166-1). | US |
payment_id | string | Identificador único del pago (MAX 64; MIN 36). | 69ad0a39-b769-423c-b223-d7b8bf |
transaction_id | string | Identificador único de la transacción (MAX 64; MIN 36). | b04db1c6-b2c7-4765-a77e-953d284d080b |
transaction_type | enum | Tipo de transacción (p. ej., PURCHASE, REFUND). | PURCHASE |
status | enum | Estado de la transacción (MAX 255; MIN 3). | SUCCEEDED |
provider_transaction_id | string | Identificador de la transacción del proveedor (MAX 255; MIN 3). | T-51056-1e10f992-e5cf-40bf-9eb6-8edc881de30b |
response_code | string | Código de respuesta del sistema (MAX 255; MIN 3). | 200 |
provider_id | string | Identificador único del proveedor (MAX 64; MIN 36). | PROVIDER ID |
provider_score | number | Puntaje de riesgo de fraude proporcionado por el sistema de detección de fraude (MAX 100; MIN 0). | 85 |
provider_third_party_account_id | string | ID de cuenta de terceros asociado al proveedor (MAX 64; MIN 36). | ACC123456 |
provider_account_id | string | Identificador de la cuenta del proveedor (MAX 64; MIN 36). | 699ec8d444 |
provider_status | string | Estado del pago en el proveedor (MAX 255; MIN 3). | PAID |
provider_status_detail | string | Estado detallado del proveedor (MAX 255; MIN 3). | Transaction completed successfully |
provider_response_message | string | Mensaje de respuesta del proveedor (MAX 255; MIN 3). | The payment was paid |
created_at | timestamp | Marca de tiempo de creación de la transacción (ISO 8601). | 2024-09-11T23:16:06.602Z |
updated_at | timestamp | Marca de tiempo de la última actualización de la transacción (ISO 8601). | 2024-09-11T23:17:07.602Z |
account_integration_id | string | Identificador único de la integración de la cuenta (MAX 64; MIN 36). | 6a0f939c-0cd1-4350-acbc-b0cbdbee9739 |
provider_response_code | string | Có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.Detalles de los campos del reporte de payouts
Detalles de los campos del reporte de payouts
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
beneficiary_national_entity | string | Entidad nacional u organización del beneficiario. | Bank ABC |
payout_id | string | Identificador único del payout (MAX 64; MIN 36). | 69ad0a39-b769-423c-b223-d7b8bf |
beneficiary_legal_name | string | Nombre legal del beneficiario (MAX 255; MIN 3). | John Doe Corporation |
account_id | string | Identificador único de la cuenta (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120002 |
status | enum | Estado del payout (MAX 255; MIN 3). | SUCCEEDED |
merchant_reference | string | Número de referencia asignado por el comercio (MAX 255; MIN 3). | REF123456 |
description | string | Descripción del payout (MAX 255; MIN 3). | Commission payment |
purpose | string | Propósito de la transacción de payout. | Commission |
country | enum | País donde se procesa el payout (MAX 2; MIN 2; ISO 3166-1). | US |
amount_value | number | Monto del payout (múltiplo de 0.0001). | 100000 |
currency | enum | Moneda utilizada para el payout (MAX 3; MIN 3; ISO 4217). | USD |
merchant_beneficiary_id | string | Identificador del beneficiario asignado por el comercio (MAX 255; MIN 3). | BEN123456 |
provider_id | string | Identificador único del proveedor (MAX 64; MIN 36). | PROVIDER ID |
created_at | timestamp | Marca de tiempo de creación del payout (ISO 8601). | 2024-09-11T23:16:06.602Z |
updated_at | timestamp | Marca de tiempo de la última actualización del payout (ISO 8601). | 2024-09-11T23:17:07.602Z |
beneficiary_first_name | string | Nombre del beneficiario (MAX 255; MIN 3). | John |
beneficiary_last_name | string | Apellido del beneficiario (MAX 255; MIN 3). | Doe |
beneficiary_email | string | Dirección de email del beneficiario (MAX 255; MIN 3). | john.doe@email.com |
beneficiary_country | enum | País de residencia del beneficiario (MAX 2; MIN 2; ISO 3166-1). | US |
beneficiary_date_of_birth | date | Fecha de nacimiento del beneficiario. | 1985-07-28 |
beneficiary_document_number | string | Número de documento del beneficiario (MAX 20; MIN 5). | 123456789 |
beneficiary_document_type | enum | Tipo de documento del beneficiario (MAX 10; MIN 3). | PASSPORT |
beneficiary_phone_country_code | string | Código de país del número de teléfono del beneficiario. | 1 |
beneficiary_phone_number | string | Número de teléfono del beneficiario (MAX 255; MIN 3). | 555-1234 |
beneficiary_address_line_1 | string | Primera línea de la dirección del beneficiario (MAX 255; MIN 3). | 123 Main St |
beneficiary_address_line_2 | string | Segunda línea de la dirección del beneficiario (MAX 255; MIN 3). | Apt 202 |
beneficiary_city | string | Ciudad de la dirección del beneficiario (MAX 255; MIN 3). | New York |
beneficiary_state | string | Estado o provincia de la dirección del beneficiario (MAX 255; MIN 3). | NY |
beneficiary_zip_code | string | Código postal de la dirección del beneficiario (MAX 255; MIN 3). | 10001 |
withdrawal_method_branch | string | Sucursal bancaria del método de retiro. | Main Branch |
withdrawal_method_branch_digit | string | Dígito de la sucursal del método de retiro. | 1 |
withdrawal_method_account_number | string | Número de cuenta del método de retiro (MAX 255; MIN 3). | 123456789 |
withdrawal_method_account_digit | string | Dígito de la cuenta del método de retiro. | 1 |
withdrawal_method_account_type | enum | Tipo de cuenta del método de retiro (MAX 20; MIN 3). | CHECKING |
withdrawal_method_address_line_1 | string | Primera línea de la dirección del método de retiro (MAX 255; MIN 3). | 456 Bank St |
withdrawal_method_address_line_2 | string | Segunda línea de la dirección del método de retiro (MAX 255; MIN 3). | Suite 100 |
withdrawal_method_address_city | string | Ciudad de la dirección del método de retiro (MAX 255; MIN 3). | Miami |
withdrawal_method_state | string | Estado de la dirección del método de retiro (MAX 255; MIN 3). | FL |
withdrawal_method_zip_code | string | Código postal de la dirección del método de retiro (MAX 255; MIN 3). | 33101 |
withdrawal_method_email | string | Dirección de email del método de retiro (MAX 255; MIN 3). | withdrawal@bank.com |
withdrawal_method_document_number | string | Número de documento del método de retiro (MAX 20; MIN 5). | 98765432 |
withdrawal_method_document_type | enum | Tipo de documento del método de retiro (MAX 10; MIN 3). | ID |
withdrawal_method_phone_country_code | string | Código de país del número de teléfono del método de retiro. | 1 |
withdrawal_method_phone_number | string | Número de teléfono del método de retiro (MAX 255; MIN 3). | 123-456-7890 |
withdrawal_method_type | enum | Tipo de método de retiro (MAX 50; MIN 3). | BANK_TRANSFER |
withdrawal_method_code | string | Código del método de retiro (MAX 50; MIN 3). | BANKABC_TRANSFER |
withdrawal_method_country | enum | Paí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.Detalles de los campos del reporte de comisiones
Detalles de los campos del reporte de comisiones
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
transaction_id | string | El identificador único de la transacción asignado por Yuno (MAX 64; MIN 36). | 2c5fdb3a-15e5-4f7b-93a7-c229e1688d91 |
provider_transaction_id | string | El 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_type | string | Nombre 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_amount | string | El monto bruto correspondiente a todas las transacciones en la moneda de liquidación (múltiplo de 0.0001). | 1000 |
acquirer_fees | string | La 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_taxes | string | El 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 |
country | enum | País donde ocurrió la transacción (MAX 2; MIN 2; ISO 3166-1). | US |
type | string | El tipo de transacción. Mostramos los tipos enviados por el proveedor (MAX 255; MIN 3). | PURCHASE |
gross_field | string | Columna de liquidación tomada como monto bruto | gross_amount |
fix_cost | decimal | Costo fijo sobre el monto bruto de cada transacción | 0 |
percentage_cost | decimal | Costo porcentual del monto bruto de cada transacción | 0.02 |
calculated_fix_costed_fee | decimal | Costo fijo calculado a partir del monto bruto de cada transacción | 15 |
calculated_percentage_cost | decimal | Costo porcentual calculado a partir del monto bruto | 5 |
acquirer_net_amount | decimal | El 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_amount | decimal | Monto neto calculado con la información del comercio | 980 |
fee_taxes_diff | decimal | Diferencia entre el net_amount del adquirente y el monto calculado | -5 |
fee_status | enum | Estado de validación de las comisiones | OK, ERROR |
fee_sub_status | enum | Validación esperada, error por exceso o error por defecto | EXPECTED, ABOVE_EXPECTED, BELOW_EXPECTED |
acquirer | enum | Nombre 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_date | date | Fecha estimada por el adquirente en la que los fondos se depositarán en la cuenta bancaria del comercio. | 2025-06-01 |
currency | enum | Código de la moneda en la que se realizó la transacción (MAX 3; MIN 3; ISO 4217). | USD |
card_iin | number | El 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_lfd | number | Últimos cuatro dígitos de la tarjeta (MAX 4; MIN 4). | 1234 |
authorization_code | number | En 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.Detalles de los campos del flujo de caja (Agenda)
Detalles de los campos del flujo de caja (Agenda)
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
installments | number | Número de cuotas de la transacción (MAX 24; MIN 1). | 6 |
installment_amount | decimal | Monto de la cuota actual (MAX 10000; MIN 0). | 147.83 |
installment_number | number | Número de la cuota actual que se está liquidando (MAX 6; MIN 3). | 1 |
payment_method_category | enum | Categoría de la transacción (por ejemplo, CARD, WALLET, BANK_TRANSFER) (MAX 255; MIN 3). | CARD |
bank | string | Código del banco donde el comercio recibe la liquidación. | 0237 |
bank_account | string | Detalles de la cuenta bancaria de la transacción. | 12345-6 |
bank_agency | string | Detalles de la agencia o sucursal bancaria de la transacción. | 12 |
customer_id | string | El identificador único del cliente (MAX 255; MIN 3). | cus_23456 |
payment_method_type | enum | El tipo de método de pago seleccionado por el cliente (MAX 255; MIN 3). | VI |
pnr | string | Passenger Name Record, si aplica (MAX 64; MIN 36). | 1P-2UUGJW |
provider_fees | decimal | Comisiones cobradas por el proveedor en la moneda original (múltiplo de 0.0001). | 0.86 |
provider_id | enum | Identificación del proveedor (MAX 255; MIN 3). | PROVIDER_ABC |
provider_taxes | decimal | Impuestos aplicados por el proveedor (múltiplo de 0.0001). | 0.10 |
agenda_sub_status | enum | Subestado del elemento de la agenda (MAX 255; MIN 3). | PENDING |
authorization_code | string | Código de autorización de la transacción (MAX 6; MIN 6). | 123456 |
card_brand | enum | Marca de la tarjeta utilizada (MAX 50; MIN 2). | MASTERCARD |
card_lfd | string | Últimos cuatro dígitos del número de la tarjeta (MAX 4; MIN 4). | 7890 |
provider_intended_settlement_date | date | Fecha de liquidación prevista informada originalmente por el proveedor. | 2026-06-11 |
response_code | string | Código de respuesta del sistema (MAX 255; MIN 3). | SUCCEEDED |
status_payment | enum | Estado del pago (MAX 255; MIN 3). | SUCCEEDED |
acquirer | enum | Nombre del adquirente que procesó la transacción (MAX 255; MIN 3). | Acquirer ABC |
agenda_status | enum | Estado del elemento de la agenda (MAX 255; MIN 3). | PENDING |
card_iin | string | Número de identificación del emisor (IIN) de la tarjeta (MAX 8; MIN 6). | 411111 |
payment_id | string | El identificador único del pago (MAX 64; MIN 36). | 5104911d-5df9-229e-8468-bd41abea1a4b |
pending_amount | decimal | Monto aún pendiente de la transacción (múltiplo de 0.0001). | 49.14 |
provider_transaction_id | string | Identificador de la transacción del proveedor (MAX 255; MIN 3). | 53443e9c-dd17-11ec-9d64-0242ac120002 |
ur_key | string | Una combinación de campos que identifica de forma única cada pago en todas las etapas del flujo de pago. | 01027058000191047408760001… |
provider_status | enum | Estado del pago en el proveedor (MAX 255; MIN 3). | SUCCEEDED |
sales_reconciliation_date | date | Fecha en que está programada la conciliación de ventas. | 2026-05-13 |
third_party_transaction_id | string | Identificador de la transacción de un tercero (MAX 255; MIN 3). | TP123456789 |
updated_at | timestamp | Marca de tiempo de la última actualización de la transacción (ISO 8601). | 2026-05-11T11:33:52.000Z |
advancement_amount | decimal | Monto adelantado de la transacción (múltiplo de 0.0001). Es cero cuando no se ha aplicado ningún adelanto. | 0.00 |
card_type | enum | Tipo de tarjeta utilizada. Valores posibles: CREDIT, DEBIT. | CREDIT |
currency | enum | Código de la moneda de la transacción (MAX 3; MIN 3; ISO 4217). | BRL |
transaction_amount | decimal | Monto de la transacción (MAX 10000; MIN 0). | 50.00 |
country | enum | País de la cuenta del comercio (MAX 2; MIN 2; ISO 3166-1). | BR |
created_at | timestamp | Marca de tiempo de la creación de la transacción (ISO 8601). | 2026-05-11T18:33:50.000Z |
merchant_order_id | string | Identificación de la orden (MAX 255; MIN 3). | ORDER-abc123456789 |
merchant_transaction_id | string | Identificación de la transacción asignada por tu empresa (MAX 255; MIN 3). | TXN-987654321 |
provider_confirmation_date | date | Fecha en que el proveedor confirmó la transacción. | 2026-05-12 |
transaction_id | string | El identificador único de la transacción asignado por Yuno (MAX 64; MIN 36). | 9104911d-5df9-429e-8488-ad41abea1a4b |
type_transaction | enum | El 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.Detalles de los campos del reporte de adelantos
Detalles de los campos del reporte de adelantos
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
operation_id | string | Identificador único de la operación de adelanto (pago anticipado) (MAX 64; MIN 36). | 69ad0a39-b769-423c-b223-d7b8bf9a1c2d |
merchant_id | string | Identificador único del comercio (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120002 |
organization_code | string | Identificador único de la organización asociada a la operación (MAX 64; MIN 3). | ORG_ABC_001 |
product_id | string | Identificador único del producto o del acuerdo de cuentas por cobrar vinculado al adelanto (MAX 64; MIN 36). | f4c53557-a832-44e9-94e4-0344f91e9d4f |
ur_key | string | Clave de referencia única que vincula el adelanto con la cuenta por cobrar subyacente (MAX 255; MIN 3). | UR123456789 |
operation_type | enum | Tipo de operación de adelanto. Valores posibles: ADVANCE, REFUND. | ADVANCE |
movement_type | enum | Tipo de movimiento del adelanto. Valores posibles: CREDIT, DEBIT. | CREDIT |
operation_date | date | Fecha en que se procesó la operación de adelanto. | 2026-04-15 |
operation_settlement_date | date | Fecha en que la operación de adelanto se liquidó al comercio. | 2026-04-16 |
ur_operation_date | date | Fecha de la operación UR (cuenta por cobrar) subyacente. | 2026-04-15 |
ur_original_settlement_date | date | Fecha de liquidación originalmente programada dla cuenta por cobrar subyacente, antes del adelanto. | 2026-05-20 |
negotiation_gross_amount | decimal | Monto bruto negociado para el adelanto (múltiplo de 0.0001). | 1000.00 |
negotiation_fees | decimal | Comisiones cobradas por la negociación (múltiplo de 0.0001). | 15.00 |
negotiation_net_amount | decimal | Monto neto después de las comisiones de negociación (múltiplo de 0.0001). | 985.00 |
ur_gross_amount | decimal | Monto bruto de la operación UR subyacente (múltiplo de 0.0001). | 1000.00 |
ur_fees | decimal | Comisiones cobradas por la operación UR (múltiplo de 0.0001). | 10.00 |
ur_net_amount | decimal | Monto neto de la operación UR (múltiplo de 0.0001). | 990.00 |
ur_currency | enum | Moneda utilizada en la operación UR (MAX 3; MIN 3; ISO 4217). | BRL |
acquirer | enum | Nombre del adquirente que procesó el adelanto (MAX 255; MIN 3). | Acquirer ABC |
country | enum | País donde ocurrió la operación de adelanto (MAX 2; MIN 2; ISO 3166-1). | BR |
bank | string | Detalles del banco de la operación de adelanto (MAX 255; MIN 3). | 0237 |
bank_agency | string | Detalles de la agencia bancaria de la operación de adelanto (MAX 255; MIN 3). | 12 |
bank_account | string | Detalles de la cuenta bancaria de la operación de adelanto (MAX 255; MIN 3). | 12345-6 |
settlement_account | string | El identificador único de la cuenta de liquidación que recibió el adelanto (MAX 64; MIN 36). | 64143128-dd12-11ec-9d64-0242ac120002 |