Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pay-me.com/llms.txt

Use this file to discover all available pages before exploring further.

Usa esta consulta para dar seguimiento a operaciones con Cuotéalo y obtener el estado final después del flujo externo de pago.
​
GET /charges/{merchant_code}/{merchant_operation_number}/{transaction_id}
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[]

CampoDescripciónTipoObligatorio
operation.transactions[].transaction_idIdentificador único de la transacción.StringSI
operation.transactions[].channelCanal por el cual se realizó la transacción. Valor esperado: ecommerce.StringSI
operation.transactions[].stateEstado actual de la transacción. Valores frecuentes: PENDIENTE, CANCELADO, INVALIDO, AUTORIZADO, DENEGADO, LIQUIDADO.StringSI
operation.transactions[].state_reasonObservación o detalle del estado.StringSI
operation.transactions[].amountMonto de la transacción.StringSI
operation.transactions[].currencyCódigo de la moneda de la operación.StringSI
operation.transactions[].payment_methodObjeto que contiene información sobre el método de pago usado en la transacción.ObjectSI
operation.transactions[].payment_method.method_nameNombre del método de pago usado en la transacción. Valor esperado: CUOTEALO.StringSI
operation.transactions[].payment_method.method_detailsObjeto que contiene información detallada relacionada al método.ObjectNO
operation.transactions[].continue_urlVisible en estado PENDIENTE. URL para continuar el proceso de pago.StringNO
operation.transactions[].expiration_dateVisible en estado PENDIENTE. Objeto que contiene la fecha en la que expirará la transacción.ObjectNO
operation.transactions[].processor_responseVisible normalmente en estado AUTORIZADO o DENEGADO. Objeto que contiene el resultado de la autorización.ObjectNO
operation.transactions[].additional_fieldsObjeto que contiene los datos adicionales de la transacción enviados en la autorización.ObjectNO
operation.transactions[].lifecycleArray que contiene el listado de estados por los cuales pasó la transacción.ArraySI

​
Objeto operation.transactions[].payment_method.method_details

CampoDescripciónTipoObligatorio
operation.transactions[].payment_method.method_details.redirect_urlVisible en estado PENDIENTE. URL del redirect enviado en la autorización.StringSI
operation.transactions[].payment_method.method_details.callback_urlURL del callback enviado en la autorización.StringNO

​
Objeto operation.transactions[].expiration_date

CampoDescripciónTipoObligatorio
operation.transactions[].expiration_date.utc_timeFecha en UTC.StringNO
operation.transactions[].expiration_date.unix_timeFecha en Unix time.IntegerNO

​
Objeto operation.transactions[].processor_response

CampoDescripciónTipoObligatorio
operation.transactions[].processor_response.credit_statusEstado de la autorización devuelta por la procesadora.StringNO
operation.transactions[].processor_response.operation_idID de la operación devuelta por la procesadora.StringNO

​
Objeto operation.transactions[].lifecycle

CampoDescripciónTipoObligatorio
operation.transactions[].lifecycle[].stateEstado de la transacción. Valores frecuentes: REGISTRADO, PENDIENTE, CANCELADO, INVALIDO, AUTORIZADO, DENEGADO, LIQUIDADO.StringSI
operation.transactions[].lifecycle[].dateObjeto que contiene la fecha en la que se realizó el cambio de estado.ObjectSI

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

CampoDescripciónTipoObligatorio
operation.transactions[].lifecycle[].date.utc_timeFecha en UTC.StringSI
operation.transactions[].lifecycle[].date.unix_timeFecha en Unix time.IntegerSI

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