Api de Consulta con Cuotéalo

Usa esta consulta para dar seguimiento a operaciones con Cuotéalo y obtener el estado final después del flujo externo de pago.

endpoint

Este flujo usa la misma estructura general documentada en el Overview de Consulta. Aquí se detalla específicamente el objeto operation.transactions[] para pagos con Cuotéalo.

¿Cuándo usarla?

Seguimiento

Cuando el pago continúa fuera de la sesión principal y aún no tienes estado final.

Segunda validación

Cuando necesitas confirmar desde backend si la operación terminó autorizada, denegada, cancelada o liquidada.

Flujo con redirect

Cuando necesitas consultar continue_url, expiración o reenviar al usuario al flujo de Cuotéalo.

Reconciliación

Cuando necesitas validar el resultado para tu orden o conciliación operativa.

Consideraciones

Conserva merchant_code, merchant_operation_number y transaction_id desde la autorización para consultar sin ambigüedad.

En esta documentación se usa method_details para mantener consistencia con el resto de la referencia. Si en material previo encuentras method_detail, trátalo como el mismo objeto.

Los campos de processor_response para Cuotéalo pueden variar según la procesadora. Tómalos como referenciales.

Response

Objeto operation.transactions[] para pagos con Cuotéalo dentro de la trama de respuesta del API de Consulta.

Objeto `operation.transactions[]`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].transaction_id`	Identificador único de la transacción.	String	SI
`operation.transactions[].channel`	Canal por el cual se realizó la transacción. Valor esperado: `ecommerce`.	String	SI
`operation.transactions[].state`	Estado actual de la transacción. Valores frecuentes: `PENDIENTE`, `CANCELADO`, `INVALIDO`, `AUTORIZADO`, `DENEGADO`, `LIQUIDADO`.	String	SI
`operation.transactions[].state_reason`	Observación o detalle del estado.	String	SI
`operation.transactions[].amount`	Monto de la transacción.	String	SI
`operation.transactions[].currency`	Código de la moneda de la operación.	String	SI
`operation.transactions[].payment_method`	Objeto que contiene información sobre el método de pago usado en la transacción.	Object	SI
`operation.transactions[].payment_method.method_name`	Nombre del método de pago usado en la transacción. Valor esperado: `CUOTEALO`.	String	SI
`operation.transactions[].payment_method.method_details`	Objeto que contiene información detallada relacionada al método.	Object	NO
`operation.transactions[].continue_url`	Visible en estado `PENDIENTE`. URL para continuar el proceso de pago.	String	NO
`operation.transactions[].expiration_date`	Visible en estado `PENDIENTE`. Objeto que contiene la fecha en la que expirará la transacción.	Object	NO
`operation.transactions[].processor_response`	Visible normalmente en estado `AUTORIZADO` o `DENEGADO`. Objeto que contiene el resultado de la autorización.	Object	NO
`operation.transactions[].additional_fields`	Objeto que contiene los datos adicionales de la transacción enviados en la autorización.	Object	NO
`operation.transactions[].lifecycle`	Array que contiene el listado de estados por los cuales pasó la transacción.	Array	SI

Objeto `operation.transactions[].payment_method.method_details`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].payment_method.method_details.redirect_url`	Visible en estado `PENDIENTE`. URL del redirect enviado en la autorización.	String	SI
`operation.transactions[].payment_method.method_details.callback_url`	URL del callback enviado en la autorización.	String	NO

Objeto `operation.transactions[].expiration_date`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].expiration_date.utc_time`	Fecha en UTC.	String	NO
`operation.transactions[].expiration_date.unix_time`	Fecha en Unix time.	Integer	NO

Objeto `operation.transactions[].processor_response`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].processor_response.credit_status`	Estado de la autorización devuelta por la procesadora.	String	NO
`operation.transactions[].processor_response.operation_id`	ID de la operación devuelta por la procesadora.	String	NO

Objeto `operation.transactions[].lifecycle`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].lifecycle[].state`	Estado de la transacción. Valores frecuentes: `REGISTRADO`, `PENDIENTE`, `CANCELADO`, `INVALIDO`, `AUTORIZADO`, `DENEGADO`, `LIQUIDADO`.	String	SI
`operation.transactions[].lifecycle[].date`	Objeto que contiene la fecha en la que se realizó el cambio de estado.	Object	SI

Objeto `operation.transactions[].lifecycle[].date`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].lifecycle[].date.utc_time`	Fecha en UTC.	String	SI
`operation.transactions[].lifecycle[].date.unix_time`	Fecha en Unix time.	Integer	SI

Ejemplo: pendiente

Response de consulta de Cuotéalo con estado PENDIENTE.

{
  "success": true,
  "merchant_code": "abc",
  "operation": {
    "merchant_operation_number": "2391645",
    "state": "PENDIENTE",
    "created_at": {
      "utc_time": "2024-03-12T22:49:36.018Z",
      "unix_time": 1710282940
    },
    "amount": "15000",
    "currency": "604",
    "transactions": [
      {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "channel": "ecommerce",
        "state": "PENDIENTE",
        "state_reason": "Url generada para continuar con el pago",
        "amount": "15000",
        "currency": "604",
        "payment_method": {
          "method_name": "CUOTEALO",
          "method_details": {
            "redirect_url": "https://pay-me.com",
            "callback_url": "https://pay-me.com/callback"
          }
        },
        "continue_url": "https://api.dev.alignet.io/payment/continue/cuotealo/c7dagnrwgxgh1b6kzwirheezv",
        "expiration_date": {
          "utc_time": "2024-03-12T22:49:36.018Z",
          "unix_time": 1710282940
        },
        "processor_response": null,
        "additional_fields": null,
        "lifecycle": [
          {
            "state": "REGISTRADO",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          },
          {
            "state": "PENDIENTE",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "status": {
      "code": "00",
      "message_ilgn": [
        {
          "locale": "es_PE",
          "value": "Se proceso correctamente"
        }
      ]
    }
  }
}

Ejemplo: autorizada

Response de consulta de Cuotéalo con estado AUTORIZADO.

{
  "success": true,
  "merchant_code": "abc",
  "operation": {
    "merchant_operation_number": "2391645",
    "state": "AUTORIZADO",
    "amount": "15000",
    "currency": "604",
    "transactions": [
      {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "channel": "ecommerce",
        "state": "AUTORIZADO",
        "state_reason": "Pago Exitoso",
        "amount": "15000",
        "currency": "604",
        "payment_method": {
          "method_name": "CUOTEALO",
          "method_details": {
            "redirect_url": "https://pay-me.com",
            "callback_url": "https://pay-me.com/callback"
          }
        },
        "continue_url": null,
        "expiration_date": null,
        "processor_response": {
          "credit_status": "APPROVED",
          "operation_id": "ABC123_ABC123"
        },
        "additional_fields": null,
        "lifecycle": [
          {
            "state": "REGISTRADO",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          },
          {
            "state": "PENDIENTE",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          },
          {
            "state": "AUTORIZADO",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "status": {
      "code": "00",
      "message_ilgn": [
        {
          "locale": "es_PE",
          "value": "Se proceso correctamente"
        }
      ]
    }
  }
}

Siguiente paso

API de Cancelación

Si corresponde por estado y negocio, revisa la cancelación de la operación.

Primeros pasos

Integración

Pagos

Gestión y Operaciones

¿Cuándo usarla?

Seguimiento

Segunda validación

Flujo con redirect

Reconciliación

Consideraciones

Response

Objeto `operation.transactions[]`

Objeto `operation.transactions[].payment_method.method_details`

Objeto `operation.transactions[].expiration_date`

Objeto `operation.transactions[].processor_response`

Objeto `operation.transactions[].lifecycle`

Objeto `operation.transactions[].lifecycle[].date`

Ejemplo: pendiente

Ejemplo: autorizada

Siguiente paso

API de Cancelación

​¿Cuándo usarla?

Seguimiento

Segunda validación

Flujo con redirect

Reconciliación

​Consideraciones

​Response

​Objeto operation.transactions[]

​Objeto operation.transactions[].payment_method.method_details

​Objeto operation.transactions[].expiration_date

​Objeto operation.transactions[].processor_response

​Objeto operation.transactions[].lifecycle

​Objeto operation.transactions[].lifecycle[].date

​Ejemplo: pendiente

​Ejemplo: autorizada

​Siguiente paso

API de Cancelación

¿Cuándo usarla?

Consideraciones

Response

Objeto `operation.transactions[]`

Objeto `operation.transactions[].payment_method.method_details`

Objeto `operation.transactions[].expiration_date`

Objeto `operation.transactions[].processor_response`

Objeto `operation.transactions[].lifecycle`

Objeto `operation.transactions[].lifecycle[].date`

Ejemplo: pendiente

Ejemplo: autorizada

Siguiente paso