Api de Consulta con QR

Usa esta consulta para confirmar el estado final de un pago QR luego del redirect del usuario o cuando la operación permanece pendiente.

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

¿Cuándo usarla?

Después del redirect

Para contrastar el retorno del navegador con el estado real de backend.

Confirmación final

Para obtener el estado definitivo antes de actualizar la orden en tu sistema.

QR pendiente

Para recuperar el qr_image, qr_id y la fecha de expiración mientras el pago sigue pendiente.

Seguimiento operativo

Para validar si la operación pasó de PENDIENTE a AUTORIZADO, EXPIRADO o CANCELADO.

Consideraciones

No marques la operación como exitosa solo por el retorno del usuario. Usa la consulta o la notificación S2S como validación final.

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.

En estado PENDIENTE, el objeto processor_response suele devolver el QR generado. Cuando la operación queda AUTORIZADO, ese mismo objeto puede devolver datos de autorización.

Response

Objeto operation.transactions[] para pagos con QR 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`, `AUTORIZADO`, `INVALIDO`, `EXPIRADO`, `CANCELADO`, `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: `QR`.	String	SI
`operation.transactions[].payment_method.method_details`	Objeto que contiene información detallada relacionada al método.	Object	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`	Objeto que contiene el resultado devuelto por la procesadora. Su contenido varía según el estado de la transacción.	Object	NO
`operation.transactions[].additional_fields`	Objeto que contiene los datos adicionales de la transacción enviados en el request.	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.masked_pan`	Tarjeta enmascarada usada en la transacción.	String	NO
`operation.transactions[].payment_method.method_details.brand`	Marca de la tarjeta usada en la transacción.	String	NO
`operation.transactions[].payment_method.method_details.bin`	BIN de la tarjeta usada en la transacción.	String	NO
`operation.transactions[].payment_method.method_details.last_pan`	Últimos 4 dígitos de la tarjeta usada en la transacción.	String	NO
`operation.transactions[].payment_method.method_details.card_type`	Tipo de tarjeta.	String	NO
`operation.transactions[].payment_method.method_details.card_country`	País de la tarjeta.	String	NO
`operation.transactions[].payment_method.method_details.issuer`	Banco emisor de la tarjeta.	String	NO
`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.date`	Visible normalmente en estado `PENDIENTE`. Fecha devuelta por la procesadora al generar el QR.	String	NO
`operation.transactions[].processor_response.qr_image`	Visible normalmente en estado `PENDIENTE`. Imagen en base64 del QR generado.	String	NO
`operation.transactions[].processor_response.qr_id`	Visible normalmente en estado `PENDIENTE`. ID del QR generado por la procesadora.	String	NO
`operation.transactions[].processor_response.authorization_code`	Visible normalmente en estado `AUTORIZADO` o `DENEGADO`. Código de autorización.	String	NO
`operation.transactions[].processor_response.brand_transaction_id`	Visible normalmente en estado `AUTORIZADO` o `DENEGADO`. ID de la transacción ante la marca.	String	NO
`operation.transactions[].processor_response.result_message`	Objeto que contiene el mensaje del resultado devuelto por la procesadora.	Object	NO

Objeto `operation.transactions[].processor_response.result_message`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].processor_response.result_message.code`	Código del resultado de la autorización o generación del QR.	String	NO
`operation.transactions[].processor_response.result_message.description`	Descripción del resultado de la autorización o generación del QR.	String	NO

Objeto `operation.transactions[].lifecycle`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].lifecycle[].state`	Estado de la transacción. Valores frecuentes: `REGISTRADO`, `PENDIENTE`, `AUTORIZADO`, `EXTORNADO`, `CANCELADO`, `EXPIRADO`, `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 QR en 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": "QR generado, pendiente de pago",
        "amount": "15000",
        "currency": "604",
        "payment_method": {
          "method_name": "QR",
          "method_details": {
            "callback_url": "https://pay-me.com/callback"
          }
        },
        "expiration_date": {
          "utc_time": "2024-03-12T22:49:36.018Z",
          "unix_time": 1710282940
        },
        "processor_response": {
          "date": "2024-03-21 14:53:15.096596",
          "qr_image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAV4AAAFeAQAAAADlUEq3AAAFa0lEQVR42u1bS47iQAx1i0WWOUJu0lwsUpC4GNwkR8iSRRTP+1SlmZZGmsVsrGkWEVAvSLFd9vMrE/n3rz1+wP8XeIuIj22eXrjw3WXNx4ilJxc+x3visuNtLFXBCxcu6/AYb5PeYTXX1yfWM3lv4qdwKQueY3jyQo9GjLcYHgHjROi2+0ozTTBTaXDeE98tK25b1tc1c4VdZhonJnh/rw/G6iOWHA4swBAxwTj7hI+ZQ363RjGw4nmmkxeaJLB1gcMNiuI58omPvwV/MXDLSAzqP16+p69KYL2cXhnFeaP38T0SVOQRS8vAbwWoGnhnRsK+TAU1iggcH1Nct4u8H06+D1ujIHjj5mRQ46FXbdg8mHf19NjJvFeFpS44TAiC7k4kX9xxX2ENZlu6WxkJq0XBCGAUESRaVhJc7isMoUsPdoTAOtgaFcEslfwYjN1UEQErQBSzulwRB7gwIdt0FcEtnv2d7mVG4mr6giw1YdcuVcGXZMHAXg2y17ikCEGgcgatQbogWptFwanscyPFuSHRIpRT7g6EgDMSWN/K24qC2VyYmcMufOiV9HzSNiXD43bWT2VdMK0BVkAi18gdWg92HYpnOP7G/VsVjEfF49/JfRZ3wn78dDyzWSZRf2ZZMBr8K7MtG2PiwlWSe1VcT/EczkgVwWQFMapA7uRwZABMUAxvGsK8rjCYGYkEHB2VSsfFPmclceVEPCM3HWXBfujZ9UPkTt0xVqPF88Ef+MisCw4SAvhcLI4yVdc3yAUUz9l5XU2wuAAd2toM8vGIsTVd4kOdxlcEzy29Bn3+QYYn4Y3No0XU1pOUBbP15Xfcl/KvpGIRdUkbv8VzRfDMbEsOdyrgYuvHqAy8kNzds2ekiuALY5cUB+721v1gIeWL8ew6MzR3VwTPzqxUFlldurJ4UMX5dCfCmjJWBUvdpwblIqJ+X0Rui7O3iui8riKYvVVXUiXgZOuOd5M76+NZFszW4ykNqlM6CVYK7+FhavAe/PXA6hvxUX2jSCp1fu3axuvck5QFkwGAC7BomueI1+k2HU9JKu6soCKYC+j3KWjw8cXHWUTIBY7O6+LaJeV64DmkQX1pGXzyfKnp7+2IqmlV8GXVR0Zsul623kov8br9bXeXA/vgcJH4nS4iJHKv1mWZ9qyN11UEyxqjVA0eB7NenjJVsIbyjuwnNRXBoW6xpderm2XmWO1VnQ5LSO4ZqR5YIwqMYiZaeJUZ2EUkrVA93oK/ItiMx7xOIxmK7FTH7ON+qgHHWBZ80Tu/WD5bI/y0IsfIpth/9lb1wCqLt0kQ9sT2OexijVHTGGf7XxBM11KXaqM09G9rlqUS0ySaXRjLgm8iqRqGSsZzOkGJvbaxBfu8MFhEjvvSp6UPj0XdJpdPDYT1w/F6YM2vpQb0XDrUaoWsoXNTzSf2s7aCYDLVzybguI86jzTCg22sKXmarhzY8zS7BI3J07OHVyUQq8HSYU6WBa9vHZXC24eJm+YyxAru2sl1wUM7tIg2paeackpXGrT5av/LgVXy1Qlb3fcdk5pHkTvZhRy9KnhXExyaSkSObZPQ0obVar081d7H/MqB1S2yUVSrH4psaTfMtoemEsnRr1tVMDfn07POEjR8WhqidB7OuLbR06pgHc3wsMmu5VFUNjancRNRoeF91LYWeGuqaWuRo009c8J00gnqt0HNemAx1bueV+eIqck9DZeqpljnf36Nu1cDt3+RiBAMbR74PGGjrRjPJwmsCxZEwd1l4aY7Dt1WpcFScaQIh4/20yLqJo1xP+O5IljxvE+np6ksalboVKikpL4FfzFwnJlVNtDsQk/FnjnxIF8WBf/8XfQH/A/AvwD2DA1dmGNskwAAAABJRU5ErkJggg==",
          "qr_id": "e5e36834a2294d83868d587af8ae8e13",
          "result_message": {
            "code": "0",
            "description": "Exito"
          }
        },
        "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: autorizado

Response de consulta de QR en 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": "Approval and completed successfully",
        "amount": "15000",
        "currency": "604",
        "payment_method": {
          "method_name": "QR",
          "method_details": {
            "masked_pan": "455788******9268",
            "brand": "VISA",
            "bin": "455788",
            "last_pan": "9268",
            "card_type": "DEBIT",
            "card_country": "PE",
            "issuer": "BANCO DE CREDITO DEL PERU - BCP",
            "callback_url": "https://pay-me.com/callback"
          }
        },
        "expiration_date": null,
        "processor_response": {
          "authorization_code": "055552",
          "result_message": {
            "code": "00",
            "description": "Approval and completed successfully"
          },
          "brand_transaction_id": "A055552"
        },
        "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

Revisa la cancelación para operaciones que todavía puedan anularse.

Primeros pasos

Integración

Pagos

Gestión y Operaciones

¿Cuándo usarla?

Después del redirect

Confirmación final

QR pendiente

Seguimiento operativo

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[].processor_response.result_message`

Objeto `operation.transactions[].lifecycle`

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

Ejemplo: pendiente

Ejemplo: autorizado

Siguiente paso

API de Cancelación

​¿Cuándo usarla?

Después del redirect

Confirmación final

QR pendiente

Seguimiento operativo

​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[].processor_response.result_message

​Objeto operation.transactions[].lifecycle

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

​Ejemplo: pendiente

​Ejemplo: autorizado

​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[].processor_response.result_message`

Objeto `operation.transactions[].lifecycle`

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

Ejemplo: pendiente

Ejemplo: autorizado

Siguiente paso