> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Transacciones

> Explica los tipos de transacciones primarias y secundarias y sus estados dentro de un pago de Yuno.

## ¿Qué es una transacción?

Cada pago tiene una o más transacciones asociadas. Un pago en Yuno puede pasar por varios procesadores mediante alternativas de respaldo, reintentos o enrutamiento dividido. Cada uno de estos recorridos puede agregar varias transacciones al pago. Puedes consultar todas las transacciones relacionadas con un pago en la [línea de tiempo del pago](https://docs.y.uno/docs/using-yuno/dashboard-overview/payments.md) del Dashboard de Yuno.

En Yuno, las transacciones se dividen en transacciones **primarias** y **secundarias**. Además, cada transacción puede tener un estado distinto según su etapa de procesamiento.

## Tipos y estados de las transacciones

### Transacciones primarias

Las transacciones primarias inician un pago y pueden ser de uno de tres tipos:

* **Purchase**: una transacción de venta estándar.
* **Authorize**: una transacción que se usa para autorizar el monto de un pago que se capturará más adelante.
* **Verify**: una transacción para verificar si el cliente usa un método de pago válido.

### Transacciones secundarias

Las transacciones secundarias son transacciones adicionales que afectan el resultado final del pago y de la transacción primaria. Las transacciones secundarias pueden ser:

* **Refund**: un reembolso de la transacción inicial, que puede ser total o parcial.
* **Cancel**: una cancelación de una autorización inicial.
* **Capture**: una captura de fondos de una transacción de autorización inicial, que puede ser total o parcial.
* **Chargeback**: una disputa iniciada por el cliente sobre la transacción inicial.
* **3DS**: una verificación 3D Secure (3DS) de una transacción inicial.
* **Fraud screening**: una verificación de fraude de una transacción inicial. Se representan como `FRAUD_SCREENING` en la respuesta de tus pagos.
* **Marketplace transfers**: transferencias independientes dentro de un Marketplace, representadas como `SPLIT_TRANSFER` para transferencias directas y `SPLIT_TRANSFER_REVERSE` para reversos independientes. Las transferencias vinculadas a una transacción de pago también se pueden revertir y se representan como `SPLIT_TRANSFER_REVERSAL`.

A continuación se presentan todos los estados posibles de cada tipo de transacción.

![Diagrama de todos los estados posibles de cada tipo de transacción](https://mintcdn.com/yuno-3979e326/OXm4Cjavq6YgX3ks/images/reference/transactions/image1.png?fit=max\&auto=format\&n=OXm4Cjavq6YgX3ks\&q=85\&s=d6871f086461dfd5c420dc58a25d7894)

Consulta la [referencia de la API de transacciones](https://docs.y.uno/reference/payments/status-and-response-codes/transaction.md) para obtener información más detallada sobre los códigos y mensajes de estado de las transacciones.

La sección [Payments](https://docs.y.uno/docs/using-yuno/dashboard-overview/payments.md) del Dashboard de Yuno te permite ver tus pagos y transacciones. Desde allí también puedes exportar esta información.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.