{"section":"tutorials","requestedLocale":"es","requestedSlug":"pagos","locale":"es","slug":"pagos","path":"docs/es/tutorials/beta/vtex-data-pipeline-beta/pagos.md","branch":"main","content":"El conjunto de datos de pagos se compone de dos tablas principales: `payments_transitions` y `transaction_transitions`.\n\nEn esta sección puedes consultar la siguiente información:\n\n- [Características de los datos de pagos](#caracteristicas-de-los-datos)\n- [Tabla payments_transitions](#tabla-payments_transitions)\n- [Tabla transaction_transitions](#tabla-transaction_transitions)\n- [Tabla transactions_interactions](#tabla-transactions_interactions)\n- [Tabla authorizations_consolidated](#tabla-authorizations_consolidated)\n- [Tabla transaction_consolidation](#tabla-transaction-consolidation)\n- [Análisis con datos de pagos](#analisis-con-datos-de-pagos)\n- [Correlaciones con otros datos](#correlaciones-con-otros-datos)\n\n## Características de los datos\n\n|**Característica**|**Descripción**|\n| - | - |\n|**Origen**|Los datos de este conjunto proceden del [módulo Pagos de VTEX](/es/docs/tracks/como-funciona-el-modulo-de-pagos). Se recopilan y organizan para reflejar las transacciones y pagos realizados en la plataforma.|\n|**Disponibilidad**|Solo se puede acceder a los datos de navegación en el Admin VTEX.|\n|**Historial**|Los datos se conservan durante dos años, a partir de 2023 para clientes que ya utilizan la plataforma VTEX. Los datos en la tabla `transaction_interactions` solo tienen historial desde el 07/05/24 (dd/mm/aa).|\n|**Intervalo mínimo de actualización**|Una hora.|\n\n## Tabla payments_transitions\n\nLa tabla `payments_transitions` almacena información detallada sobre los pagos, incluido el proveedor y el medio de pago utilizados en cada transacción.  \nConsulta a continuación los campos que componen la tabla:\n\n| **Nombre de la columna** | **Tipo de la columna** | **Descripción de la columna** |\n|:---:|:---:|---|\n| **batch_id** | character varying(13) | ID de control del lote de ingesta de datos. |\n| **event_date_time** | timestamp with time zone | Fecha y hora de la transición, con información sobre la zona horaria. |\n| **account** | character varying(128) | Nombre de cuenta, mapeado a 'account_name' en VTEX License Manager. |\n| **account_id** | character varying(36) | Identificador de la cuenta, mapeado a 'id' en VTEX License Manager tras eliminar los guiones. |\n| **connector** | character varying(1024) | Proveedor que procesa el pago. |\n| **delta_value** | double precision | Tiempo en milisegundos empleado en la transición 'from_transition'. |\n| **from_transition** | character varying(64) | Status del pago hasta la fecha y hora del evento. |\n| **to_transition** | character varying(64) | Nuevo status de la transacción a partir de la fecha y hora del evento. |\n| **payment_id** | character varying(32) | Identificador único de pago. |\n| **payment_system** | character varying(1024) | Tipo de pago: tarjeta de crédito, débito, etc. |\n| **transaction_id** | character varying(36) | Identificador único de la transacción a la que pertenece este pago. |\n| **tid** | character varying(1024) | Código externo proporcionado por el operador, que funciona como número de identificación para una transacción de ecommerce. |\n| **nsu** | character varying(1024) | NSU (Número Sequencial Único) es un número secuencial único utilizado en Brasil para identificar una transacción de venta con tarjeta y está asociado a cada factura creada. |\n| **currency_code** | character varying(1024) | Código de moneda representado por tres letras mayúsculas. |\n| **value** | integer | Valor del pago multiplicado por 100, lo que significa que para un pago de $2.35 el valor será 235. |  \n\n## Tabla transaction_transitions\n\nLa tabla `transaction_transitions` almacena las transacciones vinculadas a pedidos realizados. Cada transacción contiene un conjunto de pagos y cambia de status conforme a un flujo predefinido.  \nConsulta a continuación los campos que componen la tabla:  \n\n| **Nombre de la columna** | **Tipo de la columna** | **Descripción de la columna** |\n|:---:|:---:|---|\n| **batch_id** | character varying(13) | ID de control del lote de ingesta de datos. |\n| **event_date_time** | timestamp with time zone | Fecha y hora de la transición, con información sobre la zona horaria. |\n| **account** | character varying(128) | Mapea a un 'account_name' en el sistema de gestión de licencias de VTEX. |\n| **account_id** | character varying(36) | Mapea a un 'id' en el sistema de gestión de licencias de VTEX tras eliminar los guiones. |\n| **delta_value** | double precision | Tiempo en milisegundos empleado en la transición 'from_transition'. |\n| **from_transition** | character varying(64) | Status de la transacción hasta la fecha y hora del evento. |\n| **to_transition** | character varying(64) | Nuevo status de la transacción a partir de la fecha y hora del evento. |\n| **transaction_id** | character varying(36) | Identificador único de la transacción. |  \n\n## Tabla transactions_interactions\n\nEsta tabla registra las actualizaciones de las transacciones a través de diversas interacciones. A continuación, se incluye una descripción detallada de cada campo:\n\n| **Nombre de la Columna** |**Tipo de la columna** | **Descripción de la columna** |\n|:----------:|:-----------:|-------------|\n| key_id | character varying(35) | Identificador único de la interacción. Representa el ID de la interacción. |\n| key_transaction_id | character varying(35) | Identificador único de la transacción relacionada. |\n| payment_id | character varying(120) | Identificador único del pago. Este campo **no es obligatorio**. |\n| source | character varying(120) | Indica el origen de la actualización de la interacción. Puede ser un nombre de función o regla de negocio. **Obligatorio**. |\n| status | character varying(60) | Representa el estado actualizado de la transacción. Este campo es **obligatorio**. |\n| date | timestamp without time zone | Fecha y hora en que ocurrió la transacción. Este campo es **obligatorio**. |\n| message | character varying(65535) | Información detallada sobre la actualización de la transacción. Este campo es **no estructurado** y **obligatorio**. |\n| ticks | character varying(60) | Identificador único del \"tick\" del pago. Este campo es **obligatorio**. |\n| batch_id | character varying(13) | Indica la fecha y hora en que se procesó el job que ingirió los datos. Formato: `YYYY_MM_DD_hh`. |\n| account | character varying(60) | Nombre de la cuenta asociada a la transacción. Este campo es **obligatorio**. |\n\n## Tabla authorizations_consolidated\n\nEsta tabla consolida los detalles sobre las autorizaciones de pago, el seguimiento de la información clave sobre cada transacción, incluida la evaluación de riesgos, los detalles de pago y el control de la ingesta. A continuación, se incluye una descripción de cada campo:\n\n| **Nombre de la Columna** | **Tipo de la columna** | **Descripción de la columna** |\n|:---------:|:----------:|-------------|\n| account | character varying(63) | Nombre de la cuenta asociada a la transacción. Siempre será igual a `merchant_name`. |\n| merchant_name | character varying(63) | Nombre del comerciante donde ocurrió la transacción. Siempre será igual a `account`. |\n| transaction_start_date | timestamp with time zone | Fecha y hora en que se realizó la autorización, incluida la información de la zona horaria. |\n| connector | character varying(80) | Nombre del conector de pago involucrado en la transacción (por ejemplo, gateway de pago). |\n| payment_id | character varying(255) | Identificador único del pago. |\n| payment_system | character varying(255) | Tipo de pago utilizado en la transacción (por ejemplo, tarjeta de crédito, tarjeta de débito, etc.). |\n| transaction_id | character varying(63) | Identificador único de la transacción a la que pertenece este pago. |\n| currency | character varying(4) | Código de la moneda representado por tres letras mayúsculas (por ejemplo, USD, EUR). |\n| payment_value | double precision | Valor del pago multiplicado por 100. Por ejemplo, un pago de $2,35 se almacenará como 235. |\n| authorized | boolean | Indica si la transacción fue autorizada (`true`) o no (`false`). |\n| installments | integer | Número de cuotas en que se está pagando la transacción. |\n| recipients_count | integer | Número de destinatarios involucrados en la transacción (por ejemplo, pagos divididos entre varios comerciantes). |\n| risk_level | character varying(100) | Nivel de riesgo asociado a la transacción (por ejemplo, \"bajo\", \"medio\", \"alto\"). |\n| return_code | character varying(255) | Código de retorno proporcionado por el proveedor de pagos, generalmente indicando el motivo del rechazo. |\n| affiliation_id | character varying(37) | Identificador único de la afiliación asociada a la transacción. |\n| antifraud_affiliation_id | character varying(37) | Identificador único de la afiliación antifraude asociada a la transacción. |\n| ingestion_time | timestamp with time zone | Fecha y hora en que se insertó la fila en la tabla. |\n| batch_id | character varying(13) | Identificador de control del lote de ingestión de datos, generalmente en formato `YYYY_MM_DD_hh`. |\n\n## Tabla transaction_consolidation\n\nEsta tabla contiene los metadatos de transacciones de pago, incluyendo información detallada sobre valores, estados, afiliaciones, conectores de pago, análisis antifraude, cuotas y datos de origen.\n\n| **Nombre de la Columna** | **Tipo de la columna**| **Descripción de la columna** |\n|:-------:|:------:|-----|\n| id | character varying(65535) | ID único de la transacción a la que pertenece este pago. |\n| transaction_value | double precision  | Valor del pago en formato decimal. |\n| status_transaction | character varying(65535) | Último estado de la transacción. |\n| reference_key | character varying(65535)| Identificador interno utilizado para conciliación o como referencia de transacción. Este campo es enviado por Checkout al solicitar la creación de la transacción. |\n| merchant_name  | character varying(65535) | Nombre de la cuenta que incluye: cuenta principal, subcuentas, cuentas hijas, etc. |\n| account_name  | character varying(16383) | Nombre de la cuenta que incluye: cuenta principal, subcuentas, cuentas hijas, etc. |\n| main_account_name | character varying(16383)| Nombre de la cuenta principal. |\n| is_active  | boolean  | Indica si la transacción fue autorizada o no. |\n| is_operating  | boolean   | Indica si la cuenta o el conector estaba operando en el momento de la transacción. |\n| recipients_count  | integer | Número de repartos: cantidad de vendedores que recibieron el pago, incluyendo la cuenta principal. |\n| date  | date | Última fecha de la transacción. |\n| account_verification_only     | boolean  | Indica si la transacción fue solo para verificar la cuenta o método de pago, sin valor monetario real. |\n| payment_id   | character varying(65535)  | ID único del pago. |\n| value_payment  | double precision  | Valor monetario del primer pago asociado a la transacción. |\n| status_payment | character varying(65535) | Estado final del primer pago (ej: aprobado, cancelado). |\n| currency_code | character varying(65535)| Código de moneda de tres letras en mayúscula. |\n| connector_name | character varying(65535) | Nombre del conector que procesa el pago. |\n| affiliation_id | character varying(65535) | ID de la afiliación del conector de pago configurado para una cuenta específica. |\n| affiliation_name | character varying(65535)| Nombre descriptivo de la afiliación del conector utilizada en el primer pago. |\n| is_legacy_connector| boolean | Indica si el conector es legado. |\n| payment_system | integer   | Código numérico del tipo de pago (ej: 1, 2, 3...). |\n| installments | integer  | Número de cuotas. |\n| payment_system_name | character varying(65535)| Tipo de pago (ej: tarjeta de crédito, débito, etc.). |\n| return_code | character varying(65535) | Código de retorno proporcionado por el conector. |\n| antifraud_affiliation_id | character varying(65535) | Identificador de la instancia del servicio antifraude asociada al primer pago. |\n| antifraud_affiliation_name    | character varying(65535)  | Nombre descriptivo de la afiliación del servicio antifraude. |\n| antifraud_provider_name | character varying(65535)  | Nombre del proveedor del servicio antifraude. |\n| antifraud_analysis_result | character varying(65535) | Resultado del análisis antifraude. |\n| pan_type  | character varying(65535) | Tipo de tarjeta utilizada (ej: crédito, débito, prepaga). |\n| payment_origin | character varying(65535)  | Origen o canal del pago (ej: tienda física, sitio web, app). |\n| is_3ds_required | boolean   | Indica si el pago requirió autenticación 3D Secure. |\n| payment_id_2 | character varying(65535)| ID del segundo pago (si aplica). |\n| value_payment_2  | double precision | Valor del segundo pago (si aplica). |\n| status_payment_2  | character varying(65535)| Estado final del segundo pago (ej: aprobado, cancelado). |\n| currency_code_2  | character varying(65535) | Código de moneda del segundo pago. |\n| connector_name_2  | character varying(65535) | Nombre del conector del segundo pago. |\n| affiliation_id_2 | character varying(65535) | ID de afiliación del conector del segundo pago. |\n| affiliation_name_2  | character varying(65535) | Nombre de la afiliación usada en el segundo pago. |\n| is_legacy_connector_2  | boolean   | Indica si el segundo conector es legado. |\n| installments_2   | integer   | Número de cuotas del segundo pago. |\n| payment_system_2  | integer   | Código del método de pago del segundo pago. |\n| payment_system_name_2 | character varying(65535) | Nombre del método de pago usado en el segundo pago. |\n| return_code_2 | character varying(65535)| Código de retorno del segundo pago. |\n| antifraud_affiliation_id_2    | character varying(65535)| ID de afiliación antifraude del segundo pago. |\n| antifraud_affiliation_name_2  | character varying(65535)| Nombre de la afiliación antifraude usada en el segundo pago. |\n| antifraud_provider_name_2     | character varying(65535)| Nombre del proveedor antifraude del segundo pago. |\n| antifraud_analysis_result_2   | character varying(65535)| Resultado del análisis antifraude del segundo pago. |\n| pan_type_2 | character varying(65535)| Tipo de tarjeta usada en el segundo pago. |\n| payment_origin_2  | character varying(65535)| Origen del segundo pago (ej: tienda, app, web). |\n| is_3ds_required_2   | boolean  | Indica si el segundo pago requirió autenticación 3D Secure. |\n| transaction_value_usd | double precision | Valor de la transacción en dólares (FX Neutral). |\n| value_payment_usd  | double precision | Valor del primer pago en dólares (FX Neutral). |\n| value_payment_2_usd | double precision | Valor del segundo pago en dólares (FX Neutral). |\n| batch_id  | character varying(13)| ID de control del lote de ingestión de datos. |\n\n## Análisis con datos de pagos\n\nEl conjunto de datos de pagos puede utilizarse para llevar a cabo los siguientes análisis:  \n\n- **Análisis de eficiencia del procesador de pago:** evaluar el rendimiento de distintos proveedores de pago mediante el análisis del tiempo promedio empleado en cada transición para identificar los más eficientes y confiables.  \n- **Monitoreo de las transiciones del status de los pagos:** seguimiento de los cambios de status de los pagos a lo largo del tiempo para comprender patrones e identificar posibles problemas en el flujo de pagos.  \n- **Análisis del volumen de transacciones por cuenta:** determinar el volumen de transacciones procesadas por cada cuenta, lo que ayuda a comprender la demanda de servicios de pago en las distintas cuentas.  \n- **Distribución del tipo de pago:** analiza la distribución del uso de diferentes sistemas de pago para evaluar las preferencias de los clientes por los distintos medios de pago.  \n\n## Correlaciones con otros datos\n\nLos datos de pago de la plataforma VTEX muestran correlaciones con otros conjuntos de datos, ampliando la comprensión del ciclo de compra:\n\n- **Interacción con datos de [pedidos](/es/docs/tutorials/pedidos-data-pipeline-beta):** el análisis conjunto de los datos de pago y los pedidos proporciona información sobre cómo influyen los medios de pago en las conversiones de pedidos, revelando tendencias en el comportamiento de compra de los clientes.  \n- **Análisis financieros y contables:** integrar datos de pago con análisis financieros contribuye a una gestión más eficiente del flujo de caja y permite realizar previsiones financieras más precisas, impulsando la salud financiera de la empresa.  \n\n### Descubra otros conjuntos de datos\n\n- [Catálogo](/es/docs/tutorials/catalogo-data-pipeline)\n- [Stock](/es/docs/tutorials/stock-data-pipeline-beta) \n- [Navegación](/es/docs/tutorials/navegacion-data-pipeline)   \n- [Pedidos](/es/docs/tutorials/pedidos-data-pipeline-beta) \n- [Precios](/es/docs/tutorials/precios-data-pipeline-beta)  \n- [Promociones](/es/docs/tutorials/promociones)\n- [Tarjeta de regalo](/es/docs/tutorials/tarjeta-de-regalo-data-pipeline)\n- [Registro del Bridge](/es/docs/tutorials/registros-del-bridge-data-pipeline)"}