---
title: "Consultar estado de una operación"
method: POST
path: "/switch/v1/consultar"
tags: ["Consultas"]
---

# Consultar estado de una operación

`POST /switch/v1/consultar`

## Request

- Base URL: `https://pay.pagaconquickpay.com`
- URL: `https://pay.pagaconquickpay.com/switch/v1/consultar`
- Auth: API key in header `x-switch-key`

Devuelve el estado actualizado (PENDIENTE/LIQUIDADA/RECHAZADA) de una operación previa.

## Request body

- ConsultarRequest
  - `id` string, required

## Response `200`

Estado actual

- Resultado
  - `id` string, required
  - `estado` 'ACEPTADA' | 'PENDIENTE' | 'LIQUIDADA' | 'RECHAZADA' | 'ERROR' | 'DESCONOCIDA' | 'ANULADA', required
  - `referencia_banco` string, nullable, required
  - `endtoend` string, nullable
  - `motivo_rechazo` 'SALDO_INSUFICIENTE' | 'OTP_INVALIDO' | 'CUENTA_NO_EXISTE' | 'CUENTA_BLOQUEADA' | 'CUENTA_NO_DEBITO' | 'CUENTA_NO_CREDITO' | 'MONTO_INVALIDO' | 'EXCEDE_LIMITE' | 'BENEFICIARIO_NO_COINCIDE' | 'NO_AFILIADO_SERVICIO' | 'BANCO_NO_DISPONIBLE' | 'DUPLICADA' | 'FUERA_DE_HORARIO' | 'CANCELADA_POR_PAGADOR' | 'PENDIENTE_BCV' | 'RECHAZO_TECNICO' | 'FIRMA_AUTH' | 'NO_SOPORTADO' | 'BLOQUEO_RIESGO' | 'NETO_NEGATIVO' | 'KYC_INSUFICIENTE' | 'COMERCIO_NO_ACTIVO' | 'SIN_CUENTA_LIQUIDACION' | 'ANULACION_RECHAZADA' | 'SIN_DEBITO_EN_EXTRACTO' | 'DESCONOCIDO', nullable
  - `intentos` integer
  - `simulado` boolean

## Other responses

- `401`: No autorizado
- `404`: No encontrada (o de otro modo que la llave)

---

[API](https://skmtc.dev/pagaconquickpay/apis/quickpay-api.md) · [All operations](https://skmtc.dev/pagaconquickpay/apis/quickpay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pagaconquickpay/apis/quickpay-api/revisions/999597fa67f3?raw)
