Skip to main content
Usa esta consulta para verificar operaciones con PagoEfectivo cuyo resultado puede confirmarse fuera de la sesión inicial del checkout.
​
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 PagoEfectivo.

​
¿Cuándo usarla?

Pagos diferidos

Cuando el usuario completa el pago después de abandonar la sesión principal.

Confirmación backend

Cuando necesitas una fuente confiable del estado final antes de actualizar la orden.

CIP pendiente

Cuando necesitas recuperar el cip, la cip_url o la expiración mientras el pago sigue pendiente.

Conciliación

Cuando debes validar pagos confirmados por PagoEfectivo y conciliarlos con tu orden.

​
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 PagoEfectivo pueden variar según el estado de la operación. Tómalos como referenciales.

​
Response

Objeto operation.transactions[] para pagos con PagoEfectivo 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, INVALIDO, AUTORIZADO, DENEGADO, CANCELADO, EXPIRADO, 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: PAGOEFECTIVO.StringSI
operation.transactions[].payment_method.method_detailsObjeto que contiene información detallada relacionada al método.ObjectNO
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 PENDIENTE o AUTORIZADO. Objeto que contiene el resultado devuelto por la procesadora.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.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.cipVisible normalmente en estado PENDIENTE o AUTORIZADO. Código CIP de PagoEfectivo.StringNO
operation.transactions[].processor_response.cip_urlVisible normalmente en estado PENDIENTE. URL de PagoEfectivo con el detalle e indicaciones de pago.StringNO
operation.transactions[].processor_response.payment_dateVisible normalmente en estado AUTORIZADO. Fecha de pago reportada por PagoEfectivo.StringNO
operation.transactions[].processor_response.operationNumberVisible normalmente en estado AUTORIZADO. Identificador de PagoEfectivo.StringNO
operation.transactions[].processor_response.result_messageVisible normalmente en estado PENDIENTE. Objeto que contiene el mensaje del resultado de la autorización.ObjectNO

​
Objeto operation.transactions[].processor_response.result_message

CampoDescripciónTipoObligatorio
operation.transactions[].processor_response.result_message.codeCódigo del resultado de la autorización.StringNO
operation.transactions[].processor_response.result_message.descriptionDescripción del resultado de la autorización.StringNO

​
Objeto operation.transactions[].lifecycle

CampoDescripciónTipoObligatorio
operation.transactions[].lifecycle[].stateEstado de la transacción. Valores frecuentes: REGISTRADO, PENDIENTE, INVALIDO, AUTORIZADO, DENEGADO, CANCELADO, EXPIRADO, 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 PagoEfectivo con estado PENDIENTE. 
{
  "success": true,
  "merchant_code": "abc",
  "operation": {
    "merchant_operation_number": "7649167",
    "amount": "121900",
    "currency": "604",
    "state": "PENDIENTE",
    "transactions": [
      {
        "transaction_id": "a9e9040spd17ba3tdw42u4uv3",
        "state": "PENDIENTE",
        "state_reason": "Codigo CIP generado exitosamente",
        "amount": "121900",
        "currency": "604",
        "additional_fields": null,
        "payment_method": {
          "method_name": "PAGOEFECTIVO",
          "method_details": {
            "callback_url": "https://pay-me.com/callback"
          }
        },
        "expiration_date": {
          "utc_time": "2024-07-06T16:20:16.345140+00:00",
          "unix_time": 1720282816
        },
        "processor_response": {
          "cip": "1508405",
          "cip_url": "https://pre1a.payment.pagoefectivo.pe/72217FA5-4580-4B16-A345-24F028F53356.html",
          "result_message": {
            "code": "100",
            "description": "Solicitud exitosa."
          }
        },
        "lifecycle": [
          {
            "state": "REGISTRADO",
            "date": {
              "utc_time": "2024-07-05T16:20:16",
              "unix_time": 1720196416.222
            }
          },
          {
            "state": "PENDIENTE",
            "date": {
              "utc_time": "2024-07-05T16:20:16",
              "unix_time": 1720196416.305
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "status": {
      "code": "00",
      "message_ilgn": [
        {
          "locale": "es_PE",
          "value": "Se proceso correctamente la peticion"
        }
      ]
    }
  }
}

​
Ejemplo: autorizada

Response de consulta de PagoEfectivo con estado AUTORIZADO. 
{
  "success": true,
  "merchant_code": "abc",
  "operation": {
    "merchant_operation_number": "2836824",
    "amount": "1000",
    "currency": "604",
    "state": "AUTORIZADO",
    "transactions": [
      {
        "transaction_id": "9namjcnjvqzas2t33xyfrqr2h",
        "state": "AUTORIZADO",
        "state_reason": "Pago exitoso",
        "amount": "1000",
        "currency": "604",
        "additional_fields": null,
        "payment_method": {
          "method_name": "PAGOEFECTIVO",
          "method_details": {
            "callback_url": "https://pay-me.com/callback"
          }
        },
        "expiration_date": null,
        "processor_response": {
          "payment_date": "2024-06-24T11:01:20-05:00",
          "cip": "1493006",
          "operationNumber": "1057462"
        },
        "lifecycle": [
          {
            "state": "REGISTRADO",
            "date": {
              "utc_time": "2024-07-05T16:46:12",
              "unix_time": 1720197972.931
            }
          },
          {
            "state": "PENDIENTE",
            "date": {
              "utc_time": "2024-07-05T16:46:13",
              "unix_time": 1720197973.047
            }
          },
          {
            "state": "AUTORIZADO",
            "date": {
              "utc_time": "2024-07-05T16:47:22",
              "unix_time": 1720198042.642
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "status": {
      "code": "00",
      "message_ilgn": [
        {
          "locale": "es_PE",
          "value": "Se proceso correctamente la peticion"
        }
      ]
    }
  }
}

​
Siguiente paso

API de Cancelación

Revisa el flujo de cancelación si tu operación aún puede anularse.