> ## 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.

# Estados y códigos de respuesta del pago

> Lista los estados de los pagos, los subestados y sus correspondientes estados de transacción y descripciones.

Los pagos contienen toda la información esencial del pedido, incluida la información del cliente, el monto, la moneda, los artículos, los datos de envío, etc. Siempre puedes consultar los detalles de la transacción para obtener más información sobre el pedido y las interacciones del pago.

<video src="https://docs.y.uno/videos/explainers/payment-status-lifecycle.mp4" poster="/videos/explainers/payment-status-lifecycle.jpg" controls preload="none" playsInline aria-label="Ciclo de vida del estado del pago" />

Video: Ciclo de vida del estado del pago (68 s, subtítulos en pantalla, sin voz en off)

## Flujo de trabajo

En el siguiente flujo de trabajo, puedes ver los diferentes estados del pago y cómo se pueden actualizar.

![](https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/payment/image1.png?fit=max\&auto=format\&n=MTlogjS0_SlxtlJG\&q=85\&s=ce5c7b804a23b9511ad5f3f4e7d266bc)

Para cada implementación, recomendamos tomar el `status` y el `sub_status` del pago como la referencia principal del estado del pago. Un pago puede tener diferentes [transacciones](https://docs.y.uno/es/reference/payments/status-and-response-codes/transaction.md) asociadas. Al enfocarte en el `status` / `sub_status` del pago, obtienes el estado más reciente sin importar cuántas transacciones se hayan realizado, lo que te da información clara para tomar decisiones.

## Estados de los pagos

Los pagos pueden tener los siguientes estados y subestados.

<table>
  <thead>
    <tr>
      <th>Estado</th>
      <th>Subestado</th>
      <th>Transacción\
      tipo · estado</th>
      <th>Descripción</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        CREATED
      </td>

      <td>
        CREATED
      </td>

      <td />

      <td>Estado inicial al momento de crear un pago.</td>
    </tr>

    <tr>
      <td>
        READY\_TO\_PAY
      </td>

      <td>
        CREATED
      </td>

      <td>Purchase · Created</td>
      <td>Estado inicial al momento de crear un pago. En espera de una acción del cliente</td>
    </tr>

    <tr>
      <td rowspan="8">
        PENDING
      </td>

      <td>
        AUTHORIZED
      </td>

      <td>Authorize · Succeeded</td>
      <td>Autorizaciones de tarjeta</td>
    </tr>

    <tr>
      <td>
        IN\_PROCESS
      </td>

      <td>Purchase · Created</td>
      <td>El cliente fue redirigido al proveedor y estamos esperando la finalización del pago.</td>
    </tr>

    <tr>
      <td rowspan="2">
        WAITING\_ADDITIONAL\_STEP
      </td>

      <td>Purchase · Pending</td>
      <td>3DS/Segundo factor</td>
    </tr>

    <tr>
      <td>Authorize · Pending</td>
      <td>3DS/Segundo factor para el flujo de autorización</td>
    </tr>

    <tr>
      <td>
        PENDING\_PROVIDER\_CONFIRMATION
      </td>

      <td>Purchase · Pending</td>
      <td>En espera de la confirmación del pago por parte de los proveedores.</td>
    </tr>

    <tr>
      <td>
        PENDING\_FRAUD\_REVIEW
      </td>

      <td>Fraud · Pending</td>
      <td>La transacción está siendo analizada por el proveedor de fraude</td>
    </tr>

    <tr>
      <td>
        PENDING\_OTP\_COMPLETION
      </td>

      <td>Purchase · Pending</td>
      <td>Estado inicial al crear el pago</td>
    </tr>

    <tr>
      <td>
        WAITING\_FOR\_ENROLLMENT
      </td>

      <td />

      <td>El pago espera a que el cliente termine de inscribir el método de pago, por ejemplo una aprobación de vault de PayPal o un opt-in de Boku.</td>
    </tr>

    <tr>
      <td rowspan="2">
        EXPIRED
      </td>

      <td rowspan="2">
        EXPIRED
      </td>

      <td>Purchase · Expired</td>
      <td>El método de pago offline alcanza su fecha de vencimiento.</td>
    </tr>

    <tr>
      <td>Authorize · Expired</td>
      <td>La autorización vence</td>
    </tr>

    <tr>
      <td rowspan="3">
        REJECTED
      </td>

      <td rowspan="2">
        REJECTED
      </td>

      <td>Purchase · Rejected</td>
      <td>Rechazado por Yuno</td>
    </tr>

    <tr>
      <td>Capture · Error</td>
      <td>Rechazo de la captura por Yuno</td>
    </tr>

    <tr>
      <td>
        ENROLLMENT\_ERROR
      </td>

      <td />

      <td>La inscripción del método de pago vinculada a este pago falló con un error.</td>
    </tr>

    <tr>
      <td rowspan="6">
        DECLINED
      </td>

      <td rowspan="2">
        DECLINED
      </td>

      <td>Purchase · Declined</td>
      <td>Rechazo del proveedor</td>
    </tr>

    <tr>
      <td>Capture · Declined</td>
      <td>Rechazo de la captura por el proveedor</td>
    </tr>

    <tr>
      <td>
        FRAUD\_DECLINED
      </td>

      <td>Fraud screening · Declined</td>
      <td>Validación de fraude rechazada</td>
    </tr>

    <tr>
      <td>
        REFUND\_RETRY\_IN\_PROCESS
      </td>

      <td>Refund · Declined</td>
      <td>Pago con dos tarjetas: una tarjeta falló y el reembolso de la otra tarjeta también falló. Yuno reintenta el reembolso automáticamente.</td>
    </tr>

    <tr>
      <td>
        CANCEL\_RETRY\_IN\_PROCESS
      </td>

      <td>Cancel · Declined</td>
      <td>Pago con dos tarjetas: una tarjeta falló y la cancelación de la otra tarjeta también falló. Yuno reintenta la cancelación automáticamente.</td>
    </tr>

    <tr>
      <td>
        ENROLLMENT\_DECLINED
      </td>

      <td />

      <td>La inscripción del método de pago vinculada a este pago fue rechazada.</td>
    </tr>

    <tr>
      <td rowspan="15">
        SUCCEEDED
      </td>

      <td>
        PARTIALLY\_APPROVED
      </td>

      <td>Purchase · Succeeded</td>
      <td>Pago parcial (pago con 2 tarjetas)</td>
    </tr>

    <tr>
      <td>
        VERIFIED
      </td>

      <td>Verify · Succeeded</td>
      <td>Autorizaciones de tarjeta con monto cero</td>
    </tr>

    <tr>
      <td>
        APPROVED
      </td>

      <td>Purchase · Succeeded</td>
      <td>Pago exitoso</td>
    </tr>

    <tr>
      <td>
        CAPTURED
      </td>

      <td>Capture · Succeeded</td>
      <td>Captura exitosa</td>
    </tr>

    <tr>
      <td rowspan="3">
        PARTIALLY\_CAPTURED
      </td>

      <td>Capture · Succeeded</td>
      <td>Captura parcial exitosa</td>
    </tr>

    <tr>
      <td>Refund · Error/Declined</td>
      <td>Sigue aprobado debido a un error en el reembolso / la cancelación</td>
    </tr>

    <tr>
      <td>Chargeback · Error/Declined</td>
      <td>Sigue aprobado debido al rechazo en el contracargo</td>
    </tr>

    <tr>
      <td>
        PARTIALLY\_REFUNDED
      </td>

      <td>Refund · Succeeded</td>
      <td>Reembolso parcial exitoso</td>
    </tr>

    <tr>
      <td>
        PARTIALLY\_CHARGEBACKED
      </td>

      <td>Chargeback · Succeeded</td>
      <td>Contracargo parcial exitoso</td>
    </tr>

    <tr>
      <td>
        FRAUD\_DECLINED
      </td>

      <td>Fraud screening · Declined</td>
      <td>Validación de fraude rechazada. Puede ocurrir antes o después de la autorización del proveedor. El pago fue exitoso y los fondos se movieron.</td>
    </tr>

    <tr>
      <td>
        REFUND\_RETRY\_IN\_PROCESS
      </td>

      <td>Refund · Declined</td>
      <td>La transacción fue rechazada y está en espera de reintento.</td>
    </tr>

    <tr>
      <td>
        CAPTURE\_RETRY\_IN\_PROCESS
      </td>

      <td>Capture · Declined</td>
      <td>La transacción fue rechazada y está en espera de reintento.</td>
    </tr>

    <tr>
      <td>
        CAPTURE\_RETRY\_PROCESS\_FAILED
      </td>

      <td>Capture · Declined</td>
      <td>La transacción fue rechazada y el esquema de reintentos finalizó.</td>
    </tr>

    <tr>
      <td>
        THREE\_D\_SECURE\_VERIFIED
      </td>

      <td>Three D Secure · Succeeded</td>
      <td>La autenticación 3DS fue exitosa en un flujo de [3DS standalone](https://docs.y.uno/es/docs/payment-features/3ds-standalone.md).</td>
    </tr>

    <tr>
      <td>
        TRANSFER\_REVERSED
      </td>

      <td>Split transfer reversal · Succeeded</td>
      <td>Se revirtió una transferencia dividida de marketplace. El pago conserva este subestado si luego pasa a un estado de contracargo.</td>
    </tr>

    <tr>
      <td rowspan="2">
        REFUNDED
      </td>

      <td>
        PENDING\_PROVIDER\_CONFIRMATION
      </td>

      <td>Refund · Pending</td>
      <td>Reembolso pendiente</td>
    </tr>

    <tr>
      <td>
        REFUNDED
      </td>

      <td>Refund · Succeeded</td>
      <td>Reembolso exitoso</td>
    </tr>

    <tr>
      <td rowspan="2">
        CANCELED
      </td>

      <td>
        PENDING\_PROVIDER\_CONFIRMATION
      </td>

      <td>Cancel · Pending</td>
      <td>Cancelación pendiente</td>
    </tr>

    <tr>
      <td>
        CANCELED
      </td>

      <td>Cancel · Succeeded</td>
      <td>Cancelación exitosa</td>
    </tr>

    <tr>
      <td rowspan="2">
        IN\_DISPUTE
      </td>

      <td>
        RECEIVED
      </td>

      <td>Chargeback · Created</td>
      <td>Contracargo o consulta recibidos. Se debe proporcionar una decisión o documentación</td>
    </tr>

    <tr>
      <td>
        PENDING\_REVIEW
      </td>

      <td>Chargeback · Pending</td>
      <td>In\_review</td>
    </tr>

    <tr>
      <td rowspan="1">
        CHARGEBACK
      </td>

      <td>
        LOST
      </td>

      <td>Chargeback · Prevented</td>
      <td>Predisputa desviada por el proveedor o la red. El pago refleja fondos perdidos.</td>
    </tr>

    <tr>
      <td rowspan="4">
        ERROR
      </td>

      <td>
        ERROR
      </td>

      <td />

      <td>Ejemplo: timeout.</td>
    </tr>

    <tr>
      <td>
        TIMEOUT
      </td>

      <td />

      <td />
    </tr>

    <tr>
      <td>
        PENDING\_REVERSE
      </td>

      <td />

      <td />
    </tr>

    <tr>
      <td>
        REVERSED\_BY\_TIMEOUT
      </td>

      <td />

      <td />
    </tr>

    <tr>
      <td rowspan="1">
        FRAUD\_VERIFIED
      </td>

      <td>
        FRAUD\_SCREENING\_VERIFIED
      </td>

      <td>Fraud · Succeeded</td>
      <td>Transacción verificada por el proveedor de fraude durante la verificación de fraude independiente</td>
    </tr>
  </tbody>
</table>

> [!NOTE]
>
> `PREVENTED` es un estado de transacción solo para `type = CHARGEBACK` cuando el proveedor o la red informa una [desviación de predisputa](https://docs.y.uno/es/docs/payouts-and-disputes/chargeback-management.md). En estos casos, solo se envía el webhook de contracargo; no se emite ningún webhook de reembolso.
>
> `REVIEW_WON` es un estado de transacción solo de contracargo. Cuando se gana un contracargo, el pago vuelve a su estado anterior (por ejemplo, `SUCCEEDED` / `APPROVED`) y no se emite ningún nuevo estado de pago.

### Pagos con dos tarjetas

Un pago financiado con dos tarjetas (`POST /v2/payments`) tiene un solo `status` y `sub_status` que resumen ambas tarjetas; una tarjeta no tiene un estado propio. Se aplica la primera regla que coincida: un rechazo por fraude en cualquier tarjeta da `DECLINED` / `FRAUD_DECLINED`; ambas tarjetas rechazadas dan `REJECTED`; cualquier tarjeta rechazada da `DECLINED`; luego `ERROR`, `EXPIRED`, `PENDING` (`PENDING_FRAUD_REVIEW`, `WAITING_ADDITIONAL_STEP`, `AUTHORIZED`) y `SUCCEEDED` (`APPROVED`, `CAPTURED`, `PARTIALLY_CAPTURED`, `PARTIALLY_REFUNDED`). Si ambas tarjetas se reembolsan, el resultado es `REFUNDED`, y un contracargo abierto en una tarjeta da `IN_DISPUTE`. Cuando una tarjeta falla y la reversión de la otra tarjeta también falla, el pago permanece en `DECLINED` con `REFUND_RETRY_IN_PROCESS` o `CANCEL_RETRY_IN_PROCESS` mientras Yuno reintenta. Consulta [Pagar con dos tarjetas](https://docs.y.uno/es/docs/payment-features/pay-with-two-cards.md#statuses).

### Estados posibles para flujos síncronos y asíncronos

Usa el diagrama que corresponda a tu tipo de integración para entender qué estados y transiciones del pago esperar.

#### Flujo síncrono

En un flujo síncrono, el pago pasa de `CREATED` directamente a un estado final (como `SUCCEEDED`, `DECLINED` o `REJECTED`) dentro de la misma respuesta de la API. No hay una fase intermedia `PENDING`. `ERROR` es transversal y puede ocurrir en cualquier punto del flujo.

![](https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/payment/image2.png?fit=max\&auto=format\&n=MTlogjS0_SlxtlJG\&q=85\&s=f94d959aaab6834828925c985c49c88b)

#### Flujo asíncrono

En un flujo asíncrono, el pago pasa por una fase `PENDING` después de su creación antes de llegar a un estado final. Durante esta fase, subestados como `IN_PROCESS`, `AUTHORIZED` y `WAITING_ADDITIONAL_STEP` reflejan el procesamiento en curso. El estado final se entrega mediante webhook cuando el procesamiento termina. Los pagos iniciados mediante APM asíncronos directos también pueden entrar en un estado `READY_TO_PAY`, que puede pasar a `EXPIRED` si no se completa. `ERROR` es transversal y puede ocurrir en cualquier punto del flujo.

![](https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/payment/image3.png?fit=max\&auto=format\&n=MTlogjS0_SlxtlJG\&q=85\&s=d0c3713ffcd18b0bd8557396ef774065)


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